在前几篇Google Drive相关的博客中,我们提到了token过期的问题。在进行任何一个Google APIs接口调用的时候,很有可能由于access token过期了(默认的使用期限才3600秒),会导致我们的请求失败,返回HTTP 401: Invalid Credentials error等异常。在这个时候,我们必须重新请求token,然后在请求成功的callback中再次请求我们相关的API。
看到这里,像这种异步的嵌套请求,我们很容易就联想到RxJava,异步世界必不可少的库。那么在Retrofit2.0中如何集成RxJava呢?在基于你已经正常使用Retrofit或者okhttp的情况下,只需简单3步,即可加入RxJava特性。
Retrofit 2.0中加入了CallAdapter机制,官方已经准备好了几个CallAdapter module,其中最著名的module可能是为RxJava准备的CallAdapter
,它能将请求结果作为Observable
返回,而不是默认的Call
对象。
compile 'com.squareup.retrofit2:adapter-rxjava:2.0.0'
compile 'io.reactivex:rxjava:1.1.3'
compile 'io.reactivex:rxandroid:1.1.0'
RxJavaCallAdapterFactory
Retrofit retrofit = new Retrofit.Builder()
.baseUrl(BASE_URL)
.addConverterFactory(GsonConverterFactory.create())
.addCallAdapterFactory(RxJavaCallAdapterFactory.create())
.build();
public interface DriveApi {
@GET("oauth2/v3/userinfo")
Observable requestUserInfo(
@Header("Authorization") String authToken);
}
根据上面的描述(以请求用户信息这个需求来做例子):当token失效时,请求会失败。此时我们需要重新请求token,然后再请求用户信息。这里能提取以下两点需求:
那么这两点在RxJava中能肿么实现呢?
对这3个操作符的原理和用法感兴趣的朋友可以直接进入链接深入学习,下面是经过RxJava优化过的代码(以请求用户信息这个为例子):
Observable.just(null)
.flatMap(new Func1
下面简单解析上述流程:
当requestUserInfo()
抛出异常的时候,会进入到retryWhen()
包含的逻辑中。其中throwable Observable通过zipWith()
与Observable.range(1, 3)
生成的Observable组合在一起,以实现重试次数最多3次的限制。经过flatMap()
将requestTokenRefresh()
返回的Observable return。其中doOnNext()
操作符实现获取到token后将其更新至相应变量中,以使我们重新requestUserInfo()
时能用最新的token去请求数据。
有同学对一开始的Observable.just(null).flatMap()
可能不是太理解,因为token过期经过重试重新请求完回调时,会再次调用call()
方法重新执行requestUserInfo()
,并且此时call()
中传入的object每次都是同一个。若此处去掉flatMap()
,会导致一直使用旧的token进行请求,所以此处多加了一次flatMap()
包裹着。还是不理解的,可以把它去掉,自己对比下效果就明白了。
上面的代码用retrolambda
简化后可能逻辑会更清晰些。。。