Kotlin HTTP 客户端：正确发送请求

Kotlin HTTP 客户端入门

现代 Kotlin 开发离不开与远程 API 和 Web 服务的交互。HTTP 客户端是一个基础工具，它能让您的应用程序发送请求并从互联网接收响应。无论您是在开发移动应用、服务器后端还是桌面应用，掌握正确处理 HTTP 请求的能力是每位 Kotlin 开发者的必备技能。

在本文中，我们将详细解析 Kotlin 生态系统中可用的 HTTP 库、如何执行 GET 和 POST 请求、处理 JSON 以及管理异步操作。您将学习如何避免常见错误，使您的代码更加可靠和高效。

Kotlin 中主要的 HTTP 客户端库

1. Ktor Client

Ktor 是一个由 JetBrains 专为 Kotlin 打造的现代异步框架。Ktor Client 支持协程、跨平台（JVM、Android、iOS、JS、Native），并提供灵活可配置的引擎。

使用 Ktor 执行基本 GET 请求的示例：

import io.ktor.client.*import io.ktor.client.request.*import io.ktor.client.statement.*

suspend fun fetchData(): String {    val client = HttpClient()    val response: HttpResponse = client.get("https://api.example.com/data")    client.close()    return response.bodyAsText()}

2. OkHttp

OkHttp 是 Java 和 Android 中最流行的库之一，与 Kotlin 配合使用效果极佳。它以高性能、支持 HTTP/2、自动连接池和拦截器（interceptors）而著称。

使用 OkHttp 执行同步 GET 请求的示例：

import okhttp3.OkHttpClientimport okhttp3.Request

fun fetchData(): String {    val client = OkHttpClient()    val request = Request.Builder()        .url("https://api.example.com/data")        .build()        client.newCall(request).execute().use { response ->        return response.body?.string() ?: ""    }}

3. Fuel

Fuel 是一个轻量级且直观的 Kotlin 库，基于 OkHttp 构建。它提供了函数式的请求处理方式和便捷的结果处理。

使用 Fuel 执行 GET 请求的示例：

import com.github.kittinunf.fuel.httpGetimport com.github.kittinunf.result.Result

fun fetchData() {    "https://api.example.com/data"        .httpGet()        .responseString { _, _, result ->            when (result) {                is Result.Success -> println(result.value)                is Result.Failure -> println(result.error)            }        }}

如何正确发送 GET 和 POST 请求

GET 请求

GET 请求用于从服务器获取数据。请求参数通常通过 URL 传递。使用 Ktor 时，可以通过 parameter 块添加参数：

val client = HttpClient()val response = client.get("https://api.example.com/search") {    parameter("query", "Kotlin")    parameter("page", 1)}

重要提示：GET 请求不应改变服务器状态，也不应包含请求体。所有数据通过 URL 或标头传递。

POST 请求

POST 请求用于向服务器发送数据（例如，创建新资源）。请求体可以是 JSON、Form URL Encoded 或 Multipart 格式。

使用 Ktor 发送带 JSON 体的 POST 请求示例：

import io.ktor.client.request.*import io.ktor.http.*

data class User(val name: String, val email: String)

suspend fun createUser(user: User): String {    val client = HttpClient()    val response = client.post("https://api.example.com/users") {        contentTyp