Rxjava简介
Reactive Extensions for the JVM
a library for composing asynchronous and event-based programs using observable sequences for the Java VM
这里说了Rxjava就是JVM响应式扩展Reactive Extensions
用于使用Java VM的可观察序列编写异步与基于事件的程序库(sdk)。
使用观察者模式,采用链式编程,基于事件的实现异步的库
Rxjava的简单使用
首先创建被观察者(Observable)
Observable navel = Observable.create(new ObservableOnSubscribe() {
@Override
public void subscribe(ObservableEmitter e) throws Exception {
e.onNext("hello,rxjava");
e.onNext("认识一下 Rxjava");
e.onComplete();
}
});
我们这里看下Observable.create的源码:
/**
* Provides an API (via a cold Observable) that bridges the reactive world with the callback-style world.
*
* Example:
*
* Observable.<Event>create(emitter -> {
* Callback listener = new Callback() {
* @Override
* public void onEvent(Event e) {
* emitter.onNext(e);
* if (e.isLast()) {
* emitter.onComplete();
* }
* }
*
* @Override
* public void onFailure(Exception e) {
* emitter.onError(e);
* }
* };
*
* AutoCloseable c = api.someMethod(listener);
*
* emitter.setCancellable(c::close);
*
* });
*
*
*
*
* You should call the ObservableEmitter's onNext, onError and onComplete methods in a serialized fashion. The
* rest of its methods are thread-safe.
*
* - Scheduler:
* - {@code create} does not operate by default on a particular {@link Scheduler}.
*
*
* @param the element type
* @param source the emitter that is called when an Observer subscribes to the returned {@code Observable}
* @return the new Observable instance
* @see ObservableOnSubscribe
* @see ObservableEmitter
* @see Cancellable
*/
@SchedulerSupport(SchedulerSupport.NONE)
public static Observable create(ObservableOnSubscribe source) {
ObjectHelper.requireNonNull(source, "source is null");
return RxJavaPlugins.onAssembly(new ObservableCreate(source));
}
ObservableOnSubscribe
/**
* A functional interface that has a {@code subscribe()} method that receives
* an instance of an {@link ObservableEmitter} instance that allows pushing
* events in a cancellation-safe manner.
*
* @param the value type pushed
*/
public interface ObservableOnSubscribe {
/**
* Called for each Observer that subscribes.
* @param e the safe emitter instance, never null
* @throws Exception on error
*/
void subscribe(ObservableEmitter e) throws Exception;
}
ObservableOnSubscribe只需要实现一个接口subscribe,参数是ObservableEmitter
那我们看下Emitter的接口
/**
* Base interface for emitting signals in a push-fashion in various generator-like source
* operators (create, generate).
*
* @param the value type emitted
*/
public interface Emitter {
/**
* Signal a normal value.
* @param value the value to signal, not null
*/
void onNext(T value);
/**
* Signal a Throwable exception.
* @param error the Throwable to signal, not null
*/
void onError(Throwable error);
/**
* Signal a completion.
*/
void onComplete();
}
Emitter发射器可以看到只有三个接口void onNext(T value)、void onError(Throwable error)、void onComplete()。
onNext方法可以无限调用,Observer(观察者)所有的都能接收到,onError和onComplete是互斥的,Observer(观察者)只能接收到一个,OnComplete可以重复调用,但是Observer(观察者)只会接收一次,而onError不可以重复调用,第二次调用就会报异常。
第二步:创建观察者
Observer reader = new Observer() {
@Override
public void onSubscribe(Disposable d) {
//gengwei 这里说明一下这个Disposable;这个对象就是观察者和被观察者的关系,
//如果观察者Observer不想继续订阅被观察者了,就可以主动取消掉
Log.e("gengwei","onSubscribe");
}
@Override
public void onNext(String value) {
Log.e("gengwei","onNext"+value);
}
@Override
public void onError(Throwable e) {
Log.e("gengwei","onError");
}
@Override
public void onComplete() {
Log.e("gengwei","onComplete");
}
};
观察者通过new创建,可以看到有四个方法需要实现。onNext、onError、onComplete都是跟被观察者发射的方法一一对应的,这里就相当于接收了,这三个很好理解。关于onSubscribe这个方法需要关注下,我代码里备注了。
第三步:创建观察者关系
navel.subscribe(reader);
只需要一行代码搞定。
打log看下输出:
2020-03-19 15:41:32.229 10250-10250/com.example.myapplication E/gengwei: onSubscribe
2020-03-19 15:41:32.230 10250-10250/com.example.myapplication E/gengwei: onNexthello,rxjava
2020-03-19 15:41:32.230 10250-10250/com.example.myapplication E/gengwei: onNext认识一下 Rxjava
2020-03-19 15:41:32.230 10250-10250/com.example.myapplication E/gengwei: onComplete
这就是Rxjava最简单的使用方法
Rxjava的异步和链式编程
前面说过Rxjava是支持异步链式编程;我们先看下链式编程。
我们可以看下Observable
这里列举部分,有兴趣可以去看下源码接口:
/**
* Asynchronously subscribes Observers to this ObservableSource on the specified {@link Scheduler}.
*
*
*
* - Scheduler:
* - You specify which {@link Scheduler} this operator will use
*
*
* @param scheduler
* the {@link Scheduler} to perform subscription actions on
* @return the source ObservableSource modified so that its subscriptions happen on the
* specified {@link Scheduler}
* @see ReactiveX operators documentation: SubscribeOn
* @see RxJava Threading Examples
* @see #observeOn
*/
@SchedulerSupport(SchedulerSupport.CUSTOM)
public final Observable subscribeOn(Scheduler scheduler) {
ObjectHelper.requireNonNull(scheduler, "scheduler is null");
return RxJavaPlugins.onAssembly(new ObservableSubscribeOn(this, scheduler));
}
@SchedulerSupport(SchedulerSupport.NONE)
public static Observable fromArray(T... items) {
ObjectHelper.requireNonNull(items, "items is null");
if (items.length == 0) {
return empty();
} else
if (items.length == 1) {
return just(items[0]);
}
return RxJavaPlugins.onAssembly(new ObservableFromArray(items));
}
/**
* Returns an Observable that emits a single item and then completes.
*
*
*
* To convert any object into an ObservableSource that emits that object, pass that object into the {@code just}
* method.
*
* This is similar to the {@link #fromArray(java.lang.Object[])} method, except that {@code from} will convert
* an {@link Iterable} object into an ObservableSource that emits each of the items in the Iterable, one at a
* time, while the {@code just} method converts an Iterable into an ObservableSource that emits the entire
* Iterable as a single item.
*
* - Scheduler:
* - {@code just} does not operate by default on a particular {@link Scheduler}.
*
*
* @param item
* the item to emit
* @param
* the type of that item
* @return an Observable that emits {@code value} as a single item and then completes
* @see ReactiveX operators documentation: Just
*/
@SchedulerSupport(SchedulerSupport.NONE)
public static Observable just(T item) {
ObjectHelper.requireNonNull(item, "The item is null");
return RxJavaPlugins.onAssembly(new ObservableJust(item));
}
...
这里只是列举几个Rxjava的几个API,但是可以清晰的看到每一个方法都会再返回一个Observable
下边再看一下Rxjava的异步编程是如何实现的,这里就要用到Scheduler(调度器),它是RxJava用来控制线程。
我们把刚刚的demo使用链式异步再写一下:
Observable.create(new ObservableOnSubscribe() {
@Override
public void subscribe(ObservableEmitter e) throws Exception {
e.onNext("hello,rxjava");
//gengwei,这里增加休眠3s
Thread.sleep(3000);
e.onNext("认识一下 Rxjava");
e.onComplete();
}
})
.observeOn(AndroidSchedulers.mainThread()) //回调在mainThread
.subscribeOn(Schedulers.io())//执行在io线程
.subscribe(new Observer() {
@Override
public void onSubscribe(Disposable d) {
//gengwei 这里说明一下这个Disposable;这个对象就是观察者和被观察者的关系,
//如果观察者Observer不想继续订阅被观察者了,就可以主动取消掉
Log.e("gengwei","onSubscribe");
}
@Override
public void onNext(String value) {
Log.e("gengwei","onNext"+value);
}
@Override
public void onError(Throwable e) {
Log.e("gengwei","onError");
}
@Override
public void onComplete() {
Log.e("gengwei","onComplete");
}
});
这里就是RxJava最常用的写法,异步+链式编程,还要再说一下,subscribe的方法重载,subscribe()方法里什么参数也不放是空实现,也就是说连载小说无论出什么连载,读者都不关心,推送过来了也不读,如果读者只关心onNext方法里的内容,可以直接重载subscribe(Consumer spuer T> onNext)这个方法,会减少代码,当然如果是初学者还是建议创建Observer对象。
看下输出
注意看下箭头的打印时间,可以看出这里sleep了3s。
好了RxJava的初学就到这里,下一篇继续RxJava的进阶。