编辑“︁Kotlin HTTP客户端”︁

= Kotlin HTTP客户端 =

'''Kotlin HTTP客户端'''是Kotlin中用于发送HTTP请求和接收HTTP响应的工具或库。它允许开发者与Web服务进行交互，例如获取数据、提交表单或调用REST API。Kotlin提供了多种方式来实现HTTP客户端，包括使用标准库（如`java.net.HttpURLConnection`）或第三方库（如Ktor Client、OkHttp和Fuel）。

== 简介 ==
HTTP客户端是网络编程的核心组件，用于在客户端和服务器之间传输数据。在Kotlin中，可以通过原生Java库或更现代的Kotlin专属库来实现HTTP请求。以下是一些常见的Kotlin HTTP客户端选项：
* '''HttpURLConnection'''：Java标准库的一部分，简单但功能有限。
* '''Ktor Client'''：JetBrains开发的异步HTTP客户端，支持协程。
* '''OkHttp'''：Square开发的强大HTTP客户端，支持同步和异步请求。
* '''Fuel'''：轻量级Kotlin HTTP客户端库，语法简洁。

== 基本用法 ==
以下示例展示了如何使用不同的HTTP客户端发送GET和POST请求。

=== 使用HttpURLConnection ===
{{syntaxhighlight|lang=kotlin|code=
import java.net.HttpURLConnection
import java.net.URL

fun main() {
    val url = URL("https://jsonplaceholder.typicode.com/posts/1")
    val connection = url.openConnection() as HttpURLConnection
    connection.requestMethod = "GET"

    val responseCode = connection.responseCode
    if (responseCode == HttpURLConnection.HTTP_OK) {
        val response = connection.inputStream.bufferedReader().use { it.readText() }
        println("Response: $response")
    } else {
        println("Request failed with status code: $responseCode")
    }
}
}}

'''输出示例：'''
<pre>
Response: {
  "userId": 1,
  "id": 1,
  "title": "sunt aut facere repellat provident occaecati excepturi optio reprehenderit",
  "body": "quia et suscipit..."
}
</pre>

=== 使用Ktor Client ===
Ktor是一个支持协程的异步HTTP客户端。首先，需要在`build.gradle.kts`中添加依赖：
{{syntaxhighlight|lang=kotlin|code=
dependencies {
    implementation("io.ktor:ktor-client-core:2.3.3")
    implementation("io.ktor:ktor-client-cio:2.3.3")
}
}}

然后发送请求：
{{syntaxhighlight|lang=kotlin|code=
import io.ktor.client.*
import io.ktor.client.engine.cio.*
import io.ktor.client.request.*
import kotlinx.coroutines.runBlocking

fun main() = runBlocking {
    val client = HttpClient(CIO)
    val response: String = client.get("https://jsonplaceholder.typicode.com/posts/1")
    println("Response: $response")
    client.close()
}
}}

=== 使用OkHttp ===
OkHttp是一个高效的HTTP客户端。添加依赖：
{{syntaxhighlight|lang=kotlin|code=
dependencies {
    implementation("com.squareup.okhttp3:okhttp:4.10.0")
}
}}

发送请求：
{{syntaxhighlight|lang=kotlin|code=
import okhttp3.OkHttpClient
import okhttp3.Request

fun main() {
    val client = OkHttpClient()
    val request = Request.Builder()
        .url("https://jsonplaceholder.typicode.com/posts/1")
        .build()

    val response = client.newCall(request).execute()
    println("Response: ${response.body?.string()}")
}
}}

== 高级功能 ==
现代HTTP客户端通常支持以下高级功能：
* '''异步请求'''：使用协程或回调避免阻塞主线程。
* '''JSON解析'''：与序列化库（如`kotlinx.serialization`或Gson）集成。
* '''拦截器'''：修改请求或响应（如添加认证头）。
* '''超时和重试'''：提高网络请求的可靠性。

=== 使用Ktor Client发送JSON数据 ===
{{syntaxhighlight|lang=kotlin|code=
import io.ktor.client.*
import io.ktor.client.engine.cio.*
import io.ktor.client.request.*
import io.ktor.http.*
import kotlinx.coroutines.runBlocking

data class Post(val userId: Int, val title: String, val body: String)

fun main() = runBlocking {
    val client = HttpClient(CIO)
    val response = client.post("https://jsonplaceholder.typicode.com/posts") {
        contentType(ContentType.Application.Json)
        setBody(Post(1, "Hello", "This is a test post"))
    }
    println("Response: ${response.bodyAsText()}")
    client.close()
}
}}

== 实际应用案例 ==
以下是一个真实场景：从天气API获取数据并解析为Kotlin对象。

{{syntaxhighlight|lang=kotlin|code=
import io.ktor.client.*
import io.ktor.client.engine.cio.*
import io.ktor.client.request.*
import kotlinx.serialization.Serializable
import kotlinx.coroutines.runBlocking

@Serializable
data class WeatherResponse(val main: Main, val name: String)

@Serializable
data class Main(val temp: Double, val humidity: Int)

fun main() = runBlocking {
    val client = HttpClient(CIO)
    val response: WeatherResponse = client.get("https://api.openweathermap.org/data/2.5/weather?q=London&appid=YOUR_API_KEY")
    println("Temperature in ${response.name}: ${response.main.temp}°C")
    client.close()
}
}}

== 性能比较 ==
以下是常见HTTP客户端的性能对比（以请求延迟为例）：
<mermaid>
barChart
    title HTTP客户端请求延迟比较（ms）
    x-axis 客户端
    y-axis 延迟
    series "平均延迟"
    Ktor: 120
    OkHttp: 150
    HttpURLConnection: 200
</mermaid>

== 总结 ==
Kotlin HTTP客户端提供了多种选择，从简单的`HttpURLConnection`到功能强大的Ktor和OkHttp。选择取决于项目需求：
* 简单项目：`HttpURLConnection`或Fuel。
* 高性能需求：OkHttp。
* 异步和协程支持：Ktor Client。

通过合理选择HTTP客户端，可以高效地实现网络通信功能。

[[Category:编程语言]]
[[Category:Kotlin]]
[[Category:Kotlin网络编程]]