拦截器

HTTP 拦截器

Apollo HTTP 拦截器

Apollo Kotlin支持多平台HttpInterceptor与OkHttp拦截器非常相似，使用它们来添加身份验证头、记录网络调用或其他。

接口是一个方法。例如，实现身份验证拦截器可以使用以下方式

1
class AuthorizationInterceptor(val token: String) : HttpInterceptor {
2
  override suspend fun intercept(request: HttpRequest,  chain: HttpInterceptorChain): HttpResponse {
3
    return chain.proceed(request.newBuilder().addHeader("Authorization", "Bearer $token").build())
4
  }
5
}

然后将其添加到您的HttpNetworkTransport：

1
val apolloClient = ApolloClient.Builder()
2
    .serverUrl("https://example.com/graphql")
3
    .addHttpInterceptor(AuthorizationInterceptor(token))
4
    .build()

Apollo Kotlin附带ClientAwarenessInterceptor和LoggingInterceptor，您可以在 ApolloClient 上设置。

OkHttp 拦截器

如果您的项目是 Android 或 JVM 专用项目，并且您已经有一个OkHttp Interceptor，您也可以重复使用它：

1
val okHttpClient = OkHttpClient.Builder()
2
    .addInterceptor(interceptor)
3
    .build()
4

5
val apolloClient = ApolloClient.Builder()
6
    .serverUrl("https://example.com/graphql")
7
    .okHttpClient(okHttpClient)
8
    .build()

GraphQL 拦截器

Apollo还支持在GraphQL级别拦截器：ApolloInterceptor。它们在有需要更改请求发送前或对响应作出反应时非常有用，并且可以集中管理。例如，可以用来追踪某些错误，或者在服务器在GraphQL级别而不是HTTP级别处理认证的情况下实现认证。Apollo底层实现了规范化缓存和APQ特性，这些功能都是通过ApolloInterceptor来实现的。

与HttpInterceptor类似，ApolloInterceptor也有一个方法，但其API基于Flow。请记住，Flow可以发射多次，例如在订阅的情况下。

下面是一个记录拦截器的示例

1
class LoggingApolloInterceptor: ApolloInterceptor {
2
  override fun <D : Operation.Data> intercept(request: ApolloRequest<D>, chain: ApolloInterceptorChain): Flow<ApolloResponse<D>> {
3
    return chain.proceed(request).onEach { response ->
4
      println("Received response for ${request.operation.name()}: ${response.data}")
5
    }
6
  }
7
}

然后将拦截器添加到您ApolloClient中：

1
val apolloClient = ApolloClient.Builder()
2
    .serverUrl("https://example.com/graphql")
3
    .addInterceptor(LoggingApolloInterceptor())
4
    .build()

问题排查

自定义HTTP客户端