Kotlin HTTP客户端：从A到Z正确发起请求

Kotlin中的HTTP客户端：从头正确发起请求

在Kotlin的现代开发中，网络交互不可或缺。无论是Android应用、基于Ktor的服务器端解决方案，还是桌面应用程序——HTTP请求始终是数据交换的主要方式。本文将详细解析如何在Kotlin中正确组织HTTP客户端，介绍主流库和最佳实践。

为什么Kotlin是HTTP请求的理想选择？

Kotlin拥有现代语法、空安全特性，并与Java生态系统完全兼容。借助协程和流式API，网络操作变得简洁且异步。主要优势包括：

• 协程 —— 无需阻塞即可进行异步操作的轻量级线程
• 类型安全构建器 —— 便捷的HTTP请求构建方式
• 密封类 —— 优雅处理响应状态
• 扩展函数 —— 扩展库功能

为Kotlin选择HTTP客户端

目前，Kotlin生态系统中有三个主流库：OkHttp、Ktor Client和Retrofit。我们通过代码示例逐一介绍。

1. OkHttp —— 久经考验的选择

Square公司开发的OkHttp是JVM平台上最流行的HTTP客户端。它性能高效，支持HTTP/2、自动压缩和缓存。

// build.gradle.ktsimplementation("com.squareup.okhttp3:okhttp:4.12.0")

// 使用OkHttp的GET请求示例import okhttp3.OkHttpClientimport okhttp3.Requestimport kotlinx.coroutines.Dispatchersimport kotlinx.coroutines.withContext

class OkHttpExample {    private val client = OkHttpClient.Builder()        .connectTimeout(30, java.util.concurrent.TimeUnit.SECONDS)        .readTimeout(30, java.util.concurrent.TimeUnit.SECONDS)        .build()

    suspend fun fetchData(url: String): String = withContext(Dispatchers.IO) {        val request = Request.Builder()            .url(url)            .header("Accept", "application/json")            .build()

        client.newCall(request).execute().use { response ->            if (!response.isSuccessful) {                throw RuntimeException("错误: ${response.code}")            }            response.body?.string() ?: throw RuntimeException("响应为空")        }    }}

2. Ktor Client —— Kotlin原生选择

Ktor Client是JetBrains生态系统的一部分，完全用Kotlin编写并支持多平台。非常适合Ktor服务器和Android/iOS项目。

// build.gradle.ktsimplementation("io.ktor:ktor-client-core:2.3.7")implementation("io.ktor:ktor-client-cio:2.3.7")implementation("io.ktor:ktor-client-content-negotiation:2.3.7")implementation("io.ktor:ktor-serialization-kotlinx-json:2.3.7")

import io.ktor.client.*import io.ktor.client.call.*import io.ktor.client.engine.cio.*import io.ktor.client.plugins.contentnegotiation.*import io.ktor.client.request.*import io.ktor.client.statement.*import io.ktor.serialization.kotlinx.json.*import kotlinx.serialization.Serializable

@Serializabledata class Post(val userId: Int, val id: Int, val title: String, val body: String)

class KtorExample {    private val client = HttpClient(CIO) {        install(ContentNegotiation) {            json(Json {                ignoreUnknownKeys = true                isLenient = true            })        }        engine {            requestTimeout = 30_000        }    }

    suspend fun getPost(id: Int): Post {        val response: HttpResponse = client.get("https://jsonplaceholder.typicode.com/posts/$id")        return response.body()    }

    suspend fun createPost(post: Post): Post {        val response: HttpResponse = client.post("https://jsonplaceholder.typicode.com/posts") {            setBody(post)