Android RxJava2+Retrofit2搭建網(wǎng)絡請求框架

前言

之前做網(wǎng)絡請求,用的是android-async-http惰蜜,基于HttpClient 的,雖然早已淘汰受神,但一直懶得換抛猖,前一段時間看了stormzhang的《2016 Android Top 10 Library》文章,提到RxJava+Retrofit 是完美搭配路克,所以下定決定重構一下現(xiàn)在的項目

網(wǎng)上查了一些資料樟结,遇到了一些小坎坷养交,終于搞定了精算,因為網(wǎng)上查到的一些文章大多都是半年以前的,而我使用的都是最新的庫碎连,遇到了一些新的問題灰羽,所以感覺有必要寫篇文章幫助后人少走一些彎路

本文默認讀者對RxJava和Retrofit 已經(jīng)有了一定的了解,若對RxJava和Retrofit 還不了解鱼辙,請先查閱相關資料

使用

1廉嚼、添加依賴庫

compile "io.reactivex.rxjava2:rxjava:2.1.1"
compile 'io.reactivex.rxjava2:rxandroid:2.0.1'
compile 'com.squareup.retrofit2:retrofit:2.3.0'
compile 'com.squareup.retrofit2:converter-gson:2.3.0'
compile 'com.squareup.retrofit2:adapter-rxjava2:2.3.0'

converter-gson是Retrofit到Gson進行轉換的庫,adapter-rxjava2是Retrofit到RxJava進行轉換的庫

這里我是采用Google Gson進行數(shù)據(jù)解析的倒戏,如果你使用的是Jackson怠噪,替換為如下依賴即可

compile 'com.squareup.retrofit2:converter-jackson:2.3.0'

如果需要添加HttpLoggingInterceptor進行調試,添加如下依賴

compile 'com.squareup.okhttp3:logging-interceptor:3.8.1'

2杜跷、寫一個Service

public interface RetrofitService {
    @FormUrlEncoded
    @POST("account/login")
    Observable<BaseEntity<UserInfo>> login(
            @Field("userId") String userId,
            @Field("password") String password
    );

    @GET("video/getUrl")
    Observable<BaseEntity<VideoUrl>> getVideoUrl(
            @Query("id") long id
    );

    @FormUrlEncoded
    @POST("user/addVideo")
    Observable<BaseEntity<Boolean>> addVideo(
            @FieldMap Map<String, Object> map
    );
}

相對于單獨使用Retrofit傍念,該處返回的是Observable對象

3矫夷、通常服務器端會返回統(tǒng)一的數(shù)據(jù)格式,這里我們寫一個BaseEntity

public class BaseEntity<E> {

    @SerializedName("code")
    private int code;
    @SerializedName("msg")
    private String msg;
    @SerializedName("data")
    private E data;

    public boolean isSuccess() {
        return code == 0;
    }

    public int getCode() {
        return code;
    }

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

    public String getMsg() {
        return msg;
    }

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

    public E getData() {
        return data;
    }

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

4憋槐、然后我們可以封裝一個RetrofitFactory

public class RetrofitFactory {

    private static final String BASE_URL = "http://api.baidu.com/";

    private static final long TIMEOUT = 30;

    // Retrofit是基于OkHttpClient的双藕,可以創(chuàng)建一個OkHttpClient進行一些配置
    private static OkHttpClient httpClient = new OkHttpClient.Builder()
            // 添加通用的Header
            .addInterceptor(new Interceptor() {
                @Override
                public Response intercept(Chain chain) throws IOException {
                    Request.Builder builder = chain.request().newBuilder();
                    builder.addHeader("token", "123");
                    return chain.proceed(builder.build());
                }
            })
            /*
            這里可以添加一個HttpLoggingInterceptor,因為Retrofit封裝好了從Http請求到解析阳仔,
            出了bug很難找出來問題忧陪,添加HttpLoggingInterceptor攔截器方便調試接口
             */
            .addInterceptor(new HttpLoggingInterceptor(new HttpLoggingInterceptor.Logger() {
                @Override
                public void log(String message) {

                }
            }).setLevel(HttpLoggingInterceptor.Level.BASIC))
            .connectTimeout(TIMEOUT, TimeUnit.SECONDS)
            .readTimeout(TIMEOUT, TimeUnit.SECONDS)
            .build();

    private static RetrofitService retrofitService = new Retrofit.Builder()
            .baseUrl(BASE_URL)
            // 添加Gson轉換器
            .addConverterFactory(GsonConverterFactory.create(buildGson()))
            // 添加Retrofit到RxJava的轉換器
            .addCallAdapterFactory(RxJava2CallAdapterFactory.create())
            .client(httpClient)
            .build()
            .create(RetrofitService.class);

    public static RetrofitService getInstance() {
        return retrofitService;
    }

    private static Gson buildGson() {
        return new GsonBuilder()
                .serializeNulls()
                .setFieldNamingPolicy(FieldNamingPolicy.IDENTITY)
                // 此處可以添加Gson 自定義TypeAdapter
                .registerTypeAdapter(UserInfo.class, new UserInfoTypeAdapter())
                .create();
    }
}

5、通常我們會在IO線程進行請求近范,在主線程進行回調

public class RxSchedulers {

