統一的報文格式

一般公司開發都是會設計請求報文，報文結構一般是統一的，例如下面這樣的格式

{
 "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操作符，轉換資料流

map操作符是可以轉換資料流的操作符，那麼我們是不是可以將DataResponse<User>或DataResponse<List<String>> 格式的泛型結構自動脫去一層？

最簡單的方法就是我們繼承Func1類，過載裡面的call方法，自動化脫掉一層泛型。
程式碼如下

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 均可以使用！