一、Rxjava环境配置
使用android studio，gradle脚本中加入依赖：
compile 'io.reactivex.rxjava2:rxandroid:2.0.1'
compile 'io.reactivex.rxjava2:rxjava:2.1.5'
二、示例
Rxjava基本示例
Observable.just("one", "two", "three", "four", "five")
.subscribeOn(Schedulers.newThread())
.observeOn(AndroidSchedulers.mainThread())
.subscribe(/* an Observer */);
Looper backgroundLooper = // ...
Observable.just("one", "two", "three", "four", "five")
.observeOn(AndroidSchedulers.from(backgroundLooper))
.subscribe(/* an Observer */)
Rxjava进阶使用示例
rxjava实现缓存机制
@Override
public Observable> getDatas() {
if (mCachedTests != null && !mCachedTests.isEmpty() && !mCacheIsDirty) {
Log.i(TAG,"mCachedTests dataget");
return Observable.fromIterable(mCachedTests.values()).toList().toObservable();
} else if (mCachedTests == null) {
mCachedTests = new LinkedHashMap<>();
}
Observable> remoteTests = loadTestRemoteDataSource();
if (mCacheIsDirty) {
return remoteTests;
} else {
// Query the local storage if available. If not, query the network.
Observable>localTests = loadTestsLocalDataSource();
return Observable.concat(localTests, remoteTests)
.firstElement().toObservable();
}
}
private Observable> loadTestRemoteDataSource(){
return mTestRemoteDataSource.getDatas()
.filter(testList -> !testList.isEmpty())
.flatMap(new Function, ObservableSource>>() {
@Override
public ObservableSource> apply(@io.reactivex.annotations.NonNull List testList) throws Exception {
mCachedTests.clear();
return Observable.fromIterable(testList).doOnNext(test -> mCachedTests.put(test.getId(),test)).toList().toObservable();
}
})
.doOnNext(mCachedTests->{
mTestLocalDataSource.refreshData();
mTestLocalDataSource.saveDatas(mCachedTests);
})
.doOnComplete(()-> mCacheIsDirty=false);
}
private Observable> loadTestsLocalDataSource(){
return mTestLocalDataSource.getDatas()
.firstElement()//problem : https://github.com/square/sqlbrite/issues/123
.toObservable()
.filter(testList -> !testList.isEmpty())
.flatMap(new Function, ObservableSource>>() {
@Override
public ObservableSource> apply(@io.reactivex.annotations.NonNull List testList) throws Exception {
mCachedTests.clear();
return Observable.fromIterable(testList).doOnNext(test -> mCachedTests.put(test.getId(),test)).toList().toObservable();
}
})
.doOnNext(testList->Log.i(TAG,"mTestLocalDataSource doOnNext"))
.doOnComplete(()->Log.i(TAG,"mTestLocalDataSource doOnComplete"));
}
rxjava封装网络请求
public class RxjavaHttp {
/**
* 设置context
* @param context 暂时不能使用ApplicationContext,可以为空
* @return 当前operator
*/
public static Operator with(@Nullable Context context){
Operator operator = new Operator();
return operator.with(context);
}
public static class Operator{
private Operator operator;
private boolean willchecknet = true;
private boolean willcheckresult = true;
public Operator(){
this.operator = this;
}
private WeakReference contextWeakReference;
/**
* 设置context
* @param context 暂时不能使用ApplicationContext
* @return 当前operator
*/
public Operator with(Context context){
if (context == null) {
throw new IllegalArgumentException("You cannot start a load on a null Context");
} else if (context instanceof Application) {
throw new IllegalArgumentException("You cannot use a context instanceof Application");
} else {
contextWeakReference = new WeakReference(context);
}
return operator;
}
/**
* 请求前是否检查网络，默认值true，没有网络时将抛出NetworkErrorException(message)
* @param willchecknet 是否检查网络
* @return 当前operator
*/
public Operator willchecknetfirst(boolean willchecknet){
this.willchecknet = willchecknet;
return operator;
}
/**
* 请求完成是否检查结果，默认值true，接口没有正常返回结果时将抛出NetworkErrorException(message)
* @param willcheckresult 是否检查结果
* @return 当前operator
*/
public Operator willcheckresult(boolean willcheckresult){
this.willcheckresult = willcheckresult;
return operator;
}
/*****************************************************************************************************
*
* 以下方法为请求的调用，返回数据源用作后续操作，没有对线程进行调度，用作http和其他数据源结合使用时或需要获取原始数据源时。
*
*****************************************************************************************************/
/**
* 获得一个http请求Observable
* @param bean 请求参数
* @param httpRequest 请求体
* @param 请求体泛型
* @return http请求数据源
*/
public Observableexcute(T bean, Function> httpRequest){
return Observable.just(bean).filter(new CheckNetPredicate(contextWeakReference.get(),willchecknet))
.flatMap(httpRequest).filter(new HttpResultPredicate(willcheckresult));
}
/**
* 获得一个get请求的Observable
* @param url 请求地址
* @return get请求数据源
*/
public Observable get(String url){
return excute(url, new Function>() {
@Override
public ObservableSource apply(String url) throws Exception {
return Observable.just(HttpFactory.get(url)).subscribeOn(Schedulers.io());
}
});
}
/**
* 获得一个post请求的Observable
* @param rxjavaHttpBean 请求体
* @param RxjavaHttpBean的子类
* @return post请求数据源
*/
public Observable post(T rxjavaHttpBean){
return excute(rxjavaHttpBean, new Function>() {
@Override
public ObservableSource apply(T rxjavaHttpBean) throws Exception {
return Observable.just(HttpFactory.post(rxjavaHttpBean.getUrl(),rxjavaHttpBean.getParams(),rxjavaHttpBean.getHeaders())).subscribeOn(Schedulers.io());
}
});
}
/**
* 获得一个upload请求的Observable
* @param rxjavaHttpBean 请求体
* @param RxjavaHttpBean的子类
* @return upload请求数据源
*/
public Observable upload(T rxjavaHttpBean){
return excute(rxjavaHttpBean, new Function>() {
@Override
public ObservableSource apply(T rxjavaHttpBean) throws Exception {
return Observable.just(HttpFactory.formUpload(rxjavaHttpBean.getUrl(),rxjavaHttpBean.getFiles(),rxjavaHttpBean.getParams())).subscribeOn(Schedulers.io());
}
});
}
/*****************************************************************************************************
*
* 以下方法为简单的调用，直接传入Consumer，io线程请求，ui线程返回结果，并根据错误进行toast弹出。
*
*****************************************************************************************************/
/**
* 直接执行http请求，io线程请求，ui线程返回结果，并根据错误进行toast弹出
* @param bean 请求参数
* @param httpRequest 请求体
* @param consumer 订阅者
* @param 请求体泛型
* @return 返回Disposable用作生命周期控制
*/
public Disposable simpleExcute(T bean, Function> httpRequest, Consumerconsumer){
return Observable.just(bean).filter(new CheckNetPredicate(contextWeakReference.get(),willchecknet))
.flatMap(httpRequest).filter(new HttpResultPredicate(willcheckresult))
.subscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread())
.onErrorReturn(new HttpToastErrorReturn(contextWeakReference.get()))
.subscribe(consumer);
}
/**
* 直接执行get请求，io线程请求，ui线程返回结果，并根据错误进行toast弹出
* @param url 请求地址
* @param consumer 订阅者
* @return 返回Disposable用作生命周期控制
*/
public Disposable simpleGet(String url, Consumerconsumer){
return simpleExcute(url, new Function>() {
@Override
public ObservableSource apply(String url) throws Exception {
return Observable.just(HttpFactory.get(url)).subscribeOn(Schedulers.io());
}
},consumer);
}
/**
* 直接执行post请求，io线程请求，ui线程返回结果，并根据错误进行toast弹出
* @param rxjavaHttpBean 请求内容
* @param consumer 订阅者
* @return 返回Disposable用作生命周期控制
*/
public Disposable simplePost(T rxjavaHttpBean, Consumerconsumer){
return simpleExcute(rxjavaHttpBean, new Function>() {
@Override
public ObservableSource apply(T rxjavaHttpBean) throws Exception {
return Observable.just(HttpFactory.post(rxjavaHttpBean.getUrl(),rxjavaHttpBean.getParams(),rxjavaHttpBean.getHeaders())).subscribeOn(Schedulers.io());
}
},consumer);
}
/**
* 直接执行upload请求，io线程请求，ui线程返回结果，并根据错误进行toast弹出
* @param rxjavaHttpBean 请求内容
* @param consumer 订阅者
* @return 返回Disposable用作生命周期控制
*/
public Disposable simpleUpload(T rxjavaHttpBean, Consumerconsumer){
return simpleExcute(rxjavaHttpBean, new Function>() {
@Override
public ObservableSource apply(T rxjavaHttpBean) throws Exception {
return Observable.just(HttpFactory.formUpload(rxjavaHttpBean.getUrl(),rxjavaHttpBean.getParams(),rxjavaHttpBean.getFiles())).subscribeOn(Schedulers.io());
}
},consumer);
}
}
}
三、Rxjava操作符详解
Creating Observables
Operators that originate new Observables.
Create — create an Observable from scratch by calling observer methods programmatically
Defer — do not create the Observable until the observer subscribes, and create a fresh Observable for each observer
Empty Never Throw — create Observables that have very precise and limited behavior
From — convert some other object or data structure into an Observable
Interval — create an Observable that emits a sequence of integers spaced by a particular time interval
Just — convert an object or a set of objects into an Observable that emits that or those objects
Range — create an Observable that emits a range of sequential integers
Repeat — create an Observable that emits a particular item or sequence of items repeatedly
Start — create an Observable that emits the return value of a function
Timer — create an Observable that emits a single item after a given delay
Transforming Observables
Operators that transform items that are emitted by an Observable.
Buffer — periodically gather items from an Observable into bundles and emit these bundles rather than emitting the items one at a time
FlatMap — transform the items emitted by an Observable into Observables, then flatten the emissions from those into a single Observable
GroupBy — divide an Observable into a set of Observables that each emit a different group of items from the original Observable, organized by key
Map — transform the items emitted by an Observable by applying a function to each item
Scan — apply a function to each item emitted by an Observable, sequentially, and emit each successive value
Window — periodically subdivide items from an Observable into Observable windows and emit these windows rather than emitting the items one at a time
Filtering Observables
Operators that selectively emit items from a source Observable.
Debounce — only emit an item from an Observable if a particular timespan has passed without it emitting another item
Distinct — suppress duplicate items emitted by an Observable
ElementAt — emit only item n emitted by an Observable
Filter — emit only those items from an Observable that pass a predicate test
First — emit only the first item, or the first item that meets a condition, from an Observable
IgnoreElements — do not emit any items from an Observable but mirror its termination notification
Last — emit only the last item emitted by an Observable
Sample — emit the most recent item emitted by an Observable within periodic time intervals
Skip — suppress the first n items emitted by an Observable
SkipLast — suppress the last n items emitted by an Observable
Take — emit only the first n items emitted by an Observable
TakeLast — emit only the last n items emitted by an Observable
Combining Observables
Operators that work with multiple source Observables to create a single Observable
And Then When — combine sets of items emitted by two or more Observables by means of Pattern
and Plan
intermediaries
CombineLatest — when an item is emitted by either of two Observables, combine the latest item emitted by each Observable via a specified function and emit items based on the results of this function
Join — combine items emitted by two Observables whenever an item from one Observable is emitted during a time window defined according to an item emitted by the other Observable
Merge — combine multiple Observables into one by merging their emissions
StartWith — emit a specified sequence of items before beginning to emit the items from the source Observable
Switch — convert an Observable that emits Observables into a single Observable that emits the items emitted by the most-recently-emitted of those Observables
Zip — combine the emissions of multiple Observables together via a specified function and emit single items for each combination based on the results of this function
Error Handling Operators
Operators that help to recover from error notifications from an Observable
Catch — recover from an onError
notification by continuing the sequence without error
Retry — if a source Observable sends an onError
notification, resubscribe to it in the hopes that it will complete without error
Observable Utility Operators
A toolbox of useful Operators for working with Observables
Delay — shift the emissions from an Observable forward in time by a particular amount
Do — register an action to take upon a variety of Observable lifecycle events
Materialize Dematerialize — represent both the items emitted and the notifications sent as emitted items, or reverse this process
ObserveOn — specify the scheduler on which an observer will observe this Observable
Serialize — force an Observable to make serialized calls and to be well-behaved
Subscribe — operate upon the emissions and notifications from an Observable
SubscribeOn — specify the scheduler an Observable should use when it is subscribed to
TimeInterval — convert an Observable that emits items into one that emits indications of the amount of time elapsed between those emissions
Timeout — mirror the source Observable, but issue an error notification if a particular period of time elapses without any emitted items
Timestamp — attach a timestamp to each item emitted by an Observable
Using — create a disposable resource that has the same lifespan as the Observable
Conditional and Boolean Operators
Operators that evaluate one or more Observables or items emitted by Observables
All — determine whether all items emitted by an Observable meet some criteria
Amb — given two or more source Observables, emit all of the items from only the first of these Observables to emit an item
Contains — determine whether an Observable emits a particular item or not
DefaultIfEmpty — emit items from the source Observable, or a default item if the source Observable emits nothing
SequenceEqual — determine whether two Observables emit the same sequence of items
SkipUntil — discard items emitted by an Observable until a second Observable emits an item
SkipWhile — discard items emitted by an Observable until a specified condition becomes false
TakeUntil — discard items emitted by an Observable after a second Observable emits an item or terminates
TakeWhile — discard items emitted by an Observable after a specified condition becomes false
Mathematical and Aggregate Operators
Operators that operate on the entire sequence of items emitted by an Observable
Average — calculates the average of numbers emitted by an Observable and emits this average
Concat — emit the emissions from two or more Observables without interleaving them
Count — count the number of items emitted by the source Observable and emit only this value
Max — determine, and emit, the maximum-valued item emitted by an Observable
Min — determine, and emit, the minimum-valued item emitted by an Observable
Reduce — apply a function to each item emitted by an Observable, sequentially, and emit the final value
Sum — calculate the sum of numbers emitted by an Observable and emit this sum
Backpressure Operators
backpressure operators — strategies for coping with Observables that produce items more rapidly than their observers consume them
Connectable Observable Operators
Specialty Observables that have more precisely-controlled subscription dynamics
Connect — instruct a connectable Observable to begin emitting items to its subscribers
Publish — convert an ordinary Observable into a connectable Observable
RefCount — make a Connectable Observable behave like an ordinary Observable
Replay — ensure that all observers see the same sequence of emitted items, even if they subscribe after the Observable has begun emitting items
Operators to Convert Observables
To — convert an Observable into another object or data structure