hu.akarnokd.rxjava.interop

Class RxJavaInterop

java.lang.Object

hu.akarnokd.rxjava.interop.RxJavaInterop

public final class RxJavaInterop
extends java.lang.Object

Conversion methods for converting between 1.x and 2.x reactive types, composing backpressure and cancellation through.

Method Summary

Modifier and Type	Method and Description
static rx.Completable	toV1Completable(io.reactivex.CompletableSource source) Converts an 2.x CompletableSource (the base type of 2.x Completable) into a 1.x Completable, composing cancellation (unsubscription) through.
static <T> rx.Completable	toV1Completable(io.reactivex.MaybeSource<T> source) Converts an 2.x MaybeSource (the base type of 2.x Maybe) into a 1.x Completable, composing cancellation (unsubscription) through and ignoring the success value.
static <T> rx.Observable<T>	toV1Observable(io.reactivex.ObservableSource<T> source, io.reactivex.BackpressureStrategy strategy) Converts a 2.x ObservableSource (the base type of 2.x Observable) into an 1.x Observable instance, applying the specified backpressure strategy and composing the cancellation (unsubscription) through.
static <T> rx.Observable<T>	toV1Observable(org.reactivestreams.Publisher<T> source) Converts a Reactive-Streams Publisher of any kind (the base type of 2.x Flowable) into an 1.x Observable, composing the backpressure and cancellation (unsubscription) through.
static <T> rx.Single<T>	toV1Single(io.reactivex.MaybeSource<T> source) Converts an 2.x MaybeSource (the base type of 2.x Maybe) into a 1.x Single, composing cancellation (unsubscription) through and signalling NoSuchElementException if the MaybeSource is empty.
static <T> rx.Single<T>	toV1Single(io.reactivex.SingleSource<T> source) Converts an 2.x SingleSource (the base type of 2.x Single) into a 1.x Single, composing cancellation (unsubscription) through.
static io.reactivex.Completable	toV2Completable(rx.Completable source) Converts an 1.x Completable into a 2.x Completable, composing cancellation (unsubscription) through.
static <T> io.reactivex.Flowable<T>	toV2Flowable(rx.Observable<T> source) Converts an 1.x Observable into a 2.x Flowable, composing the backpressure and cancellation (unsubscription) through.
static <T> io.reactivex.Maybe<T>	toV2Maybe(rx.Completable source) Converts an 1.x Completable into a 2.x Maybe, composing cancellation (unsubscription) through.
static <T> io.reactivex.Maybe<T>	toV2Maybe(rx.Single<T> source) Converts an 1.x Single into a 2.x Maybe, composing cancellation (unsubscription) through.
static <T> io.reactivex.Observable<T>	toV2Observable(rx.Observable<T> source) Converts an 1.x Observable into a 2.x Observable, cancellation (unsubscription) through.
static <T> io.reactivex.Single<T>	toV2Single(rx.Single<T> source) Converts an 1.x Single into a 2.x Single, composing cancellation (unsubscription) through.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

toV2Flowable

public static <T> io.reactivex.Flowable<T> toV2Flowable(rx.Observable<T> source)

Converts an 1.x Observable into a 2.x Flowable, composing the backpressure and cancellation (unsubscription) through.

Note that in 1.x Observable's backpressure somewhat optional; you may need to apply one of the onBackpressureXXX operators on the source Observable or the resulting Flowable.

Backpressure:

The operator doesn't interfere with backpressure which is determined by the source 1.x Observable's backpressure behavior.

Scheduler:

The method does not operate by default on a particular Scheduler.

Type Parameters:

T - the value type

Parameters:

source - the source 1.x Observable instance, not null

Returns:

the new 2.x Flowable instance

Throws:

java.lang.NullPointerException - if source is null

toV2Observable

public static <T> io.reactivex.Observable<T> toV2Observable(rx.Observable<T> source)

Converts an 1.x Observable into a 2.x Observable, cancellation (unsubscription) through.

Backpressure:

The operator consumes the source 1.x Observable in an unbounded manner (without applying backpressure).

Scheduler:

The method does not operate by default on a particular Scheduler.

Type Parameters:

T - the value type

Parameters:

source - the source 1.x Observable instance, not null

Returns:

the new 2.x Observable instance

Throws:

java.lang.NullPointerException - if source is null

toV2Maybe

public static <T> io.reactivex.Maybe<T> toV2Maybe(rx.Completable source)

Converts an 1.x Completable into a 2.x Maybe, composing cancellation (unsubscription) through.

Scheduler:

The method does not operate by default on a particular Scheduler.

Type Parameters:

T - the value type

Parameters:

source - the source 1.x Completable instance, not null

Returns:

the new 2.x Maybe instance

Throws:

java.lang.NullPointerException - if source is null

toV2Maybe

