Retrofit 中的请求头和拦截器

## 章节一：Retrofit简介与基本用法回顾

Retrofit是一个广泛用于Android开发的HTTP客户端库，它通过注解方式简化了HTTP请求的封装和调用过程，让开发者能够更加便捷地进行网络请求操作。接下来，我们将回顾Retrofit的基本用法，并重点介绍其中请求头的概念与作用。

### 1.1 Retrofit是什么？

Retrofit是由Square公司开发的一款基于OkHttp的Android网络库，它使用简洁的注解方式描述HTTP请求和响应，使得网络请求变得十分便捷。

### 1.2 Retrofit的基本用法回顾

在Retrofit中，我们首先需要定义一个接口，通过在接口方法上添加注解的方式描述HTTP请求的参数、URL、请求方式等信息；然后使用Retrofit.Builder构建一个Retrofit对象，再利用这个对象创建出接口的实现。下面是一个简单的示例：

public interface ApiService {
    @GET("user")
    Call<User> getUserInfo(@Query("userId") int userId);
}

Retrofit retrofit = new Retrofit.Builder()
        .baseUrl("https://api.example.com/")
        .addConverterFactory(GsonConverterFactory.create())
        .build();

ApiService apiService = retrofit.create(ApiService.class);

### 1.3 Retrofit中的请求头概念与作用

在HTTP请求中，请求头是包含了一系列客户端环境信息、用户代理的属性、内容类型等的字符串，可以用来传递客户端和网络服务器之间的信息。在Retrofit中，我们常常需要定制请求头以满足特定的需求，比如身份验证、内容协商等。

## 章节二：定制请求头

在使用Retrofit发送请求时，经常需要设置一些自定义的请求头，比如认证信息、用户身份标识等。本章将介绍如何在Retrofit中定制请求头，包括设置全局请求头和单个接口的特定请求头。

### 2.1 如何在Retrofit中设置全局请求头？

在实际开发中，有些请求头是每个接口都需要的，比如认证信息、用户标识等。我们可以通过拦截器来为每个请求添加这些全局请求头。

// 创建自定义的OkHttp拦截器
Interceptor headerInterceptor = new Interceptor() {
    @Override
    public Response intercept(Chain chain) throws IOException {
        Request originalRequest = chain.request();

        // 添加全局请求头
        Request requestWithHeaders = originalRequest.newBuilder()
                .header("Authorization", "Bearer token")
                .header("User-Agent", "Retrofit Example")
                .build();

        return chain.proceed(requestWithHeaders);
    }
};

// 创建OkHttpClient实例时添加拦截器
OkHttpClient client = new OkHttpClient.Builder()
        .addInterceptor(headerInterceptor)
        .build();

// 使用自定义的OkHttpClient创建Retrofit实例
Retrofit retrofit = new Retrofit.Builder()
        .baseUrl(BASE_URL)
        .client(client)
        .addConverterFactory(GsonConverterFactory.create())
        .build();

// 创建API接口实例并发送请求
ApiService apiService = retrofit.create(ApiService.class);
Call<ResponseBody> call = apiService.getData();

在上面的代码中，我们通过创建自定义的OkHttp拦截器来添加全局请求头，并在创建OkHttpClient实例时添加该拦截器，从而实现全局请求头的设置。

### 2.2 如何在Retrofit中设置单个接口的特定请求头？

有时候，我们需要为某个特定的请求设置特定的请求头，这时可以利用Retrofit的`@Headers`注解来实现。

public interface ApiService {
    @GET("data")
    @Headers({
            "Cache-Control: max-age=3600",
            "User-