    public static <T> ObservableTransformer<T, T> compose() {
        return new ObservableTransformer<T, T>() {
            @Override
            public ObservableSource<T> apply(Observable<T> observable) {
                return observable
                        .subscribeOn(Schedulers.io())
                        .doOnSubscribe(new Consumer<Disposable>() {
                            @Override
                            public void accept(Disposable disposable) throws Exception {
                                if (!Utils.isNetworkConnected()) {
                                    Toast.makeText(context, R.string.toast_network_error, Toast.LENGTH_SHORT).show();
                                }
                            }
                        })
                        .observeOn(AndroidSchedulers.mainThread());
            }
        };
    }
}

這里我們可以添加一個通用的網(wǎng)絡連接判斷

6嘶摊、RxJava Observable 訂閱需要傳入一個Observer對象,此處封裝一個BaseObserver

public abstract class BaseObserver<T> implements Observer<BaseEntity<T>> {

    private static final String TAG = "BaseObserver";
    private Context mContext;

    protected BaseObserver(Context context) {
        this.mContext = context.getApplicationContext();
    }

    @Override
    public void onSubscribe(Disposable d) {

    }

    @Override
    public void onNext(BaseEntity<T> value) {
        if (value.isSuccess()) {
            T t = value.getData();
            onHandleSuccess(t);
        } else {
            onHandleError(value.getMsg());
        }
    }

    @Override
    public void onError(Throwable e) {
        Log.e(TAG, "error:" + e.toString());
    }

    @Override
    public void onComplete() {
        Log.d(TAG, "onComplete");
    }


    protected abstract void onHandleSuccess(T t);

    protected void onHandleError(String msg) {
        Toast.makeText(mContext, msg, Toast.LENGTH_SHORT).show();
    }
}

7评矩、調用

private void login(String userId, String password) {
    Observable<BaseEntity<UserInfo>> observable = RetrofitFactory.getInstance().login(userId, password);
    observable.compose(RxSchedulers.compose()).subscribe(new BaseObserver<UserInfo>(context) {
         @Override
          protected void onHandleSuccess(UserInfo userInfo) {
               // 保存用戶信息等操作
          }
    });
}

RxJava生命周期管理

可以用RxLifecycle來管理RxJava的生命周期
RxLifecycle:https://github.com/trello/RxLifecycle/tree/2.x

小結

重構之后發(fā)現(xiàn)Retrofit搭配RxJava之后更卒,絕對是最好用的網(wǎng)絡請求庫,沒有之一
如有問題稚照,歡迎留言指正

Demo地址:https://github.com/jaycee88/RxJavaRetrofitDemo

參考文章:http://www.reibang.com/p/1fb294ec7e3b
http://blog.csdn.net/gesanri/article/details/52701651

最后

向大家推薦《進階全棧工程師之路》
https://xiaozhuanlan.com/fullstack?rel=4605162920

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末蹂空,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子果录,更是在濱河造成了極大的恐慌上枕,老刑警劉巖,帶你破解...
    沈念sama閱讀 216,997評論 6 502
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件弱恒,死亡現(xiàn)場離奇詭異辨萍,居然都是意外死亡,警方通過查閱死者的電腦和手機返弹,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,603評論 3 392
  • 文/潘曉璐 我一進店門锈玉,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人义起,你說我怎么就攤上這事拉背。” “怎么了默终?”我有些...
    開封第一講書人閱讀 163,359評論 0 353
  • 文/不壞的土叔 我叫張陵椅棺,是天一觀的道長。 經(jīng)常有香客問我齐蔽,道長两疚,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,309評論 1 292
  • 正文 為了忘掉前任含滴,我火速辦了婚禮诱渤,結果婚禮上,老公的妹妹穿的比我還像新娘谈况。我一直安慰自己勺美,他們只是感情好鞋吉,可當我...
    茶點故事閱讀 67,346評論 6 390
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著励烦,像睡著了一般谓着。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上坛掠,一...
    開封第一講書人閱讀 51,258評論 1 300
  • 那天赊锚,我揣著相機與錄音,去河邊找鬼屉栓。 笑死舷蒲,一個胖子當著我的面吹牛,可吹牛的內容都是我干的友多。 我是一名探鬼主播牲平,決...
    沈念sama閱讀 40,122評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼域滥!你這毒婦竟也來了纵柿?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 38,970評論 0 275
  • 序言:老撾萬榮一對情侶失蹤启绰,失蹤者是張志新(化名)和其女友劉穎昂儒,沒想到半個月后,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體委可,經(jīng)...
    沈念sama閱讀 45,403評論 1 313
  • 正文 獨居荒郊野嶺守林人離奇死亡渊跋,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 37,596評論 3 334
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了着倾。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片拾酝。...
    茶點故事閱讀 39,769評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖卡者,靈堂內的尸體忽然破棺而出蒿囤,到底是詐尸還是另有隱情,我是刑警寧澤虎眨,帶...
    沈念sama閱讀 35,464評論 5 344
  • 正文 年R本政府宣布蟋软,位于F島的核電站镶摘,受9級特大地震影響嗽桩,放射性物質發(fā)生泄漏。R本人自食惡果不足惜凄敢,卻給世界環(huán)境...
    茶點故事閱讀 41,075評論 3 327
  • 文/蒙蒙 一碌冶、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧涝缝,春花似錦扑庞、人聲如沸譬重。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,705評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽臀规。三九已至,卻和暖如春栅隐,著一層夾襖步出監(jiān)牢的瞬間塔嬉,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 32,848評論 1 269
  • 我被黑心中介騙來泰國打工租悄, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留谨究,地道東北人。 一個月前我還...
    沈念sama閱讀 47,831評論 2 370
  • 正文 我出身青樓泣棋,卻偏偏與公主長得像胶哲,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子潭辈,可洞房花燭夜當晚...
    茶點故事閱讀 44,678評論 2 354

推薦閱讀更多精彩內容