Android OkHttp的基本用法及原理

最新推荐文章于 2025-05-28 21:28:31 发布

Hibon·zheng

最新推荐文章于 2025-05-28 21:28:31 发布

阅读量716

点赞数 10

分类专栏： Android 文章标签： android okhttp

本文链接：https://blog.youkuaiyun.com/Gabo_Summer/article/details/144015187

版权

Android 专栏收录该内容

15 篇文章

订阅专栏

OkHttp 是一个高效的 HTTP 客户端，广泛用于 Android 和 Java 应用程序。它提供了简单易用的 API，并且支持多种功能，如连接池、请求缓存、Gzip 压缩等。下面将详细讲解 OkHttp 的使用方法及其底层逻辑与原理。

一、OkHttp 的基本使用

1. 添加依赖

在你的 build.gradle 文件中添加 OkHttp 的依赖：

dependencies {
    implementation 'com.squareup.okhttp3:okhttp:4.9.2'
}

2. 创建 OkHttpClient 实例

OkHttpClient 是 OkHttp 的核心类，用于发送请求和接收响应。通常，你只需创建一个实例并重用它：

OkHttpClient client = new OkHttpClient();

3. 构建请求

使用 Request 类来构建一个 HTTP 请求，可以设置 URL、请求方式、请求头等：

Request request = new Request.Builder()
        .url("https://api.example.com/data")
        .build();

4. 发送请求

使用 OkHttpClient 的 newCall() 方法发送请求，返回一个 Call 对象，然后可以同步或异步执行：

异步请求：

client.newCall(request).enqueue(new Callback() {
    @Override
    public void onFailure(Call call, IOException e) {
        // 请求失败处理
    }

    @Override
    public void onResponse(Call call, Response response) throws IOException {
        if (response.isSuccessful()) {
            // 处理响应数据
            String responseData = response.body().string();
        }
    }
});

同步请求：

try {
    Response response = client.newCall(request).execute();
    if (response.isSuccessful()) {
        // 处理响应数据
        String responseData = response.body().string();
    }
} catch (IOException e) {
    // 请求失败处理
}

二、OkHttp 底层逻辑与原理

1. 连接管理

OkHttp 使用连接池（Connection Pool）来复用已建立的连接，减少延迟和资源消耗。默认情况下，OkHttp 会保持连接活跃一段时间以便后续请求复用。

2. 请求缓存

OkHttp 支持 HTTP 缓存，可以根据响应的缓存控制头部来决定是否使用缓存，从而提高应用性能，具体逻辑后续继续整理。你可以通过 Cache 类来配置缓存目录和大小。

File cacheDir = new File(context.getCacheDir(), "http-cache");
Cache cache = new Cache(cacheDir, 10 * 1024 * 1024); // 10 MB
OkHttpClient client = new OkHttpClient.Builder()
        .cache(cache)
        .build();

3. 拦截器

OkHttp 提供了拦截器（Interceptor）机制，可以在请求发送前和响应到达后进行处理。常见的用途包括日志记录、添加公共请求头、重试机制等。

Interceptor loggingInterceptor = new Interceptor() {
    @Override
    public Response intercept(Chain chain) throws IOException {
        Request request = chain.request();
        Response response = chain.proceed(request);
        // 记录日志
        return response;
    }
};

OkHttpClient client = new OkHttpClient.Builder()
        .addInterceptor(loggingInterceptor)
        .build();