Android RxLife 一款輕量級別的RxJava生命週期管理庫(二)

不怕天黑發表於2019-04-19

Android RxLife 一款輕量級別的RxJava生命週期管理庫(一)一文中,我們講解了lift,compose這兩個操作符的使用,及RxJava是如何造成記憶體洩漏的,RxLife又是如何解決RxJava記憶體洩漏的。在這不再次進行講解,如果還沒有看的,請回頭閱讀

本文主要講解RxLife在最新版本1.0.4中的as操作符的使用及其作用。

gradle依賴

implementation 'com.rxjava.rxlife:rxlife:1.0.4'
複製程式碼

原始碼下載 歡迎star

看過上篇文章的同學知道,在使用lift,compose這兩個操作符時,我們規定了下游除了subscribe操作符外不能有其它的操作符出現,然後這種規定不是程式碼層面的規定,需要開發者在開發時額外注意,顯然這種方案是不完美的,那麼我們能不能從程式碼層面上去規定呢?此時就要請我們主角出場了!

as操作符

我們先來看看as操作符如何使用。(以下程式碼預設執行在Activity中)

Observable.intervalRange(1, 100, 0, 200, TimeUnit.MILLISECONDS)
        .as(RxLife.as(this)) //this 為LifecycleOwner物件
        .subscribe(aLong -> {
            Log.e("LJX", "accept=" + aLong);
        });
複製程式碼

這樣就可以了?是的,就這麼簡單。那麼as是如何規避下游不會出現除subscribe之外的操作符呢?我們先來看看使用as操作符,返回的啥?

ObservableLife<Long> observableLife = Observable
        .intervalRange(1, 100, 0, 200, TimeUnit.MILLISECONDS)
        .as(RxLife.asOnMain(this));
複製程式碼

返回的是一個ObservableLife物件,這是什麼鬼?進去看看

/**
 * User: ljx
 * Date: 2019/4/18
 * Time: 18:40
 */
public class ObservableLife<T> extends RxSource<Observer<? super T>> {

    private Observable<T> upStream;

    ObservableLife(Observable<T> upStream, LifecycleOwner owner, Event event, boolean onMain) {
        super(owner, event, onMain);
        this.upStream = upStream;
    }

    @Override
    public final Disposable subscribe() {
        return subscribe(Functions.emptyConsumer(), Functions.ON_ERROR_MISSING, Functions.EMPTY_ACTION, Functions.emptyConsumer());
    }

    public final Disposable subscribe(Consumer<? super T> onNext) {
        return subscribe(onNext, Functions.ON_ERROR_MISSING, Functions.EMPTY_ACTION, Functions.emptyConsumer());
    }

    public final Disposable subscribe(Consumer<? super T> onNext, Consumer<? super Throwable> onError) {
        return subscribe(onNext, onError, Functions.EMPTY_ACTION, Functions.emptyConsumer());
    }

    public final Disposable subscribe(Consumer<? super T> onNext, Consumer<? super Throwable> onError,
                                      Action onComplete) {
        return subscribe(onNext, onError, onComplete, Functions.emptyConsumer());
    }

    public final Disposable subscribe(Consumer<? super T> onNext, Consumer<? super Throwable> onError,
                                      Action onComplete, Consumer<? super Disposable> onSubscribe) {
        ObjectHelper.requireNonNull(onNext, "onNext is null");
        ObjectHelper.requireNonNull(onError, "onError is null");
        ObjectHelper.requireNonNull(onComplete, "onComplete is null");
        ObjectHelper.requireNonNull(onSubscribe, "onSubscribe is null");

        LambdaObserver<T> ls = new LambdaObserver<T>(onNext, onError, onComplete, onSubscribe);

        subscribe(ls);

        return ls;
    }


