Android OkHttp 全面解析：从原理到实践

安卓开发者

于 2025-06-19 21:33:32 发布

阅读量701

点赞数 28

CC 4.0 BY-SA版权

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

本文链接：https://blog.csdn.net/feathersong/article/details/148775812

OkHttp 专栏收录该内容

12 篇文章

订阅专栏

一、OkHttp 简介

OkHttp 是 Square 公司开发的一个高效的 HTTP 客户端，它具有以下特点：

支持 HTTP/2，允许对同一主机的所有请求共享一个套接字
连接池减少了请求延迟（如果 HTTP/2 不可用）
透明的 GZIP 压缩减少了下载大小
响应缓存完全避免了重复请求的网络传输

二、OkHttp 工作流程图

三、OkHttp 核心组件

1. OkHttpClient

OkHttpClient 是 OkHttp 的核心类，负责协调各个组件的工作。通常建议将其设计为单例模式。

OkHttpClient client = new OkHttpClient.Builder()
    .connectTimeout(10, TimeUnit.SECONDS)
    .writeTimeout(10, TimeUnit.SECONDS)
    .readTimeout(30, TimeUnit.SECONDS)
    .cache(new Cache(cacheDirectory, cacheSize))
    .build();

2. Request 和 Response

Request：封装了 HTTP 请求的所有信息（URL、方法、头、体等）
Response：封装了 HTTP 响应的所有信息（状态码、头、体等）

3. Call

Call 代表一个已准备好执行的请求，它提供了同步和异步两种执行方式。

四、OkHttp 工作流程详解

1. 同步请求流程

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

try (Response response = client.newCall(request).execute()) {
    if (!response.isSuccessful()) throw new IOException("Unexpected code " + response);
    
    // 处理响应
    String responseData = response.body().string();
    System.out.println(responseData);
}

2. 异步请求流程

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

client.newCall(request).enqueue(new Callback() {
    @Override
    public void onFailure(Call call, IOException e) {
        e.printStackTrace();
    }

    @Override
    public void onResponse(Call call, Response response) throws IOException {
        if (!response.isSuccessful()) throw new IOException("Unexpected code " + response);
        
        // 处理响应
        String responseData = response.body().string();
        System.out.println(responseData);
    }
});

五、OkHttp 拦截器机制

OkHttp 的强大之处在于其拦截器机制，它允许我们在请求和响应的处理过程中插入自定义逻辑。

1. 内置拦截器

RetryAndFollowUpInterceptor：负责重试和重定向
BridgeInterceptor：桥接应用代码和网络代码
CacheInterceptor：处理缓存
ConnectInterceptor：建立到目标服务器的连接
CallServerInterceptor：向服务器发送请求并读取响应

2. 自定义拦截器示例

class LoggingInterceptor implements Interceptor {
    @Override
    public Response intercept(Chain chain) throws IOException {
        Request request = chain.request();
        
        long t1 = System.nanoTime();
        System.out.println(String.format("Sending request %s on %s%n%s",
            request.url(), chain.connection(), request.headers()));
        
        Response response = chain.proceed(request);
        
        long t2 = System.nanoTime();
        System.out.println(String.format("Received response for %s in %.1fms%n%s",
            response.request().url(), (t2 - t1) / 1e6d, response.headers()));
        
        return response;
    }
}

// 使用自定义拦截器
OkHttpClient client = new OkHttpClient.Builder()
    .addInterceptor(new LoggingInterceptor())
    .build();

六、OkHttp 高级特性

1. 连接池管理

OkHttp 自动管理连接池，复用 TCP 连接以减少延迟。

2. 缓存控制

int cacheSize = 10 * 1024 * 1024; // 10 MiB
Cache cache = new Cache(getCacheDir(), cacheSize);

OkHttpClient client = new OkHttpClient.Builder()
    .cache(cache)
    .build();

3. Cookie 管理

CookieJar cookieJar = new CookieJar() {
    private final HashMap<HttpUrl, List<Cookie>> cookieStore = new HashMap<>();

    @Override
    public void saveFromResponse(HttpUrl url, List<Cookie> cookies) {
        cookieStore.put(url, cookies);
    }

    @Override
    public List<Cookie> loadForRequest(HttpUrl url) {
        List<Cookie> cookies = cookieStore.get(url);
        return cookies != null ? cookies : new ArrayList<Cookie>();
    }
};

OkHttpClient client = new OkHttpClient.Builder()
    .cookieJar(cookieJar)
    .build();