使用RxJava+Retrofit完成同步連續請求

首先聲明一下,這是本人的學習Rxjava和Retrofit的第一篇博客,也是我第一次寫博客,內容中可能會有錯誤的地方或者我理解錯誤的地方,請大家多理解,都是這么過來的嘛,如果有錯誤的地方非常歡迎大家指正,我會及時修改以免誤導他人。

使用場景

連續請求在很多App中都經常會被使用,例如通過定位獲得當前定位城市的天氣預報,我們首先要通過Android為我們提供的Api調用GPS獲得我們當前的經緯度,然后將經緯度轉換成具體的城市名稱,再將城市名稱傳入獲取天氣預報的請求中。

如果要實現這樣一個需求,在代碼結構上可能會是很亂的,我們可能會陷入無盡的回調地獄中,例如這樣:

快的打車

這樣的結構無論對于開發人員還是維護人員都非常容易一臉懵逼,為了解決這個問題,我們可以通過引入Rxjava+Retrofit,使用鏈式的結構,讓整個代碼塊更易讀,也為了讓你離職后接手你的項目的人少罵你幾句。

動手試一下

前期準備

  • 經緯度轉為城市地址Api:由于Google Maps提供的Api在國內無法使用(也可能有更好的方法請指教),我找到了
    http://api.map.baidu.com/geocoder?location=緯度,經度&output=輸出格式類型&key=用戶密鑰這個Api來代替,注意這個Api要提前申請key,本文將提供一個key:6eea93095ae93db2c77be9ac910ff311

  • 天氣預報Api:這里我使用的是心知天氣在百度Api服務中提供的接口,其中我使用了天氣實況這一服務,具體的接口Url為http://apis.baidu.com/thinkpage/weather_api_full/currentweather,注意這里同樣要申請key,此處需要各位自行申請了。

  • Rxjava+Retrofit:通過Gradle導入即可

    compile 'io.reactivex:rxjava:1.1.0'
    compile 'io.reactivex:rxandroid:1.1.0'
    compile 'com.squareup.retrofit2:retrofit:2.0.0-beta4'
    compile 'com.squareup.retrofit2:converter-gson:2.0.0-beta4'
    compile 'com.squareup.retrofit2:adapter-rxjava:2.0.0-beta4'
    compile 'com.google.code.gson:gson:2.6.2'
    compile 'com.jakewharton:butterknife:7.0.1'

可以開始了

首先我們要準備好天氣服務和位置服務返回的實體類,這個實體類就需要麻煩大家自行去請求一下了,這里推薦一個Chrome的小插件Postman(需要翻墻)這個工具可以幫助你進行網頁調試或發送http請求。自動生成實體類應該不用多說了GsonFormat即可搞定。

現在我們有了實體類,接下來我們就要通過Retrofit為每個請求創建相應的Service了:

  • 定位服務:
public interface LocationService {
    @GET("geocoder")
    Observable<LocationEntity> getLoation(
    @Query("location") String location, 
    @Query("output") String output,
    @Query("key") String key
    );
}
  • 天氣服務 請將代碼中的***替換為您申請的apikey
public interface WeatherService {
    @Headers({"apikey:*********"})
    @GET("currentweather")
    Observable<WeatherEntity> getWeather(@Query("location") String city);
}

接下來我們為每個請求實例化相應的Retrofit對象,并加入Rxjava的支持:

public static final String WEATHER_URL = "http://apis.baidu.com/thinkpage/weather_api/";
public static final String LOCATION_URL ="http://api.map.baidu.com/";

Retrofit mRetrofitWeather;
Retrofit mRetrofitLocation;
WeatherService mWeatherService;
LocationService mLocationService;

 @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        mRetrofitWeather = new Retrofit.Builder()
                .addConverterFactory(GsonConverterFactory.create())
                .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
                .baseUrl(WEATHER_URL)
                .build();
        mWeatherService = mRetrofitWeather.create(WeatherService.class);

        mRetrofitLocation = new Retrofit.Builder()
                .addConverterFactory(GsonConverterFactory.create())
                .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
                .baseUrl(LOCATION_URL)
                .build();
        mLocationService = mRetrofitLocation.create(LocationService.class);
  }

下面就是我們的重點了,我們要使用Rxjava為我們提供的十分豐富的操作符來完成這個連續的請求。聲明一下我是在點擊事件中完成的請求

public void getWeather(){
     mLocationService.getLoation("31.407452,119.490523", "json", "6eea93095ae93db2c77be9ac910ff311")
     .flatMap(new Func1<LocationEntity, Observable<WeatherEntity>>() {
           @Override
           public Observable<WeatherEntity> call(LocationEntity locationEntity) {
               return mWeatherService.getWeather(locationEntity.getResult().getAddressComponent().getCity());
           }
     }).map(new Func1<WeatherEntity, String>() {
           @Override
           public String call(WeatherEntity weatherEntity) {
                String text = weatherEntity.getResults().get(0).getLocation().getName() + ":" + weatherEntity.getResults().get(0).getNow().getText()+ " 溫度:" + weatherEntity.getResults().get(0).getNow().getTemperature() + "";
                return text;
          }
     }).subscribeOn(Schedulers.io())
       .observeOn(AndroidSchedulers.mainThread())
       .subscribe(new Subscriber<SpannableString>() {
           @Override
           public void onCompleted() {
                 Log.d(TAG, "onCompleted: " + "完成數據獲取");
           }

           @Override
           public void onError(Throwable e) {
                 tv.setText(e.toString());
            }


            @Override
            public void onNext(String s) {
                  tv.setText(s);
                  Log.d(TAG,"當前天氣為:"+s)
             }   
      });
}

首先我們通過系統的Api拿到我們目前所在位置的經緯度信息,這里我就直接隨意寫了一個,接下來我們就要開始傳入接口所需要的參數進行請求了,第一步我們先要通過經緯度獲得我們所在的城市位置,這里我使用了Map和FlatMap這兩個操作符。

Map
transform the items emitted by an Observable by applying a function to each item

FlatMap
transform the items emitted by an Observable into Observables, then flatten the emissions from those into a single Observable

從文檔中我們可以看出,FlatMap可以將Observable對象發射到一個Observables對象中,然后排列為一個Observable對象,通過該操作符,我們可以將得到的位置信息傳入天氣服務的Api中,將或得到的天氣實體發射到Observables中,之后我們再通過map操作符將天氣的Observable對象通過處理,得到我們所需要的具體信息,即文中的text,之后我們訂閱這個事件,在onNext方法中取得我們所需的信息。

這樣的鏈式結構相對于文中開頭的回調地獄來說,雖說學習成本較高,但是一旦學會使用Rxjava,好處確實是非常多的,最后謝謝大家的閱讀。

項目地址

Github: https://github.com/icetea0822/Rxjava-Retrofit

這個項目本是我學習Rxjava和Retrofit練手用的,所以里面也一些不相關的東西,而且在學習時谷歌剛剛在北京開完開發者大會,試了試Firebase和Google ads請見諒,大家請無視下面的廣告。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容