官术网_书友最值得收藏!

Single

Single<T> is essentially an Observable<T> that will only emit one item. It works just like an Observable, but it is limited only to operators that make sense for a single emission. It has its own SingleObserver interface as well:

    interface SingleObserver<T> {
void onSubscribe(Disposable d);
void onSuccess(T value);
void onError(Throwable error);
}

The onSuccess() essentially consolidates onNext() and onComplete() into a single event that accepts the one emission. When you call subscribe() against a Single, you provide the lambdas for onSuccess() as well as an optional onError():

    import io.reactivex.Single;

public class Launcher {

public static void main(String[] args) {
Single.just("Hello")
.map(String::length)
.subscribe(System.out::println,
Throwable::printStackTrace
);
}
}

Certain RxJava Observable operators will yield a Single, as we will see in the next chapter. For instance, the first() operator will return a Single since that operator is logically concerned with a single item. However, it accepts a default value as a parameter (which I specified as Nil in the following example) if the Observable comes out empty: 

    import io.reactivex.Observable;

public class Launcher {

public static void main(String[] args) {
Observable<String> source =
Observable.just("Alpha","Beta","Gamma");

source.first("Nil") //returns a Single
.subscribe(System.out::println);
}
}

The output is as follows:

    Alpha

The Single must have one emission, and you should prefer it if you only have one emission to provide. This means that instead of using Observable.just("Alpha"), you should try to use Single.just("Alpha") instead. There are operators on Single that will allow you to turn it into an Observable when needed, such as toObservable().

If there are 0 or 1 emissions, you will want to use Maybe.

主站蜘蛛池模板: 卢龙县| 英德市| 大理市| 札达县| 大悟县| 衡水市| 新绛县| 永济市| 奉节县| 安阳市| 黑山县| 沙坪坝区| 商城县| 东宁县| 梓潼县| 河津市| 义乌市| 兴隆县| 平度市| 临武县| 宜川县| 镇沅| 汤阴县| 凤山县| 佛坪县| 体育| 盐边县| 卓尼县| 建昌县| 岱山县| 新乡县| 宁德市| 休宁县| 临漳县| 阳曲县| 肥西县| 闽清县| 柳林县| 高邑县| 山东| 大足县|