Object RxUtils

  • All Implemented Interfaces:

    
    public class RxUtils
    
                        
    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
    • Field Summary

      Fields 
      Modifier and Type Field Description
      private final Observable<Object> empty
      public final static RxUtils INSTANCE
    • Constructor Summary

      Constructors 
      Constructor Description
    • Enum Constant Summary

      Enum Constants 
      Enum Constant Description
    • Method Summary

      Modifier and Type Method Description
      final static <T extends Any> Observable<T> onBackpressureBuffer(Observable<T> $self) Instructs an Observable that is emitting items faster than its observer can consume them to buffer these items indefinitely until they can be emitted.
      final static <T extends Any> Subscription subscribe(Observable<T> $self, Subscriber<in T> subscriber) Subscribe to the Observable
      final static <T extends Any> Subscription subscribe(Observable<T> $self, Function1<T, Unit> onNext) Subscribe to the Observable.
      final static <T extends Any> Pair<T, Throwable> await(Observable<T> $self) Blocks the current thread and waits for the Observable to complete, then returns a Pair containing the result, and the error (if any) This must not be called from the Main thread (and will throw an IllegalStateException if done so) as that would freeze the UI
      final static <T extends Any> Subscriber<T> createActionSubscriber(Action1<in T> onNext, Action1<Throwable> onError, Action0 onCompleted) Creates a subscriber that forwards the onXXX method calls to callbacks.
      final static <T extends Any> Subscriber<T> createActionSubscriber(Action1<in T> onNext, Action1<Throwable> onError) Creates a subscriber that forwards the onXXX method calls to callbacks.
      final static <T extends Any> Subscriber<T> createActionSubscriber(Action1<in T> onNext) Creates a subscriber that forwards the onXXX method calls to callbacks.
      final static Observable<Long> timer(Long delay, TimeUnit unit) Returns an Observable that emits 0L after a specified delay, and then completes.
      final static Subscription schedule(Long delay, TimeUnit unit, Function1<Long, Unit> callback) Runs the callback after the specified delay
      final static <T extends Any, R extends Any> Observable<R> combineLatest(List<Observable<T>> sources, FuncN<R> combineFunction) Combines a list of source Observables by emitting an item that aggregates the latest values of each of the source Observables each time an item is received from any of the source Observables, where this aggregation is defined by a specified function.
      final static <T extends Any, R extends Any> Observable<R> map(Observable<T> $self, Function1<T, R> func) Returns an Observable that applies a specified function to each item emitted by the source Observable and emits the results of these function applications.
      final static <T extends Any, R extends Any> Observable<R> switchMap(Observable<T> $self, Function1<T, Observable<R>> func) Returns a new Observable by applying a function that you supply to each item emitted by the source Observable that returns an Observable, and then emitting the items emitted by the most recently emitted of these Observables.
      final static <T extends Any> Observable<T> create(Function1<Subscriber<in T>, Unit> onSubscribe) Creates a new cold Observable.
      final Observable<Object> getEmpty()
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

    • Method Detail

      • onBackpressureBuffer

         final static <T extends Any> Observable<T> onBackpressureBuffer(Observable<T> $self)

        Instructs an Observable that is emitting items faster than its observer can consume them to buffer these items indefinitely until they can be emitted.

        preview image

        Backpressure:

        The operator honors backpressure from downstream and consumes the source Observable in an unbounded manner (i.e., not applying backpressure to it).

        Scheduler:

        onBackpressureBuffer does not operate by default on a particular Scheduler.

        Returns:

        the source Observable modified to buffer items to the extent system resources allow

      • subscribe

         final static <T extends Any> Subscription subscribe(Observable<T> $self, Subscriber<in T> subscriber)

        Subscribe to the Observable

        Parameters:
        subscriber - the Subscriber that will handle emissions and notifications from the Observable
        Returns:

        created Subscription

      • subscribe

         final static <T extends Any> Subscription subscribe(Observable<T> $self, Function1<T, Unit> onNext)

        Subscribe to the Observable. This is equivalent to subscribe(createActionSubscriber(onNext))

        Parameters:
        onNext - the callback that will be fired once the Observable emits onNext
        Returns:

        created Subscription

      • await

         final static <T extends Any> Pair<T, Throwable> await(Observable<T> $self)

        Blocks the current thread and waits for the Observable to complete, then returns a Pair containing the result, and the error (if any) This must not be called from the Main thread (and will throw an IllegalStateException if done so) as that would freeze the UI

        Returns:

        A Pair whose first value is the result and whose second value is the error that occurred, if any

      • createActionSubscriber

        @JvmOverloads() final static <T extends Any> Subscriber<T> createActionSubscriber(Action1<in T> onNext, Action1<Throwable> onError, Action0 onCompleted)

        Creates a subscriber that forwards the onXXX method calls to callbacks.

        Parameters:
        onNext - An Observable calls this method whenever the Observable emits an item.
        onError - An Observable calls this method to indicate that it has failed to generate the expected data or has encountered some other error.
        onCompleted - An Observable calls this method after it has called onNext for the final time, if it has not encountered any errors.
        Returns:

        ActionSubscriber instance

      • createActionSubscriber

        @JvmOverloads() final static <T extends Any> Subscriber<T> createActionSubscriber(Action1<in T> onNext, Action1<Throwable> onError)

        Creates a subscriber that forwards the onXXX method calls to callbacks.

        Parameters:
        onNext - An Observable calls this method whenever the Observable emits an item.
        onError - An Observable calls this method to indicate that it has failed to generate the expected data or has encountered some other error.
        Returns:

        ActionSubscriber instance

      • createActionSubscriber

        @JvmOverloads() final static <T extends Any> Subscriber<T> createActionSubscriber(Action1<in T> onNext)

        Creates a subscriber that forwards the onXXX method calls to callbacks.

        Parameters:
        onNext - An Observable calls this method whenever the Observable emits an item.
        Returns:

        ActionSubscriber instance

      • timer

         final static Observable<Long> timer(Long delay, TimeUnit unit)

        Returns an Observable that emits 0L after a specified delay, and then completes.

        Parameters:
        delay - the initial delay before emitting a single 0L
        unit - time units to use for delay
        Returns:

        an Observable that emits one item after a specified delay, and then completes

      • schedule

         final static Subscription schedule(Long delay, TimeUnit unit, Function1<Long, Unit> callback)

        Runs the callback after the specified delay

        Parameters:
        delay - the delay before running the callback
        unit - time unit to use for the delay
        callback - the callback to run after the delay
      • combineLatest

         final static <T extends Any, R extends Any> Observable<R> combineLatest(List<Observable<T>> sources, FuncN<R> combineFunction)

        Combines a list of source Observables by emitting an item that aggregates the latest values of each of the source Observables each time an item is received from any of the source Observables, where this aggregation is defined by a specified function.

        Parameters:
        sources - the list of source Observables
        combineFunction - the aggregation function used to combine the items emitted by the source Observables
        Returns:

        an Observable that emits items that are the result of combining the items emitted by the source Observables by means of the given aggregation function

      • map

         final static <T extends Any, R extends Any> Observable<R> map(Observable<T> $self, Function1<T, R> func)

        Returns an Observable that applies a specified function to each item emitted by the source Observable and emits the results of these function applications.

        Parameters:
        func - a function to apply to each item emitted by the Observable
        Returns:

        an Observable that emits the items from the source Observable, transformed by the specified func

      • switchMap

         final static <T extends Any, R extends Any> Observable<R> switchMap(Observable<T> $self, Function1<T, Observable<R>> func)

        Returns a new Observable by applying a function that you supply to each item emitted by the source Observable that returns an Observable, and then emitting the items emitted by the most recently emitted of these Observables.

        The resulting Observable completes if both the upstream Observable and the last inner Observable, if any, complete. If the upstream Observable signals an onError, the inner Observable is unsubscribed and the error delivered in-sequence.

        Parameters:
        func - a function that, when applied to an item emitted by the source Observable, returns an Observable
        Returns:

        an Observable that emits the items emitted by the Observable returned from applying func to the most recently emitted item emitted by the source Observable

      • create

         final static <T extends Any> Observable<T> create(Function1<Subscriber<in T>, Unit> onSubscribe)

        Creates a new cold Observable. When the observable is subscribed to, onSubscribe is called with the subscriber as a parameter, and should start emitting to the subscriber using Subscriber.onNext.

        onSubscribe should always end with either Subscriber.onError or Subscriber.onCompleted.

        Note that the resulting Observable is not backpressure-aware.

        Parameters:
        onSubscribe - a function that is called when the observable is subscribed to
        Returns:

        a cold Observable