前言
- 本篇是Retrofit和Rxjava混合的的一个案例，配合Rxjava的操作符以及其API,讲解Retrofit怎么转化成Rxjava的使用类型实现简洁异步的网络请求
代码托管地址
1. 依赖
//retrofit2.0依赖 版本号一致
compile 'com.squareup.retrofit2:retrofit:2.1.0'
compile 'com.squareup.retrofit2:converter-gson:2.1.0'
compile 'com.squareup.retrofit2:adapter-rxjava:2.1.0'
//Rxjava依赖,可以将Retrofit的ServiceApi接口不仅返回call还可以返回Observable
compile 'io.reactivex:rxjava:1.1.0'
compile 'io.reactivex:rxandroid:1.1.0'
compile 'net.orfjackal.retrolambda:retrolambda:1.8.1'
compile 'de.greenrobot:eventbus:2.4.0'
//在retrofit2.0中是没有日志功能的。但是retrofit2.0中依赖OkHttp，
// 所以也就能够通过OkHttp中的interceptor来实现实际的底层的请求和响应日志。
compile 'com.squareup.okhttp3:okhttp:3.4.1'
compile 'com.squareup.okhttp3:logging-interceptor:3.4.1'
初始化Retrofit（着重addCallAdapterFactory）
HttpLoggingInterceptor httpLoggingInterceptor = new HttpLoggingInterceptor(new HttpLoggingInterceptor.Logger() {
@Override
public void log(String message) {
Log.i("Rxjava", message);
}
});
httpLoggingInterceptor.setLevel(HttpLoggingInterceptor.Level.BODY);
OkHttpClient okHttpClient = new OkHttpClient.Builder()
.retryOnConnectionFailure(true)//设置重连
.connectTimeout(15, TimeUnit.SECONDS)
.addNetworkInterceptor(httpLoggingInterceptor)//网络拦截器（打印信息更丰富，消息实体内容长度类型等）
.build();
备注：
* HttpLoggingInterceptor可以设置无参，这里Logger()设置定向过滤Rxjava，默认是okhttp
* 设置拦截范围：BODY--- 请求/响应行 + 头 + 体
* 拦截器分为两种： .addInterceptor(httpLoggingInterceptor)//应用拦截器
*/
Retrofit retrofit = new Retrofit.Builder()
.baseUrl(ENDPOINT)
.client(okHttpClient)
.addCallAdapterFactory(RxJavaCallAdapterFactory.create())
.addConverterFactory(GsonConverterFactory.create())
.build();
mGithubAPI = retrofit.create(GithubAPIInterface.class);
备注：
* 1.基地址必须有（可以是全部，也可以是部分）
* 2.添加拦截器(非必须)
* 3.Converter是对于Call中T的转换， Call --------->Call
* Call中的Call也是可以被替换的，而返回值的类型就决定你后续的处理程序逻辑(非必须)
* 4.CallAdapter可以对Call转换，Retrofit提供了多个CallAdapter，这里以RxJava的为例，用Observable代替Call (非必须)
* 即Retrofit创建出接口的代理对象有多种形式，Call、Observable 而后者就是Retrofit实现对Rxjava的支持
* 5.初始化Retrofit
* 6.用Retrofit创建出接口的代理对象，用代理对象来操作其方法,返回Call
* 通过Call来请求入队，execute/enqueue(同步/异步)
*
*/
Retrofit配合Rxjava实现网络请求
备注：这里先上代码，后面会一一解释
demo主要基于一个网络返回的信息做下一次网络请求，对比上一篇纯Retrofit的请求处理
完整address1：https://api.github.com/users?per_page=1
完整address2：https://api.github.com/users/mojombo
final Observer subscriber = new Observer>() {
@Override
public void onCompleted() {
Log.i("tag", "onCompleted-----rx----");
}
@Override
public void onError(Throwable e) {
Log.i("tag", "onError---rx------");
}
@Override
public void onNext(List githubUserDetails) {
Log.i("tag", "onNext-----rx----");
tv.setText(githubUserDetails.toString());
}
};
subscribe = new GithubServiceManager().rxFetchUserDetails().subscribe(subscriber);
- 单例创建接口的代理对象
private GithubService() {
HttpLoggingInterceptor httpLoggingInterceptor = new HttpLoggingInterceptor(new HttpLoggingInterceptor.Logger() {
@Override
public void log(String message) {
Log.i("Rxjava", message);
}
});
httpLoggingInterceptor.setLevel(HttpLoggingInterceptor.Level.BODY);
OkHttpClient okHttpClient = new OkHttpClient.Builder()
.retryOnConnectionFailure(true)//设置重连
.connectTimeout(15, TimeUnit.SECONDS)
.addNetworkInterceptor(httpLoggingInterceptor)//网络拦截器（打印信息更丰富，消息实体内容长度类型等）
.build();
Retrofit retrofit = new Retrofit.Builder()
.baseUrl(ENDPOINT)
.client(okHttpClient)
.addCallAdapterFactory(RxJavaCallAdapterFactory.create())
.addConverterFactory(GsonConverterFactory.create())
.build();
mGithubAPI = retrofit.create(GithubAPIInterface.class);
}
/**
* 单例
*/
private static final GithubService INSTANCE = new GithubService();
public static GithubService getInstance() {
return INSTANCE;
}
- 接口内嵌方法
public Observable rxRequestUserDetails(@Path("username") String username) {
Log.i("tag", "rxRequestUserDetails----------");
return mGithubAPI.rxRequestUserDetails(username);
}
public Observable> rxRequestUsers() {
return mGithubAPI.rxRequestUsers(PER_PAGE);//第一条
}
@GET("users")//@Query是以Key = value的形式拼接到基地址
Observable> rxRequestUsers(@Query("per_page") Integer perPage);
@GET("users/{username}")//@Path以参数的形式传递
Observable rxRequestUserDetails(@Path("username") String username);
- Observable的关键实现
public Observable> rxFetchUserDetails() {
return mService.rxRequestUsers()
.concatMap(new Func1, Observable>() {
@Override
public Observable call(List iterable) {
Log.i("tag", "---------------concatMap1");//根据接收情况，这里只会执行一次
return Observable.from(iterable);
}
})//这里Observable激活后，根据接收情况会一一按顺序发送事件，如果这里new Func1参数GithubUser变成List就执行一次
.concatMap(new Func1>() {
@Override
public Observable call(GithubUser githubUser) {
Log.i("tag", "---------------concatMap2---+"+githubUser.mLogin);
//继续根据githubUser返回再次请求，获取具体信息
return mService.rxRequestUserDetails(githubUser.mLogin);
}
}
)
.toList()//上一步返回的一个个的GithubUser的信息，通过toList()将其转化成一个事件队列的Observable，不经过这一步则订阅的时候
//只会接收List的最后一个对象
.subscribeOn(Schedulers.newThread())
.observeOn(AndroidSchedulers.mainThread());
}
讲解：mService.rxRequestUsers()返回 以List形式的Observable对象，
new Func1(参数，返回对象Observable可以写成Observable< GithubUser>)，
concatmap是配合Func1()来实现整个事件队列对象的转换，根据new Func1()的参数List里的事件序列创建出一个的Observable 对象，
这里的对象和返回的observable不是一个对象，更加的解耦了上下关联，通过from将事件序列汇总到Observable，单一线程创建所以，顺序不变
- 订阅，处理数据
final Observer subscriber = new Observer>() {
@Override
public void onCompleted() {
Log.i("tag", "onCompleted-----rx----");
}
@Override
public void onError(Throwable e) {
Log.i("tag", "onError---rx------");
}
@Override
public void onNext(List githubUserDetails) {
Log.i("tag", "onNext-----rx----");
tv.setText(githubUserDetails.toString());
}
};
subscribe = new GithubServiceManager().rxFetchUserDetails().subscribe(subscriber);
//执行List.size()次onNext()(不出错的情况下 )，最终执行onCompleted()
//这里实例化Subscription subscribe；是为了使用完毕是及时反订阅
- 反订阅，防止内存泄漏
@Override
protected void onDestroy() {
if (subscribe != null && subscribe.isUnsubscribed()) {
subscribe.unsubscribe();
}
}
总结
通过Retrofit和Rxjava的混合使用和上上篇纯Retrofit使用优点显而易见，解耦了各个模块，避免因上级返回信息再次做处理时的层层嵌套，代码简洁干练，大大提高了读写行！
代码托管地址