Android网络（三）使用OkHttp

引言

Android 开发中，网络通信的复杂性和性能要求越来越高。虽然 HttpURLConnection 可以满足一些简单的需求，但面对复杂的网络操作时，我们需要一个更强大、更灵活的工具。这时候，OkHttp 应运而生。作为一个广泛应用的开源 HTTP 客户端，OkHttp 不仅在性能上表现优异，还提供了丰富的功能，使得网络请求的编写更加简单和高效。

基本用法

在使用OkHttp之前，我们需要先添加OkHttp依赖，

dependencies {
    // 其他依赖...

    // OkHttp 核心库
    implementation 'com.squareup.okhttp3:okhttp:4.11.0'

    // 如果需要使用 OkHttp 的日志拦截器，可以添加以下依赖
    implementation 'com.squareup.okhttp3:logging-interceptor:4.11.0'
}

OkHttp的基本用法和应用场景大致相同，这里做一下简单的对比

使用 HttpURLConnection 发送 GET 请求

val url = URL("https://jsonplaceholder.typicode.com/posts")
val connection = url.openConnection() as HttpURLConnection

try {
    connection.requestMethod = "GET"
    connection.connectTimeout = 10000
    connection.readTimeout = 15000

    val responseCode = connection.responseCode
    if (responseCode == HttpURLConnection.HTTP_OK) {
        val inputStream = connection.inputStream
        val response = inputStream.bufferedReader().use { it.readText() }
        println("Response: $response")
    } else {
        println("Request failed with response code: $responseCode")
    }
} catch (e: Exception) {
    println("Error: ${e.message}")
} finally {
    connection.disconnect()
}

使用 OkHttp 发送 GET 请求

val client = OkHttpClient()

val request = Request.Builder()
    .url("https://jsonplaceholder.typicode.com/posts")
    .build()

client.newCall(request).enqueue(object : Callback {
    override fun onFailure(call: Call, e: IOException) {
        println("Request Failed: ${e.message}")
    }

    override fun onResponse(call: Call, response: Response) {
        if (response.isSuccessful) {
            println("Response: ${response.body?.string()}")
        } else {
            println("Request failed with response code: ${response.code}")
        }
    }
})

通过对比它们的 GET 请求实现，可以看出这两者在使用上的一些区别。

HttpURLConnection 是 Android 平台上原生的 HTTP 客户端，使用它时，开发者需要手动管理连接、超时设置、数据读取等操作。它虽然简洁且没有额外的依赖，但在实际开发中，代码反而较为冗长。想要发起一个 GET 请求，你需要先创建 HttpURLConnection 对象，设置请求方法，处理连接和流的关闭，最终才能获取响应。这种方式虽然直接，却缺乏灵活性，尤其在面对复杂的网络需求时，开发者需要编写大量重复的样板代码。

相比之下，OkHttp 提供了更高层次的封装，让网络请求变得更为简洁和易用。使用 OkHttp 发起 GET 请求时，你只需创建一个 OkHttpClient 实例，并通过链式调用来构建请求和处理响应。OkHttp 内建了自动处理连接池、压缩、重定向等功能，避免了开发者手动管理这些细节，从而减少了代码量，提高了可维护性。同时，OkHttp 提供了丰富的扩展功能，如拦截器、异步请求等，能够更好地满足现代应用的复杂网络需求。

扩展

缓存机制

 实际的开发需求往往更加复杂，OkHttp 的强大之处在于它不仅能处理简单的 GET 和 POST 请求，还提供了一些高级功能来应对复杂的开发需求。在涉及流媒体的应用里通常由缓存机制的需求，OkHttp可以轻松实现这一点

val cacheDir = File(context.cacheDir, "http_cache")
val cacheSize = 10 * 1024 * 1024 // 10 MiB
val cache = Cache(cacheDir, cacheSize)

val client = OkHttpClient.Builder()
    .cache(cache)
    .build()

 为 OkHttpClient 设置了一个缓存目录和大小。所有的请求响应都会根据 HTTP 头信息自动进行缓存和读取。

并发请求管理

对于并发请求的处理，OkHttp 提供了连接池和队列机制

val client = OkHttpClient.Builder()
    .connectionPool(ConnectionPool(5, 5, TimeUnit.MINUTES))
    .build()

 这里通过自定义 ConnectionPool，我们可以控制最大连接数和连接保活时间，从而在高并发场景下有效管理资源。

自定义超时设置

不同的网络条件下，可能需要调整连接超时和读取超时来保证请求的成功率。OkHttp 提供了简单的接口来实现这些调整：

val client = OkHttpClient.Builder()
    .connectTimeout(10, TimeUnit.SECONDS)
    .readTimeout(30, TimeUnit.SECONDS)
    .build()

总结

可以看出，OkHttp相比HttpURLConnection在功能和性能上有了显著的提升。它不仅提供了更强大的缓存和并发管理功能，还允许开发者灵活调整网络请求的各项参数，满足现代应用的复杂需求。

但当我们需要高度自定义的 API 请求，或是需要与其他网络协议进行集成时，OkHttp也无法满足需求了。在专栏的下一篇文章中，我们将深入探讨更为专业的网络库 Retrofit，它建立在 OkHttp 之上，并提供了更加简洁且易于扩展的 API，适用于复杂的 RESTful 服务集成。