Android】RxJava + Retrofit完成網絡請求

轉載地址;http://www.jianshu.com/p/1fb294ec7e3b

RxJava + Retrofit

前言

本文基於RxJava、Retrofit的使用，若是對RxJava或Retrofit還不瞭解的簡友可以先了解RxJava、Retrofit的用法再來看這篇文章。
在這片文章之前分別單獨介紹過Rxjava以及Retrofit的使用：
Android Retrofit 2.0 的使用
Android RxJava的使用（一）基本用法
（以及後面的幾篇，就不一一列出了）

使用

在瞭解了RxJava和Retrofit分別的用法後，RxJava、Retrofit的搭配使用也就不再話下了。
先看看使用Retrofit完成一次網絡請求是怎樣的

• 單獨使用Retrofit
  1、先寫一個service

  interface MyService {
    @GET("user/login" )
    Call<UserInfo> login(
            @Query("username") String username,
            @Query("password") String password
    );
  }

  2、獲取Call執行網絡請求

        Retrofit retrofit = new Retrofit.Builder()
                .addConverterFactory(GsonConverterFactory.create())
                .baseUrl(BASE_URL)
                .build();
        MyService service = retrofit.create(MyService.class);
  
        Call<UserInfo> call = service.login("1111", "ssss");
        call.enqueue(new Callback<UserInfo>() {
            @Override
            public void onResponse(Call<UserInfo> call, Response<UserInfo> response) {
                //請求成功操作
            }
            @Override
            public void onFailure(Call<UserInfo> call, Throwable t) {
                //請求失敗操作
            }
        });

  以上是Retrofit單獨使用時的做法。那Retrofit與RxJava結合是怎樣使用的？下面就來說說這篇文章的重點。

• RxJava + Retrofit完成網絡請求
  1、添加依賴。前四個分別是RxJava、RxAndroid、Retrofit以及Gson的庫，最後那個纔是新加入的，RxJava + Retrofit的使用需要用到最後那個包。

    compile 'io.reactivex:rxjava:x.y.z'
    compile 'io.reactivex:rxandroid:1.0.1'
    compile 'com.squareup.retrofit2:retrofit:2.0.2'
    compile 'com.squareup.retrofit2:converter-gson:2.0.2'
    compile 'com.squareup.retrofit2:adapter-rxjava:2.0.2'

  注意：最後三個包的版本號必須一樣，這裏用的是2.0.2。
  2、寫一個登錄的service

  interface MyService {
    @GET("user/login" )
    Observable<UserInfo> login(
            @Query("username") String username,
            @Query("password") String password
    );
  }

  相比之前的service，這裏getNews方法的返回值是Observable類型。Observable...是不是覺得很熟悉，這貨不就是之前在RxJava使用到的被監聽者？
  3、使用Observable完成一個網絡請求，登錄成功後保存數據到本地。

        Retrofit retrofit = new Retrofit.Builder()
              .addConverterFactory(GsonConverterFactory.create())
              .addCallAdapterFactory(RxJavaCallAdapterFactory.create())//新的配置
              .baseUrl(BASE_URL)
              .build();
        MyService service = retrofit.create(MyService.class);
  
        service.login(phone, password)               //獲取Observable對象
                .subscribeOn(Schedulers.newThread())//請求在新的線程中執行
                .observeOn(Schedulers.io())         //請求完成後在io線程中執行
                .doOnNext(new Action1<UserInfo>() {
                    @Override
                    public void call(UserInfo userInfo) {
                        saveUserInfo(userInfo);//保存用戶信息到本地
                    }
                })
                .observeOn(AndroidSchedulers.mainThread())//最後在主線程中執行
                .subscribe(new Subscriber<UserInfo>() {
                    @Override
                    public void onCompleted() {
  
                    }
  
                    @Override
                    public void onError(Throwable e) {
                        //請求失敗
                    }
  
                    @Override
                    public void onNext(UserInfo userInfo) {
                        //請求成功
                    }
                });

  RxJava + Retrofit 形式的時候，Retrofit 把請求封裝進 Observable ，在請求結束後調用 onNext() 或在請求失敗後調用 onError()。
  可以看到，調用了service的login方法後得到Observable對象，在新的線程中執行網絡請求，請求成功後切換到io線程執行保存用戶信息的動作，最後再切換到主線程執行請求失敗onError()、請求成功onNext()。整體的邏輯十分清晰都在一條鏈中，就算還有別的要求還可以往裏面添加，絲毫不影響代碼的簡潔。（終於舉了一個有實際意義的例子）

  注意：retrofit的初始化加了一行代碼

  addCallAdapterFactory(RxJavaCallAdapterFactory.create())

• RxJava + Retrofit 進階
  在上面舉到登錄後保存用戶信息的例子，其實在做項目的時候，往往在登錄後得到的並不是用戶信息。一般登錄後會得到token，然後根據token去獲取用戶的信息。他們的步驟是這樣的：
  1、登錄
  2、獲取用戶信息（前提：登錄成功）
  可以看得出來，這是一個嵌套的結構...嵌套啊！！！天吶，最怕嵌套的結構了。
  使用RxJava + Retrofit來完成這樣的請求（借用拋物線的例子，稍微做了點改動）

  //登錄，獲取token
  @GET("/login")
  public Observable<String> login(   
    @Query("username") String username,
    @Query("password") String password);
  //根據token獲取用戶信息
  @GET("/user")
  public Observable<User> getUser(
    @Query("token") String token);
  //..................................
  login("11111", "22222")
    .flatMap(new Func1<String, Observable<User>>() {  //得到token後獲取用戶信息
        @Override
        public Observable<User> onNext(String token) {
            return getUser(token);
        })
    .subscribeOn(Schedulers.newThread())//請求在新的線程中執行請求
    .observeOn(Schedulers.io())         //請求完成後在io線程中執行
    .doOnNext(new Action1<User>() {      //保存用戶信息到本地
         @Override
         public void call(User userInfo) {
             saveUserInfo(userInfo);
         }
     })
    .observeOn(AndroidSchedulers.mainThread())//在主線程中執行
    .subscribe(new Observer<User>() {
        @Override
        public void onNext(User user) {
            //完成一次完整的登錄請求
            userView.setUser(user);
        }
  
        @Override
        public void onCompleted() {
  
        }
  
        @Override
        public void onError(Throwable error) {
            //請求失敗
        }
    });

  通過一個flatMap()輕鬆完成一次嵌套的請求，而且邏輯十分清晰。so easy～～～

小結

RxJava的實用性從上面的兩個例子慢慢體現了出來，邏輯越是複雜，RxJava的優勢就越明顯。RxJava的使用就暫時介紹到這裏吧，使用過程中遇到好用的再出來跟大家分享。

以上有錯誤之處感謝指出

參考：給 Android 開發者的 RxJava 詳解
（本文部分內容引用自該博客）

文／帶心情去旅行（簡書作者）
原文鏈接：http://www.jianshu.com/p/1fb294ec7e3b
著作權歸作者所有，轉載請聯繫作者獲得授權，並標註“簡書作者”。