public static <T> io.reactivex.Maybe<T> toV2Maybe(rx.Single<T> source)

Converts an 1.x Single into a 2.x Maybe, composing cancellation (unsubscription) through.

Scheduler:

The method does not operate by default on a particular Scheduler.

Type Parameters:

T - the value type

Parameters:

source - the source 1.x Single instance, not null

Returns:

the new 2.x Maybe instance

Throws:

java.lang.NullPointerException - if source is null

toV2Single

public static <T> io.reactivex.Single<T> toV2Single(rx.Single<T> source)

Converts an 1.x Single into a 2.x Single, composing cancellation (unsubscription) through.

Scheduler:

The method does not operate by default on a particular Scheduler.

Type Parameters:

T - the value type

Parameters:

source - the source 1.x Single instance, not null

Returns:

the new 2.x Single instance

Throws:

java.lang.NullPointerException - if source is null

toV2Completable

public static io.reactivex.Completable toV2Completable(rx.Completable source)

Converts an 1.x Completable into a 2.x Completable, composing cancellation (unsubscription) through.

Scheduler:

The method does not operate by default on a particular Scheduler.

Parameters:

source - the source 1.x Completable instance, not null

Returns:

the new 2.x Completable instance

Throws:

java.lang.NullPointerException - if source is null

toV1Observable

public static <T> rx.Observable<T> toV1Observable(org.reactivestreams.Publisher<T> source)

Converts a Reactive-Streams Publisher of any kind (the base type of 2.x Flowable) into an 1.x Observable, composing the backpressure and cancellation (unsubscription) through.

Note that this method can convert any Reactive-Streams compliant source into an 1.x Observable, not just the 2.x Flowable.

Backpressure:

The operator doesn't interfere with backpressure which is determined by the source Publisher's backpressure behavior.

Scheduler:

The method does not operate by default on a particular Scheduler.

Type Parameters:

T - the value type

Parameters:

source - the source Reactive-Streams Publisher instance, not null

Returns:

the new 1.x Observable instance

Throws:

java.lang.NullPointerException - if source is null

toV1Observable

public static <T> rx.Observable<T> toV1Observable(io.reactivex.ObservableSource<T> source,
                                                  io.reactivex.BackpressureStrategy strategy)

Converts a 2.x ObservableSource (the base type of 2.x Observable) into an 1.x Observable instance, applying the specified backpressure strategy and composing the cancellation (unsubscription) through.

Backpressure:

The operator applies the backpressure strategy you specify.

Scheduler:

The method does not operate by default on a particular Scheduler.

Type Parameters:

T - the value type

Parameters:

source - the source ObservableSource instance, not null

strategy - the backpressure strategy to apply: BUFFER, DROP or LATEST.

Returns:

the new 1.x Observable instance

Throws:

java.lang.NullPointerException - if source is null

toV1Single

public static <T> rx.Single<T> toV1Single(io.reactivex.SingleSource<T> source)

Converts an 2.x SingleSource (the base type of 2.x Single) into a 1.x Single, composing cancellation (unsubscription) through.

Scheduler:

The method does not operate by default on a particular Scheduler.

Type Parameters:

T - the value type

Parameters:

source - the source 2.x SingleSource instance, not null

Returns:

the new 1.x Single instance

Throws:

java.lang.NullPointerException - if source is null

toV1Completable

public static rx.Completable toV1Completable(io.reactivex.CompletableSource source)

Converts an 2.x CompletableSource (the base type of 2.x Completable) into a 1.x Completable, composing cancellation (unsubscription) through.

Scheduler:

The method does not operate by default on a particular Scheduler.

Parameters:

source - the source 2.x CompletableSource instance, not null

Returns:

the new 1.x Completable instance

Throws:

java.lang.NullPointerException - if source is null

toV1Single

public static <T> rx.Single<T> toV1Single(io.reactivex.MaybeSource<T> source)

Converts an 2.x MaybeSource (the base type of 2.x Maybe) into a 1.x Single, composing cancellation (unsubscription) through and signalling NoSuchElementException if the MaybeSource is empty.

Scheduler:

The method does not operate by default on a particular Scheduler.

Type Parameters:

T - the source's value type

Parameters:

source - the source 2.x MaybeSource instance, not null

Returns:

the new 1.x Single instance

Throws:

java.lang.NullPointerException - if source is null

toV1Completable

public static <T> rx.Completable toV1Completable(io.reactivex.MaybeSource<T> source)

Converts an 2.x MaybeSource (the base type of 2.x Maybe) into a 1.x Completable, composing cancellation (unsubscription) through and ignoring the success value.

Scheduler:

The method does not operate by default on a particular Scheduler.

Type Parameters:

T - the source's value type

Parameters:

source - the source 2.x MaybeSource instance, not null

Returns:

the new 1.x Completable instance

Throws:

java.lang.NullPointerException - if source is null