RxJava 的使用入门

一、什么是 Rxjava？
RxJava 是一个响应式编程框架，采用观察者设计模式。所以自然少不了 Observable 和 Subscriber 这两个东东了。
RxJava 是一个开源项目，地址：https://github.com/ReactiveX/RxJava

还有一个RxAndroid，用于 Android 开发，添加了 Android 用的接口。地址：https://github.com/ReactiveX/RxAndroid
二、例子
通过请求openweathermap 的天气查询接口返回天气数据
1、增加编译依赖

1 dependencies {
2     compile fileTree(dir: "libs", include: ["*.jar"])
3     compile "com.android.support:appcompat-v7:22.0.0"
4     compile "io.reactivex:rxjava:1.0.9"
5     compile "io.reactivex:rxandroid:0.24.0"
6     compile "com.squareup.retrofit:retrofit:1.9.0"
7 }


retrofit 是一个 restful 请求客户端。详见：http://square.github.io/retrofit/
2、服务器接口

1 /**
2  * 接口
3  * Created by Hal on 15/4/26.
4  */
5 public class ApiManager {
6
7     private static final String ENDPOINT = "http://api.openweathermap.org/data/2.5";
8
9     /**
10      * 服务接口
11      */
12     private interface ApiManagerService {
13         @GET("/weather")
14         WeatherData getWeather(@Query("q") String place, @Query("units") String units);
15     }
16
17     private static final RestAdapter restAdapter = new RestAdapter.Builder().setEndpoint(ENDPOINT).setLogLevel(RestAdapter.LogLevel.FULL).build();
18
19     private static final ApiManagerService apiManager = restAdapter.create(ApiManagerService.class);
20
21     /**
22      * 将服务接口返回的数据，封装成{@link rx.Observable}
23      * @param city
24      * @return
25      */
26     public static Observable<WeatherData> getWeatherData(final String city) {
27         return Observable.create(new Observable.OnSubscribe<WeatherData>() {
28             @Override
29             public void call(Subscriber<? super WeatherData> subscriber) {
30                 //订阅者回调 onNext 和 onCompleted
31                 subscriber.onNext(apiManager.getWeather(city, "metric"));
32                 subscriber.onCompleted();
33             }
34         }).subscribeOn(Schedulers.io());
35     }
36 }

订阅者的回调有三个方法，onNext，onError，onCompleted
3、接口调用

1   /**
2          * 多个 city 请求
3          * map，flatMap 对 Observable进行变换
4          */
5         Observable.from(CITIES).flatMap(new Func1<String, Observable<WeatherData>>() {
6             @Override
7             public Observable<WeatherData> call(String s) {
8                 return ApiManager.getWeatherData(s);
9             }
10         }).subscribeOn(Schedulers.io())
11                 .observeOn(AndroidSchedulers.mainThread())
12                 .subscribe(/*onNext*/new Action1<WeatherData>() {
13                     @Override
14                     public void call(WeatherData weatherData) {
15                         Log.d(LOG_TAG, weatherData.toString());
16                     }
17                 }, /*onError*/new Action1<Throwable>() {
18                     @Override
19                     public void call(Throwable throwable) {
20
21                     }
22                 });
23
24         /**
25          * 单个 city 请求
26          */
27         ApiManager.getWeatherData(CITIES[0]).subscribeOn(Schedulers.io())
28                 .observeOn(AndroidSchedulers.mainThread())
29                 .subscribe(new Action1<WeatherData>() {
30                     @Override
31                     public void call(WeatherData weatherData) {
32                         Log.d(LOG_TAG, weatherData.toString());
33                         ((TextView) findViewById(R.id.text)).setText(weatherData.toString());
34                     }
35                 }, new Action1<Throwable>() {
36                     @Override
37                     public void call(Throwable throwable) {
38                         Log.e(LOG_TAG, throwable.getMessage(), throwable);
39                     }
40                 });
41
42         /**
43          * Android View 事件处理
44          */
45         ViewObservable.clicks(findViewById(R.id.text), false).subscribe(new Action1<OnClickEvent>() {
46             @Override
47             public void call(OnClickEvent onClickEvent) {
48
49             }
50         });

subscribeOn(Schedulers.io())与observeOn(AndroidSchedulers.mainThread())分别定义了这两个动作的线程。Android UI 更新需要在主线程。
4、retrofit 支持 rxjava 整合

1 /**
2      * 服务接口
3      */
4     private interface ApiManagerService {
5         @GET("/weather")
6         WeatherData getWeather(@Query("q") String place, @Query("units") String units);
7
8         /**
9          * retrofit 支持 rxjava 整合
10          * 这种方法适用于新接口
11          */
12         @GET("/weather")
13         Observable<WeatherData> getWeatherData(@Query("q") String place, @Query("units") String units);
14     }