    @Override
    public final void subscribe(Observer<? super T> observer) {
        ObjectHelper.requireNonNull(observer, "observer is null");
        try {
            observer = RxJavaPlugins.onSubscribe(upStream, observer);

            ObjectHelper.requireNonNull(observer, "The RxJavaPlugins.onSubscribe hook returned a null Observer. Please change the handler provided to RxJavaPlugins.setOnObservableSubscribe for invalid null returns. Further reading: https://github.com/ReactiveX/RxJava/wiki/Plugins");

            subscribeActual(observer);
        } catch (NullPointerException e) { // NOPMD
            throw e;
        } catch (Throwable e) {
            Exceptions.throwIfFatal(e);
            // can't call onError because no way to know if a Disposable has been set or not
            // can't call onSubscribe because the call might have set a Subscription already
            RxJavaPlugins.onError(e);

            NullPointerException npe = new NullPointerException("Actually not, but can't throw other exceptions due to RS");
            npe.initCause(e);
            throw npe;
        }
    }

    private void subscribeActual(Observer<? super T> observer) {
        Observable<T> upStream = this.upStream;
        if (onMain) {
            upStream = upStream.observeOn(AndroidSchedulers.mainThread());
        }
        upStream.onTerminateDetach().subscribe(new LifeObserver<>(observer, owner, event));
    }
}
複製程式碼

仔細的你會發現,ObservableLife類裡面就只有一系列的subscribe方法,而且跟Observable裡面的subscribe方法是一一對應的,功能也是一樣的。到這,我們就明白了,原來as操作符返回的是一個自定義的物件,而且該物件只提供了一系列subscribe方法,這樣就規避了下游不會再出現其它的操作符,就避免記憶體洩漏等危險。

到這,as操作符的原理我們就講清楚了,我們再來看看as操作符的其它用法。

指定生命週期關閉管道

Observable.intervalRange(1, 100, 0, 200, TimeUnit.MILLISECONDS)
        //指定在onStop關閉管道,也可以指定其它生命週期,不指定預設在onDestroy關閉管道
        .as(RxLife.as(this, Event.ON_STOP)) 
        .subscribe(aLong -> {
            Log.e("LJX", "accept=" + aLong + " Thread=" + Thread.currentThread());
        });
複製程式碼

指定觀察者在主執行緒回撥

Observable.intervalRange(1, 100, 0, 200, TimeUnit.MILLISECONDS)
        .as(RxLife.asOnMain(this)) //asOnMain即代表在主執行緒回撥
        .subscribe(aLong -> {
            Log.e("LJX", "accept=" + aLong + " Thread=" + Thread.currentThread());
        });
        
        //等價於
Observable.intervalRange(1, 100, 0, 200, TimeUnit.MILLISECONDS)
        .observeOn(AndroidSchedulers.mainThread())
        .as(RxLife.as(this))
        .subscribe(aLong -> {
            Log.e("LJX", "accept=" + aLong + " Thread=" + Thread.currentThread());
        });
複製程式碼

同時指定執行緒回撥及生命週期

Observable.intervalRange(1, 100, 0, 200, TimeUnit.MILLISECONDS)
        //在主執行緒回撥,並指定在onStop關閉管道,也可以指定其它生命週期,不指定預設在onDestroy關閉管道
        .as(RxLife.asOnMain(this, Event.ON_STOP)) 
        .subscribe(aLong -> {
            Log.e("LJX", "accept=" + aLong + " Thread=" + Thread.currentThread());
        });
        //等價於
Observable.intervalRange(1, 100, 0, 200, TimeUnit.MILLISECONDS)
        .observeOn(AndroidSchedulers.mainThread())
        .as(RxLife.as(this, Event.ON_STOP))
        .subscribe(aLong -> {
            Log.e("LJX", "accept=" + aLong + " Thread=" + Thread.currentThread());
        });
複製程式碼

ok,as操作符用法就這麼多,如果有更好的idea,請告訴我。

小彩蛋

RxLife類裡面的as系列方法,皆適用於Observable、Flowable、ParallelFlowable、Single、Maybe、Completable這6個被觀察者物件,道理都一樣,這裡不在一一講解。

有疑問,請留言,我會在第一時間作答。

擴充套件

RxLife結合HttpSender傳送請求,簡直不要太爽。

HttpSender詳情請點選HttpSender OkHttp+RxJava超好用、功能超級強大的Http請求框架

相關文章