RxJava Retrofit2 网络请求，返回数据格式统一的数据报文处理方法

转载自：该文 感谢！

统一的报文格式

一般公司开发都是会设计请求报文，报文结构一般是统一的，例如下面这样的格式

{
 "code": "error",
 "msg": "错误信息",
 "data": "返回数据信息"
}

data 有可能是JsonArray 也有可能是JsonObject。demo如下：
JsonArray

{
 "code": "ok",
 "msg": "",
 "data": [
   "1923837918273.jpg",
   "1039488945879.jpg",
   "3981293879878.jpg",
   "5927378100293.jpg"
 ]
}

JsonObject

{
 "code": "ok",
 "msg": "",
 "data": {
   "fileName":"1923837918273.jpg"
 }
}

那么使用Json序列化工具的时候，数据格式就会发生一定的变形。
DataResponse.java

/**
 * <b>类名称：</b> DataResponse <br/>
 * <b>类描述：</b> 携带有数据的Http请求报文<br/>
 * <b>创建人：</b> Lincoln <br/>
 * <b>修改人：</b> Lincoln <br/>
 * <b>修改时间：</b> 2016年03月15日 下午5:19<br/>
 * <b>修改备注：</b> <br/>
 *
 * @version 1.0.0 <br/>
 */
public class DataResponse<T> {

    private String code;
    private String msg;
    private T data;

    public String getCode() {
        return code;
    }

    public void setCode(String code) {
        this.code = code;
    }

    public String getMsg() {
        return msg;
    }

    public void setMsg(String msg) {
        this.msg = msg;
    }

    public T getData() {
        return data;
    }

    public void setData(T data) {
        this.data = data;
    }
}

当data为JsonObject时Observable的泛型如下

Observable<DataResponse<User>>

当data为JsonArray时Observable的泛型如下

Observable<DataResponse<List<String>>>

这样泛型很多层，获取数据更是一个体力活。我们的报文既然是固定格式的，那么可不可以在处理的时候自动化？

答案是可行的！
使用map操作符，转换数据流

此文使用到了RxJava中的map操作符，此处不赘述，不清楚的童鞋点击这里
rain 大神的 RxJava 教程 http://blog.chengyunfeng.com/?p=964
写的超级细致！赞！

map操作符是可以转换数据流的操作符，那么我们是不是可以将DataResponse或DataResponse

import rx.functions.Func1;

/**
 * <b>类名称：</b> ResponseFunc <br/>
 * <b>类描述：</b> 用于处理DataResponse数据格式的数据<br/>
 * <b>创建人：</b> Lincoln <br/>
 * <b>修改人：</b> Lincoln <br/>
 * <b>修改时间：</b> 2016年03月23日 下午4:04<br/>
 * <b>修改备注：</b> <br/>
 *
 * @version 1.0.0 <br/>
 */
public class ResponseFunc<T> implements Func1<DataResponse<T>, T> {

    private static final String RESP_OK = "ok";

    //此处逻辑根据约定报文进行修改，实现逻辑即可
    @Override
    public T call(DataResponse<T> httpResult) {
        if (!httpResult.getCode().equals(RESP_OK)) {
            // 在此处抛出异常，subscribe的onError方法中会收到异常。
            // 抛出的异常不能是会使系统崩溃的检查异常，如OOM
            throw new IllegalStateException(httpResult.getMsg());
        }
        return httpResult.getData();
    }
}

使用方法：

@Override
public void getConvenientBanner(final ServerView serverView) {
        ConvenientBannerModel model = new ConvenientBannerModelImpl();
        model.convenientBanner()
                .observeOn(AndroidSchedulers.mainThread())
                .subscribeOn(Schedulers.io())
                //在此处调用一下，subscribe再处理的时候就脱掉了DataResponse
                .map(new ResponseFunc<List<String>>())
                .subscribe(new Action1<List<String>>() {
                    @Override
                    public void call(List<String> images) {
                        serverView.convenientBanner(images);
                    }
                }, new Action1<Throwable>() {
                    @Override
                    public void call(Throwable throwable) {
                        DebugLog.e("首页广告图获取失败，" + throwable.getLocalizedMessage());
                    }
                });
    }

至此，即可简便的处理统一格式的数据报文。XML、Json 均可以使用！