一步一步带你认识 MVP+Retrofit+Rxjava 并封装（二）
序言
继续上周咱们没讲完的，上周咱们一起撸了一把 MVP，今天跟着LZ继续撸Retrofit+RxJava，这俩算得上当下最流行的网络框架了，数据说话，有空的话你们也去 github 上搜索一波：
我们可以看出来，单论 star 数的话，Retrofit 和 OkHttp 是巨头般的存在，网上关于 retrofit 的文章早已数不胜数了，这里我也不详细介绍了，下面就直接进入主题。
封装
在开始之前，先介绍大家去学习一下 RxJava，这个是真的灰常有用的一个库，Rx 系列的都很不错，这里有两个版本，他们之间的方法稍微改变了一下，其他都差不多：
给初学者的 RxJava2.0 教程系列
http://www.jianshu.com/u/c50b715ccaeb
给 Android 开发者的 RxJava1.0 详解
http://gank.io/post/560e15be2dca930e00da1083
如果你上周没跟着LZ一起撸的话，那么请移步：
一步一步带你认识 MVP+Retrofit+Rxjava 并封装（一）
1、导包：
2、封装：
我们先来看一下，一个完整的 Retrofit+Rxjva 的请求：
OkHttpClient.Builder builder = new OkHttpClient().newBuilder();
builder.readTimeout(DEFAULT_TIME, TimeUnit.SECONDS);
builder.connectTimeout(DEFAULT_TIME, TimeUnit.SECONDS);
//设置拦截器
builder.addInterceptor(new BasicParamsInterceptor.Builder().addParamsMap(getCommonMap()).build());
builder.addInterceptor(new HttpLoggingInterceptor().setLevel(HttpLoggingInterceptor.Level.BODY));
OkHttpClient okHttpClient = builder.build();
Retrofit retrofit = new Retrofit.Builder()
.baseUrl(BASE_URL)
.client(okHttpClient)
.addConverterFactory(CustomGsonConverterFactory.create())
.addCallAdapterFactory(RxJava2CallAdapterFactory.create())
.build();
ApiService api=retrofit.create(ApiService.class);
api.login(username,password)
.subscribeOn(Schedulers.io()) //在IO线程进行网络请求
.observeOn(AndroidSchedulers.mainThread()) //回到主线程去处理请求结果
.subscribe(new Observer<LoginResponse>() {
@Override
public void onSubscribe(Disposable d) {
//为请求提供一个取消的手段
}
@Override
public void onNext(LoginResponse value) {
//请求成功
}
@Override
public void onError(Throwable e) {
//请求出错
}
@Override
public void onComplete() {
//请求完成
}
});
考虑到每次请求接口的时候都需要去实例化一个 Retrofit 对象，而且每次都需要用 RxJava 来进行线程的切换，因此我就想到把它们都写到一个基类里面去。
public abstract class BaseRetrofit {
protected Retrofit mRetrofit;
private static final int DEFAULT_TIME = 10; //默认超时时间
private final long RETRY_TIMES = 1; //重订阅次数
public BaseRetrofit() {
//创建okHttpClient
if (null == mRetrofit) {
OkHttpClient.Builder builder = new OkHttpClient().newBuilder();
builder.readTimeout(DEFAULT_TIME, TimeUnit.SECONDS);
builder.connectTimeout(DEFAULT_TIME, TimeUnit.SECONDS);
//设置拦截器
builder.addInterceptor(new BasicParamsInterceptor.Builder().addParamsMap(getCommonMap()).build());
builder.addInterceptor(new HttpLoggingInterceptor().setLevel(HttpLoggingInterceptor.Level.BODY));
OkHttpClient okHttpClient = builder.build();
mRetrofit = new Retrofit.Builder()
.baseUrl(HttpServletAddress.getInstance().getServletAddress())
.client(okHttpClient)
.addConverterFactory(CustomGsonConverterFactory.create())
.addCallAdapterFactory(RxJava2CallAdapterFactory.create())
.build();
}
}
}
然后结合我们上周讲的 MVP，让 BaseModel 继承它，然后调用方法进行请求，上周我们还没有细节讲它是怎么样进行网络请求的，回到刚才那个完整的请求的例子，可以看到，这里发起请求需要两个东西，一个 Observer，另一个是 api.login()的返回值 Observable，这就是大佬们口中说的观察者和被观察者，他们之间有一个很微妙的关系，叫订阅；被观察者负责网络请求，观察者负责观察网络请求的回调，每发生一次接口请求，都会有订阅发生，所以在这里我把订阅公共的逻辑放到了 BaseRetrofit中：
protected <T> void toSubscribe(Observable<T> observable, Observer<T> observer) {
observable.subscribeOn(Schedulers.io()) // 指定subscribe()发生在IO线程
.observeOn(AndroidSchedulers.mainThread()) // 指定Subscriber的回调发生在io线程
.timeout(DEFAULT_TIME, TimeUnit.SECONDS) //重连间隔时间
.retry(RETRY_TIMES)
// .repeatWhen(new Function<Observable<Object>, ObservableSource<?>>() {
// @Override
// public ObservableSource<?> apply(@NonNull Observable<Object> objectObservable) throws Exception {
// return null;
// }
// })
.subscribe(observer); //订阅
}
这样每次我们组装好 Observable 和 Observer 之后就调用这个方法进行订阅就好了。这里我有一个困惑，已经很久了，希望知道的读者能帮忙解惑，重写 retryWhen 的时候，如何根据错误类型进行重试。讲到这里可能有人就要问了，LZ你不还是没有讲是怎么进行网络请求的吗？大兄弟别急，我这就告诉你，它是通过自定义接口的形式来进行网络请求的，好吧，说了好像也白说，换个场景你自个去深入了解去吧：
Retrofit 网络请求框架的基本使用 http://blog.csdn.net/zw904448290/article/details/52717384
好了，接着我们下面的封装：
被观察者已经当作接口被我们处理掉了，那么下面我们重点关注观察者；很久之前我老大跟我讲网络请求封装这一块，他当时说我们只关注请求成功的数据，其他的不需要特别关注；首先，我们得有一套统一的回调样式，如下：
由于我们这边都把返回的 json 数据都转成 BaseResponse<T>格式了，如果你们回调的数据格式不统一的话，那就去找后端撕逼去吧；然后我们只需要重写Observer 就行了，Observer 接口中有四个方法，上面例子中我们简单介绍了一下，它们的执行顺序分别是 onSubscribe——>onNext——>onComplete（onError），这里需要简单提一下，onComplete 和 onError方法二者不会同时都执行，具体来看一下LZ封装的：
public abstract class BaseObserver<T> implements Observer<T> {
private static final String TAG = "BaseObserver";
protected abstract void onBaseError(Throwable t);
protected abstract void onBaseNext(T data);
protected abstract boolean isNeedProgressDialog();
protected abstract String getTitleMsg();
private ProgressDialogHandler mProgressDialogHandler;
private BaseImpl mBaseImpl;
public BaseObserver(BaseImpl baseImpl) {
mBaseImpl = baseImpl;
if (null != mBaseImpl) {
if (null == mProgressDialogHandler) {
mProgressDialogHandler = new ProgressDialogHandler(baseImpl.getContext(), true);
}
}
}
private void showProgressDialog() {
if (mProgressDialogHandler != null) {
mProgressDialogHandler.obtainMessage(ProgressDialogHandler.SHOW_PROGRESS_DIALOG, getTitleMsg()).sendToTarget();
}
}
private void dismissProgressDialog() {
if (mProgressDialogHandler != null) {
mProgressDialogHandler.obtainMessage(ProgressDialogHandler.DISMISS_PROGRESS_DIALOG).sendToTarget();
mProgressDialogHandler = null;
}
}
@Override
public void onSubscribe(Disposable d) {
//显示进度条
if (isNeedProgressDialog()) {
showProgressDialog();
}
if (null != mBaseImpl) {
if (null != d) {
mBaseImpl.addDisposable(d);
}
}
}
@Override
public void onNext(T value) {
//成功
Log.d(TAG, "http is onNext");
if (null != value) {
onBaseNext(value);
}
}
@Override
public void onError(Throwable e) {
//关闭进度条
Log.e(TAG, "http is onError");
if (isNeedProgressDialog()) {
dismissProgressDialog();
}
onBaseError(e);
}
@Override
public void onComplete() {
//关闭进度条
if (isNeedProgressDialog()) {
dismissProgressDialog();
}
}
}
这里考虑到有些界面需要进度框，所以我把这一部分也整合到观察者里面，这里根据外面调用的地方有没有设置 Title来判断是否显示进度框，然后再进行相应的回调，进度框使用的是系统的 ProgressDialog，当然了，你也可以自定义一个进度框样式，详细见 demo。前面我们说到我们只关心成功的数据，失败的数据我们需要在内部处理掉，即再封装一层，吃掉 onBaseError：
public abstract class CygBaseObserver<T> extends BaseObserver<T> {
private static final String TAG = "CygBaseObserver";
private boolean isNeedProgress;
private String titleMsg;
public CygBaseObserver() {
this(null, null);
}
public CygBaseObserver(BaseImpl base) {
this(base, null);
}
public CygBaseObserver(BaseImpl base, String titleMsg) {
super(base);
this.titleMsg = titleMsg;
if (TextUtils.isEmpty(titleMsg)) {
this.isNeedProgress = false;
} else {
this.isNeedProgress = true;
}
}
@Override
protected boolean isNeedProgressDialog() {
return isNeedProgress;
}
@Override
protected String getTitleMsg() {
return titleMsg;
}
@Override
protected void onBaseError(Throwable t) {
StringBuffer sb = new StringBuffer();
sb.append("请求失败：");
if (t instanceof NetworkErrorException || t instanceof UnknownHostException || t instanceof ConnectException) {
sb.append("网络异常");
} else if (t instanceof SocketTimeoutException || t instanceof InterruptedIOException || t instanceof TimeoutException) {
sb.append("请求超时");
} else if (t instanceof JsonSyntaxException) {
sb.append("请求不合法");
} else if (t instanceof JsonParseException
|| t instanceof JSONException
|| t instanceof ParseException) { // 解析错误
sb.append("解析错误");
} else if (t instanceof ApiException) {
if (((ApiException) t).isTokenExpried()) {
sb.append("Token出错");
}
} else {
FRToast.showToastSafe(t.getMessage());
return;
}
Log.e(TAG, "onBaseError: " + sb.toString());
FRToast.showToastSafe(sb.toString());
}
}
最开始的例子当中有一个 Disposable 的概念，这个是用来切断观察者与被观察者之间的关系的，每次请求都会产生一个响应的 Disposable，所以这里我用了一个接口 BaseImpl 的形式来回收它，在产生的地方收集它，在 BaseActivity 的 onDestroy 中来回收它，详细的请参见 demo；好了，到这里我们的封装就完成了 90% 了，让我们回到上一次博客当中，组装 Observable的时候我们还进行了一个 map 操作：
这里 map 就是进行一个中间的操作，这个操作叫做变换，我们来看一下HttpFunction 的实现是怎样的：
public class HttpFunction<T> implements Function<BaseResponse<T>, T> {
@Override
public T apply(BaseResponse<T> response) throws Exception {
if (!response.isRequestSuccess()) {
throw new ApiException(response.getStatus(), String.valueOf(response.getMsg()));
}
return response.getData();
}
}
相信看完方法的实现大家应该知道这个是干什么用的了，没错，这个方法就是将 BaseResponse<T> 转换成 T，因为我们只关注成功的数据，而且只关注data 里面的数据，由于返回的数据是 BaseResponse<T>，而我们需要关注的数据是T，所以在这里需要转换一下，然后判断请求是否成功就行了。
好了，到这里基本的网络请求封装就完成了，如果你有更好的方法，请私信我一起交流，同时感谢以上引用到博客的博主。最后的最后，放出最后的代码，欢迎 star 和 fork
MVP 主工程代码
https://github.com/Jakemesdg/MVPDemo
MVP module工程代码
https://github.com/Jakemesdg/cygmodule
与之相关
关键词：code小生