返回

通过 Interceptor 和协程轻松实现 Android 中的自动刷新 Token

Android

在 Android 中使用 Interceptor 和协程实现自动刷新令牌

前言

对于开发者而言，确保应用程序中用户登录状态的有效性至关重要。在令牌失效时避免用户注销，需要实现自动刷新令牌的机制。本文将介绍如何使用 Interceptor 和协程在 Android 中实现此功能，优化用户体验。

什么是令牌？

令牌是服务器在用户登录时颁发的唯一标识符。它用于验证用户身份并在应用程序会话期间授权请求。令牌通常有有限的有效期，需要定期刷新以保持登录状态。

Interceptor

Interceptor 是一个第三方网络库，如 OkHttp 或 Retrofit，提供的功能。它可以拦截网络请求并对其进行处理，使其非常适合于自动刷新令牌。Interceptor 会监视每个请求，并在检测到令牌无效时触发刷新操作。

协程

协程是一个 Android 异步编程模型，可让开发者在后台执行长时间运行的任务而不阻塞 UI 线程。这使其成为刷新令牌的理想选择，因为刷新操作可以异步进行，不会影响应用程序的响应能力。

实施自动刷新令牌

要实现自动刷新令牌，需要遵循以下步骤：

  1. 创建 Interceptor： 创建一个 Interceptor 类，重写 intercept() 方法。该方法负责拦截网络请求，并根据需要刷新令牌。
  2. 创建协程： 创建一个协程函数，用于异步刷新令牌。该函数应调用服务器刷新令牌的端点并更新本地存储的令牌。
  3. 将 Interceptor 添加到网络客户端： 将 Interceptor 添加到网络客户端，以便在每个请求中应用它。
  4. 处理失效的令牌： 在 Interceptor 的 intercept() 方法中，检查响应代码。如果响应代码指示令牌无效，触发协程函数刷新令牌并重试请求。

代码示例

Interceptor：

public class TokenInterceptor implements Interceptor {

    @Override
    public Response intercept(Chain chain) throws IOException {
        Request request = chain.request();
        String token = SharedPreferencesUtil.getString("token");

        Request newRequest = request.newBuilder()
                .addHeader("Authorization", "Bearer " + token)
                .build();

        Response response = chain.proceed(newRequest);

        if (response.code() == 401) {
            refreshToken();
            String newToken = SharedPreferencesUtil.getString("token");

            Request newRequestWithNewToken = request.newBuilder()
                    .addHeader("Authorization", "Bearer " + newToken)
                    .build();

            response = chain.proceed(newRequestWithNewToken);
        }

        return response;
    }
}

协程：

private fun refreshToken() {
    GlobalScope.launch(IO) {
        val response = RetrofitClient.create(AuthService::class.java)
                .refreshToken(refreshToken)
                .await()

        SharedPreferencesUtil.putString("token", response.token)
    }
}

添加 Interceptor 到网络客户端：

OkHttpClient.Builder okHttpClientBuilder = new OkHttpClient.Builder();
okHttpClientBuilder.addInterceptor(new TokenInterceptor());

常见问题解答

  1. 为什么需要自动刷新令牌？

    • 为了避免令牌失效后用户被注销。

  2. Interceptor 和协程如何协同工作？

    • Interceptor 检测无效令牌并触发协程刷新。协程在后台刷新令牌，不阻塞 UI 线程。

  3. 如何处理令牌失效期间的请求？

    • Interceptor 会自动重试请求，使用新的刷新后的令牌。

  4. 是否需要手动刷新令牌？

    • 不需要，Interceptor 会自动处理刷新过程。

  5. 如何配置刷新令牌的频率？

    • 可以自定义 Interceptor 来控制刷新频率，例如，在令牌即将失效之前刷新。

总结

通过在 Android 中使用 Interceptor 和协程，开发者可以轻松实现自动刷新令牌。这种方法优化了用户体验，确保在令牌失效时用户不会遇到中断，从而提升应用程序的稳定性和易用性。