如何为okhttp 2.x请求指定默认用户代理

Question

我在我的Android应用程序中使用okhttp 2.0,并没有找到为所有传出请求设置一些常用用户代理的方法.

我以为我可以做点什么

OkHttpClient client = new OkHttpClient();
client.setDefaultUserAgent(...)

......但是没有这样的方法或类似方法.当然我可以提供一些扩展实用程序方法,它会将RequestBuilder包装起来.header("UserAgent")然后我会用它来构建我的所有请求,但我想也许我错过了一些现有的和更简单的方法？

Answer 1

您可以使用拦截器将User-Agent标头添加到您的所有请求中.

有关okHttp拦截器的更多信息,请参阅https://github.com/square/okhttp/wiki/Interceptors

此拦截器的示例实现:

/* This interceptor adds a custom User-Agent. */
public class UserAgentInterceptor implements Interceptor {

    private final String userAgent;

    public UserAgentInterceptor(String userAgent) {
        this.userAgent = userAgent;
    }

    @Override
    public Response intercept(Chain chain) throws IOException {
        Request originalRequest = chain.request();
        Request requestWithUserAgent = originalRequest.newBuilder()
            .header("User-Agent", userAgent)
            .build();
        return chain.proceed(requestWithUserAgent);
    }
}

测试UserAgentInterceptor:

public void testUserAgentIsSetInRequestHeader() throws Exception {

    MockWebServer server = new MockWebServer();
    server.enqueue(new MockResponse().setBody("OK"));
    server.play();
    String url = server.getUrl("/").toString();

    OkHttpClient client = new OkHttpClient();
    client.networkInterceptors().add(new UserAgentInterceptor("foo/bar"));
    Request testRequest = new Request.Builder().url(url).build()
    String result = client.newCall(testRequest).execute().body().string();
    assertEquals("OK", result);

    RecordedRequest request = server.takeRequest();
    assertEquals("foo/bar", request.getHeader("User-Agent"));
}

Answer 2

这将在未来几周内发布OkHttp V2.1 将自动设置一个User-Agent,如果一个尚未设置标题.

截至目前,没有一种好方法可以集中方式将此标头添加到每个请求中.唯一的解决方法是为每个Request创建的手动包含头.

Answer 3

如果有人在使用OkHttp 3和Kotlin来寻找它，请执行以下操作：

val client = OkHttpClient.Builder()
    .addNetworkInterceptor { chain ->
      chain.proceed(
          chain.request()
              .newBuilder()
              .header("User-Agent", "COOL APP 9000")
              .build()
      )
    }
    .build()

Answer 4

在较新版本的OkHttp中不再需要使用截取器.添加用户代理非常简单:

Request request = new Request.Builder()
    .url("http://www.publicobject.com/helloworld.txt")
    .header("User-Agent", "OkHttp Example")
    .build();

资料来源:OkHttp wiki.

Answer 5

基于@josketres 的回答，这里有一个类似的OkHttp 版本 3拦截器

public class UserAgentInterceptor implements Interceptor {
    private final String mUserAgent;

    public UserAgentInterceptor(String userAgent) {
        mUserAgent = userAgent;
    }

    @Override
    public Response intercept(@NonNull Chain chain) throws IOException {
        Request request = chain.request()
                .newBuilder()
                .header("User-Agent", mUserAgent)
                .build();
        return chain.proceed(request);
    }
}

加上更新的测试：

@Test
public void testUserAgentIsSetInRequestHeader() throws IOException, InterruptedException {
    final String expectedUserAgent = "foo/bar";

    MockWebServer server = new MockWebServer();
    server.enqueue(new MockResponse().setBody("OK"));
    server.start();

    OkHttpClient.Builder okHttpBuilder = new OkHttpClient.Builder();
    okHttpBuilder.addInterceptor(new UserAgentInterceptor(expectedUserAgent));
    Request request = new Request.Builder().url(server.url("/").url()).build();
    ResponseBody result = okHttpBuilder.build().newCall(request).execute().body();
    assertNotNull(result);
    assertEquals("OK", result.string());

    assertEquals(expectedUserAgent, server.takeRequest().getHeader("User-Agent"));
}

Answer 6

您必须builder在较新的版本中使用。（2021 年 9 月）

    client = new OkHttpClient.Builder()
            .addInterceptor(new Interceptor() {
                @NotNull
                @Override
                public Response intercept(@NotNull Chain chain) throws IOException {
                    Request originalRequest = chain.request();
                    Request requestWithUserAgent = originalRequest.newBuilder()
                            .header("User-Agent", "My Agent is so cool")
                            .build();
                    return chain.proceed(requestWithUserAgent);
                }
            })
            .build();