Retrofit2.0 实现公共参数添加指南

"这篇文章主要讲解了Retrofit2.0中的公共参数（固定参数）处理方法，分享了如何在请求中添加这些参数以满足项目需求。文章指出，虽然Retrofit2.0不再支持RequestInterceptor，但可以通过Interceptor来实现类似功能。" 在Android应用开发中，Retrofit是一个非常流行的网络请求库，它提供了简洁的API来构建HTTP服务。在某些应用场景下，我们可能需要在每个网络请求中都添加一些固定的公共参数，比如用户ID、设备信息或者特定的API密钥等。这些参数不会根据请求的不同而改变，因此被称为“固定参数”或“公共参数”。 在Retrofit1.x版本中，可以使用`RequestInterceptor`来添加这些公共参数。例如，下面的代码片段展示了如何在每个请求中添加一个名为"publicParams"的查询参数： ```java RestAdapter restAdapter = new RestAdapter.Builder() .setEndpoint(ctx) .setRequestInterceptor(new RequestInterceptor() { @Override public void intercept(RequestFacade request) { request.addQueryParam("publicParams", "1"); } }) .setConverter(new BaseConverter()) .build(); ``` 然而，在Retrofit2.0中，`RequestInterceptor`已被移除，取而代之的是更强大的`Interceptor`接口。`Interceptor`允许我们在请求被发送到服务器之前对其进行拦截和修改。我们可以利用这个特性来添加公共参数。以下是一个简单的`Interceptor`实现示例，用于添加API Key和API Secret： ```java public class CommonInterceptor implements Interceptor { private final String mApiKey; private final String mApiSecret; public CommonInterceptor(String apiKey, String apiSecret) { mApiKey = apiKey; mApiSecret = apiSecret; } @Override public Response intercept(Chain chain) throws IOException { Request originalRequest = chain.request(); // 创建一个新的请求，添加公共参数 Request.Builder builder = originalRequest.newBuilder(); builder.addHeader("X-API-Key", mApiKey); builder.addHeader("X-API-Secret", mApiSecret); // 返回修改后的请求，将被Retrofit继续处理 return chain.proceed(builder.build()); } } ``` 在上述代码中，我们创建了一个`CommonInterceptor`类，它会在每次请求时添加API Key和API Secret作为HTTP头。`intercept`方法接收一个`Interceptor.Chain`对象，这个对象包含了原始的请求和发送请求的能力。我们构建一个新的请求，添加头信息，然后使用`chain.proceed()`方法继续执行请求。 要在Retrofit2.0中使用这个拦截器，我们需要将其添加到OkHttpClient的拦截器链中，并将OkHttpClient配置给Retrofit实例： ```java OkHttpClient client = new OkHttpClient.Builder() .addInterceptor(new CommonInterceptor(apiKey, apiSecret)) .build(); Retrofit retrofit = new Retrofit.Builder() .baseUrl("https://api.example.com/") .client(client) .build(); ``` 这样，每一个由Retrofit发起的网络请求都会经过`CommonInterceptor`，并自动添加必要的公共参数。这种方法不仅适用于添加HTTP头，还可以用于修改URL、添加查询参数或请求体等，使得公共参数的管理更加灵活和集中。 通过使用Retrofit2.0的`Interceptor`，开发者可以方便地处理固定参数，保持代码的整洁，并确保每个请求都携带必要的上下文信息。这种做法提高了代码的可维护性，也是现代Android应用开发中处理网络请求的一种最佳实践。