Observable

Abstract Value Members

abstract def subscribeFn(subscriber: Subscriber[T]): Unit

Characteristic function for an Observable instance, that creates the subscription and that eventually starts the streaming of events to the given Observer, being meant to be overridden in custom combinators or in classes implementing Observable.
Characteristic function for an Observable instance, that creates the subscription and that eventually starts the streaming of events to the given Observer, being meant to be overridden in custom combinators or in classes implementing Observable.

Attributes
protected

Concrete Value Members

final def !=(arg0: Any): Boolean

Definition Classes
AnyRef → Any
final def ##(): Int

Definition Classes
AnyRef → Any
def ++[U >: T](other: ⇒ Observable[U]): Observable[U]

Concatenates the source Observable with the other Observable, as specified.
def +:[U >: T](elem: U): Observable[U]

Creates a new Observable that emits the given element and then it also emits the events of the source (prepend operation).
def :+[U >: T](elem: U): Observable[U]

Creates a new Observable that emits the events of the source and then it also emits the given element (appended to the stream).
final def ==(arg0: Any): Boolean

Definition Classes
AnyRef → Any
def ambWith[U >: T](other: Observable[U]): Observable[U]

Given the source observable and another Observable, emits all of the items from the first of these Observables to emit an item and cancel the other.
def asFuture(implicit s: Scheduler): Future[Option[T]]

Returns the first generated result as a Future and then cancels the subscription.
final def asInstanceOf[T0]: T0

Definition Classes
Any
def asyncBoundary(policy: BufferPolicy = defaultPolicy): Observable[T]

Forces a buffered asynchronous boundary.
Forces a buffered asynchronous boundary.
Internally it wraps the observer implementation given to subscribeFn into a BufferedSubscriber.
Normally Monifu's implementation guarantees that events are not emitted concurrently, and that the publisher MUST NOT emit the next event without acknowledgement from the consumer that it may proceed, however for badly behaved publishers, this wrapper provides the guarantee that the downstream Observer given in subscribe will not receive concurrent events.
WARNING: if the buffer created by this operator is unbounded, it can blow up the process if the data source is pushing events faster than what the observer can consume, as it introduces an asynchronous boundary that eliminates the back-pressure requirements of the data source. Unbounded is the default policy, see BufferPolicy for options.
def behavior[U >: T](initialValue: U)(implicit s: Scheduler): ConnectableObservable[U]

Converts this observable into a multicast observable, useful for turning a cold observable into a hot one (i.e.
Converts this observable into a multicast observable, useful for turning a cold observable into a hot one (i.e. whose source is shared by all observers). The underlying subject used is a BehaviorSubject.
def buffer(count: Int): Observable[Seq[T]]

Periodically gather items emitted by an Observable into bundles and emit these bundles rather than emitting the items one at a time.
Periodically gather items emitted by an Observable into bundles and emit these bundles rather than emitting the items one at a time. This version of buffer is emitting items once the internal buffer has the reached the given count.
So in this example, we are creating a new observable that emits sequences of exactly 10 elements (or whatever is in the buffer when onComplete happens):
```
observable.buffer(10)
```
count
the bundle size
def bufferSizedAndTimed(maxSize: Int, timespan: FiniteDuration): Observable[Seq[T]]

Periodically gather items emitted by an Observable into bundles and emit these bundles rather than emitting the items one at a time.
Periodically gather items emitted by an Observable into bundles and emit these bundles rather than emitting the items one at a time.
This version of buffer emits a new bundle of items periodically, every timespan amount of time, containing all items emitted by the source Observable since the previous bundle emission, or when the buffer size has reached the given count.
maxSize
is the maximum bundle size
timespan
the interval of time at which it should emit the buffered bundle
def bufferTimed(timespan: FiniteDuration): Observable[Seq[T]]

Periodically gather items emitted by an Observable into bundles and emit these bundles rather than emitting the items one at a time.
Periodically gather items emitted by an Observable into bundles and emit these bundles rather than emitting the items one at a time.
This version of buffer emits a new bundle of items periodically, every timespan amount of time, containing all items emitted by the source Observable since the previous bundle emission.
timespan
the interval of time at which it should emit the buffered bundle
def clone(): AnyRef

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws( ... )
def collect[U](pf: PartialFunction[T, U]): Observable[U]

Returns an Observable by applying the given partial function to the source observable for each element for which the given partial function is defined.
Returns an Observable by applying the given partial function to the source observable for each element for which the given partial function is defined.
Useful to be used instead of a filter & map combination.
pf
the function that filters and maps the resulting observable
returns
an Observable that emits the transformed items by the given partial function
def combineLatest[U](other: Observable[U]): Observable[(T, U)]

Creates a new Observable from this Observable and another given Observable.
Creates a new Observable from this Observable and another given Observable.
This operator behaves in a similar way to zip, but while zip emits items only when all of the zipped source Observables have emitted a previously unzipped item, combine emits an item whenever any of the source Observables emits an item (so long as each of the source Observables has emitted at least one item).
def combineLatestDelayError[U](other: Observable[U]): Observable[(T, U)]

Creates a new Observable from this Observable and another given Observable.
Creates a new Observable from this Observable and another given Observable.
It's like Observable.combineLatest, except that the created observable is reserving onError notifications until all of the combined Observables complete and only then passing it along to the observers.
def complete: Observable[Nothing]

Returns an Observable that doesn't emit anything, but that completes when the source Observable completes.
def concat[U](implicit ev: <:<[T, Observable[U]]): Observable[U]

Concatenates the sequence of Observables emitted by the source into one Observable, without any transformation.
Concatenates the sequence of Observables emitted by the source into one Observable, without any transformation.
You can combine the items emitted by multiple Observables so that they act like a single Observable by using this method.
The difference between concat and merge is that concat cares about ordering of emitted items (e.g. all items emitted by the first observable in the sequence will come before the elements emitted by the second observable), whereas merge doesn't care about that (elements get emitted as they come). Because of back-pressure applied to observables, concat is safe to use in all contexts, whereas merge requires buffering.
returns
an Observable that emits items that are the result of flattening the items emitted by the Observables emitted by this
def concatDelayError[U](implicit ev: <:<[T, Observable[U]]): Observable[U]

Concatenates the sequence of Observables emitted by the source into one Observable, without any transformation.
Concatenates the sequence of Observables emitted by the source into one Observable, without any transformation.
It's like Observable.concat, except that the created observable is reserving onError notifications until all of the merged Observables complete and only then passing it along to the observers.
returns
an Observable that emits items that are the result of flattening the items emitted by the Observables emitted by this
def concatMap[U](f: (T) ⇒ Observable[U]): Observable[U]

Creates a new Observable by applying a function that you supply to each item emitted by the source Observable, where that function returns an Observable, and then concatenating those resulting Observables and emitting the results of this concatenation.
Creates a new Observable by applying a function that you supply to each item emitted by the source Observable, where that function returns an Observable, and then concatenating those resulting Observables and emitting the results of this concatenation.
f
a function that, when applied to an item emitted by the source Observable, returns an Observable
returns
an Observable that emits the result of applying the transformation function to each item emitted by the source Observable and concatenating the results of the Observables obtained from this transformation.
def concatMapDelayError[U](f: (T) ⇒ Observable[U]): Observable[U]

Creates a new Observable by applying a function that you supply to each item emitted by the source Observable, where that function returns an Observable, and then concatenating those resulting Observables and emitting the results of this concatenation.
Creates a new Observable by applying a function that you supply to each item emitted by the source Observable, where that function returns an Observable, and then concatenating those resulting Observables and emitting the results of this concatenation.
It's like Observable.concatMap, except that the created observable is reserving onError notifications until all of the merged Observables complete and only then passing it along to the observers.
f
a function that, when applied to an item emitted by the source Observable, returns an Observable
returns
an Observable that emits the result of applying the transformation function to each item emitted by the source Observable and concatenating the results of the Observables obtained from this transformation.
def count(): Observable[Long]

Creates a new Observable that emits the total number of onNext events that were emitted by the source.
Creates a new Observable that emits the total number of onNext events that were emitted by the source.
Note that this Observable emits only one item after the source is complete. And in case the source emits an error, then only that error will be emitted.
def debounce(timeout: FiniteDuration): Observable[T]

Only emit an item from an Observable if a particular timespan has passed without it emitting another item.
Only emit an item from an Observable if a particular timespan has passed without it emitting another item.
Note: If the source Observable keeps emitting items more frequently than the length of the time window then no items will be emitted by the resulting Observable.
timeout
the length of the window of time that must pass after the emission of an item from the source Observable in which that Observable emits no items in order for the item to be emitted by the resulting Observable
def defaultIfEmpty[U >: T](default: U): Observable[U]

Emit items from the source Observable, or emit a default item if the source Observable completes after emitting no items.
def delaySubscription(timespan: FiniteDuration): Observable[T]

Hold an Observer's subscription request for a specified amount of time before passing it on to the source Observable.
Hold an Observer's subscription request for a specified amount of time before passing it on to the source Observable.
timespan
is the time to wait before the subscription is being initiated.
def delaySubscription(future: Future[_]): Observable[T]

Hold an Observer's subscription request until the given future completes, before passing it on to the source Observable.
Hold an Observer's subscription request until the given future completes, before passing it on to the source Observable. If the given future completes in error, then the subscription is terminated with onError.
future
the Future that must complete in order for the subscription to happen.
def distinct[U](fn: (T) ⇒ U): Observable[T]

Given a function that returns a key for each element emitted by the source Observable, suppress duplicates items.
Given a function that returns a key for each element emitted by the source Observable, suppress duplicates items.
WARNING: this requires unbounded buffering.
def distinct: Observable[T]

Suppress the duplicate elements emitted by the source Observable.
Suppress the duplicate elements emitted by the source Observable.
WARNING: this requires unbounded buffering.
def distinctUntilChanged[U](fn: (T) ⇒ U): Observable[T]

Suppress duplicate consecutive items emitted by the source Observable
def distinctUntilChanged: Observable[T]

Suppress duplicate consecutive items emitted by the source Observable
def doOnCanceled(cb: ⇒ Unit): Observable[T]

Executes the given callback if the downstream observer has canceled the streaming.
def doOnComplete(cb: ⇒ Unit): Observable[T]

Executes the given callback when the stream has ended, but before the complete event is emitted.
Executes the given callback when the stream has ended, but before the complete event is emitted.
cb
the callback to execute when the subscription is canceled
def doOnError(cb: (Throwable) ⇒ Unit): Observable[T]

Executes the given callback when the stream is interrupted with an error, before the onError event is emitted downstream.
Executes the given callback when the stream is interrupted with an error, before the onError event is emitted downstream.
NOTE: should protect the code in this callback, because if it throws an exception the onError event will prefer signaling the original exception and otherwise the behavior is undefined.
def doOnStart(cb: (T) ⇒ Unit): Observable[T]

Executes the given callback only for the first element generated by the source Observable, useful for doing a piece of computation only when the stream started.
Executes the given callback only for the first element generated by the source Observable, useful for doing a piece of computation only when the stream started.
returns
a new Observable that executes the specified callback only for the first element
def doWork(cb: (T) ⇒ Unit): Observable[T]

Executes the given callback for each element generated by the source Observable, useful for doing side-effects.
Executes the given callback for each element generated by the source Observable, useful for doing side-effects.
returns
a new Observable that executes the specified callback for each element
def drop(n: Int): Observable[T]

Drops the first n elements (from the start).
Drops the first n elements (from the start).
n
the number of elements to drop
returns
a new Observable that drops the first n elements emitted by the source
def dropByTimespan(timespan: FiniteDuration): Observable[T]

Creates a new Observable that drops the events of the source, only for the specified timestamp window.
Creates a new Observable that drops the events of the source, only for the specified timestamp window.
timespan
the window of time during which the new Observable is must drop the events emitted by the source
def dropWhile(p: (T) ⇒ Boolean): Observable[T]

Drops the longest prefix of elements that satisfy the given predicate and returns a new Observable that emits the rest.
def dropWhileWithIndex(p: (T, Int) ⇒ Boolean): Observable[T]

Drops the longest prefix of elements that satisfy the given function and returns a new Observable that emits the rest.
Drops the longest prefix of elements that satisfy the given function and returns a new Observable that emits the rest. In comparison with dropWhile, this version accepts a function that takes an additional parameter: the zero-based index of the element.
def dump(prefix: String, out: PrintStream = System.out): Observable[T]

Utility that can be used for debugging purposes.
def endWith[U >: T](elems: U*): Observable[U]

Creates a new Observable that emits the events of the source and then it also emits the given elements (appended to the stream).
def endWithError(error: Throwable): Observable[T]

Emits the given exception instead of onComplete.
Emits the given exception instead of onComplete.
error
the exception to emit onComplete
returns
a new Observable that emits an exception onComplete
final def eq(arg0: AnyRef): Boolean

Definition Classes
AnyRef
def equals(arg0: Any): Boolean

Definition Classes
AnyRef → Any
def error: Observable[Throwable]

Returns an Observable that emits a single Throwable, in case an error was thrown by the source Observable, otherwise it isn't going to emit anything.
def exists(p: (T) ⇒ Boolean): Observable[Boolean]

Returns an Observable which emits a single value, either true, in case the given predicate holds for at least one item, or false otherwise.
Returns an Observable which emits a single value, either true, in case the given predicate holds for at least one item, or false otherwise.
p
a function that evaluates the items emitted by the source Observable, returning true if they pass the filter
returns
an Observable that emits only true or false in case the given predicate holds or not for at least one item
def filter(p: (T) ⇒ Boolean): Observable[T]

Returns an Observable which only emits those items for which the given predicate holds.
Returns an Observable which only emits those items for which the given predicate holds.
p
a function that evaluates the items emitted by the source Observable, returning true if they pass the filter
returns
an Observable that emits only those items in the original Observable for which the filter evaluates as true
def finalize(): Unit

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws( classOf[java.lang.Throwable] )
def find(p: (T) ⇒ Boolean): Observable[T]

Returns an Observable which only emits the first item for which the predicate holds.
Returns an Observable which only emits the first item for which the predicate holds.
p
a function that evaluates the items emitted by the source Observable, returning true if they pass the filter
returns
an Observable that emits only the first item in the original Observable for which the filter evaluates as true
def firstOrElse[U >: T](default: ⇒ U): Observable[U]

Emits the first element emitted by the source, or otherwise if the source is completed without emitting anything, then the default is emitted.
Emits the first element emitted by the source, or otherwise if the source is completed without emitting anything, then the default is emitted.
Alias for headOrElse.
def flatMap[U](f: (T) ⇒ Observable[U]): Observable[U]

Creates a new Observable by applying a function that you supply to each item emitted by the source Observable, where that function returns an Observable, and then concatenating those resulting Observables and emitting the results of this concatenation.
Creates a new Observable by applying a function that you supply to each item emitted by the source Observable, where that function returns an Observable, and then concatenating those resulting Observables and emitting the results of this concatenation.
f
a function that, when applied to an item emitted by the source Observable, returns an Observable
returns
an Observable that emits the result of applying the transformation function to each item emitted by the source Observable and concatenating the results of the Observables obtained from this transformation.
def flatMapDelayError[U](f: (T) ⇒ Observable[U]): Observable[U]

Creates a new Observable by applying a function that you supply to each item emitted by the source Observable, where that function returns an Observable, and then concatenating those resulting Observables and emitting the results of this concatenation.
Creates a new Observable by applying a function that you supply to each item emitted by the source Observable, where that function returns an Observable, and then concatenating those resulting Observables and emitting the results of this concatenation.
It's an alias for Observable.concatMapDelayError.
f
a function that, when applied to an item emitted by the source Observable, returns an Observable
returns
an Observable that emits the result of applying the transformation function to each item emitted by the source Observable and concatenating the results of the Observables obtained from this transformation.
def flatScan[R](initial: R)(op: (R, T) ⇒ Observable[R]): Observable[R]

Applies a binary operator to a start value and to elements produced by the source observable, going from left to right, producing and concatenating observables along the way.
Applies a binary operator to a start value and to elements produced by the source observable, going from left to right, producing and concatenating observables along the way.
It's the combination between scan and monifu.reactive.Observable.flatten.
def flatScanDelayError[R](initial: R)(op: (R, T) ⇒ Observable[R]): Observable[R]

Applies a binary operator to a start value and to elements produced by the source observable, going from left to right, producing and concatenating observables along the way.
Applies a binary operator to a start value and to elements produced by the source observable, going from left to right, producing and concatenating observables along the way.
It's the combination between scan and monifu.reactive.Observable.flattenDelayError.
def flatten[U](implicit ev: <:<[T, Observable[U]]): Observable[U]

Flattens the sequence of Observables emitted by the source into one Observable, without any transformation.
Flattens the sequence of Observables emitted by the source into one Observable, without any transformation.
It's an alias for Observable.concat.
returns
an Observable that emits items that are the result of flattening the items emitted by the Observables emitted by this
def flattenDelayError[U](implicit ev: <:<[T, Observable[U]]): Observable[U]

Flattens the sequence of Observables emitted by the source into one Observable, without any transformation.
Flattens the sequence of Observables emitted by the source into one Observable, without any transformation. Delays errors until the end.
It's an alias for Observable.concatDelayError.
returns
an Observable that emits items that are the result of flattening the items emitted by the Observables emitted by this
def foldLeft[R](initial: R)(op: (R, T) ⇒ R): Observable[R]

Applies a binary operator to a start value and all elements of this Observable, going left to right and returns a new Observable that emits only one item before onComplete.
def forAll(p: (T) ⇒ Boolean): Observable[Boolean]

Returns an Observable that emits a single boolean, either true, in case the given predicate holds for all the items emitted by the source, or false in case at least one item is not verifying the given predicate.
Returns an Observable that emits a single boolean, either true, in case the given predicate holds for all the items emitted by the source, or false in case at least one item is not verifying the given predicate.
p
a function that evaluates the items emitted by the source Observable, returning true if they pass the filter
returns
an Observable that emits only true or false in case the given predicate holds or not for all the items
def foreach(cb: (T) ⇒ Unit)(implicit s: Scheduler): Unit

Subscribes to the source Observable and foreach element emitted by the source it executes the given callback.
final def getClass(): Class[_]

Definition Classes
AnyRef → Any
def hashCode(): Int

Definition Classes
AnyRef → Any
def head: Observable[T]

Only emits the first element emitted by the source observable, after which it's completed immediately.
def headOrElse[B >: T](default: ⇒ B): Observable[B]

Emits the first element emitted by the source, or otherwise if the source is completed without emitting anything, then the default is emitted.
def isEmpty: Observable[Boolean]

Returns an Observable that emits true if the source Observable is empty, otherwise false.
final def isInstanceOf[T0]: Boolean

Definition Classes
Any
def last: Observable[T]

Only emits the last element emitted by the source observable, after which it's completed immediately.
def lift[U](f: (Observable[T]) ⇒ Observable[U]): Observable[U]

Given a function that transforms an Observable[T] into an Observable[U], it transforms the source observable into an Observable[U].
def map[U](f: (T) ⇒ U): Observable[U]

Returns an Observable that applies the given function to each item emitted by an Observable and emits the result.
Returns an Observable that applies the given function to each item emitted by an Observable and emits the result.
f
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 given function
def materialize: Observable[Notification[T]]

Converts the source Observable that emits T into an Observable that emits Notification[T].
Converts the source Observable that emits T into an Observable that emits Notification[T].
NOTE: onComplete is still emitted after an onNext(OnComplete) notification however an onError(ex) notification is emitted as an onNext(OnError(ex)) followed by an onComplete.
def max[U >: T](implicit ev: Ordering[U]): Observable[U]

Takes the elements of the source Observable and emits the maximum value, after the source has completed.
def maxBy[U](f: (T) ⇒ U)(implicit ev: Ordering[U]): Observable[T]

Takes the elements of the source Observable and emits the element that has the maximum key value, where the key is generated by the given function f.
def merge[U](bufferPolicy: BufferPolicy = defaultPolicy)(implicit ev: <:<[T, Observable[U]]): Observable[U]

Merges the sequence of Observables emitted by the source into one Observable, without any transformation.
Merges the sequence of Observables emitted by the source into one Observable, without any transformation.
You can combine the items emitted by multiple Observables so that they act like a single Observable by using this method.
The difference between concat and merge is that concat cares about ordering of emitted items (e.g. all items emitted by the first observable in the sequence will come before the elements emitted by the second observable), whereas merge doesn't care about that (elements get emitted as they come). Because of back-pressure applied to observables, concat is safe to use in all contexts, whereas merge requires buffering.
bufferPolicy
the policy used for buffering, useful if you want to limit the buffer size and apply back-pressure, trigger and error, etc... see the available buffer policies.
returns
an Observable that emits items that are the result of flattening the items emitted by the Observables emitted by this
def mergeDelayError[U](bufferPolicy: BufferPolicy = defaultPolicy)(implicit ev: <:<[T, Observable[U]]): Observable[U]

Merges the sequence of Observables emitted by the source into one Observable, without any transformation.
Merges the sequence of Observables emitted by the source into one Observable, without any transformation. You can combine the items emitted by multiple Observables so that they act like a single Observable by using this method.
It's like Observable.merge, except that the created observable is reserving onError notifications until all of the merged Observables complete and only then passing it along to the observers.
bufferPolicy
the policy used for buffering, useful if you want to limit the buffer size and apply back-pressure, trigger and error, etc... see the available buffer policies.
returns
an Observable that emits items that are the result of flattening the items emitted by the Observables emitted by this
def mergeMap[U](f: (T) ⇒ Observable[U]): Observable[U]

Creates a new Observable by applying a function that you supply to each item emitted by the source Observable, where that function returns an Observable, and then merging those resulting Observables and emitting the results of this merger.
Creates a new Observable by applying a function that you supply to each item emitted by the source Observable, where that function returns an Observable, and then merging those resulting Observables and emitting the results of this merger.
f
a function that, when applied to an item emitted by the source Observable, returns an Observable
returns
an Observable that emits the result of applying the transformation function to each item emitted by the source Observable and merging the results of the Observables obtained from this transformation.
def mergeMapDelayError[U](f: (T) ⇒ Observable[U]): Observable[U]

Creates a new Observable by applying a function that you supply to each item emitted by the source Observable, where that function returns an Observable, and then merging those resulting Observables and emitting the results of this merger.
Creates a new Observable by applying a function that you supply to each item emitted by the source Observable, where that function returns an Observable, and then merging those resulting Observables and emitting the results of this merger.
It's like Observable.mergeMap, except that the created observable is reserving onError notifications until all of the merged Observables complete and only then passing it along to the observers.
f
a function that, when applied to an item emitted by the source Observable, returns an Observable
returns
an Observable that emits the result of applying the transformation function to each item emitted by the source Observable and merging the results of the Observables obtained from this transformation.
def min[U >: T](implicit ev: Ordering[U]): Observable[U]

Takes the elements of the source Observable and emits the minimum value, after the source has completed.
def minBy[U](f: (T) ⇒ U)(implicit ev: Ordering[U]): Observable[T]

Takes the elements of the source Observable and emits the element that has the minimum key value, where the key is generated by the given function f.
def multicast[R](subject: Subject[T, R])(implicit s: Scheduler): ConnectableObservable[R]

Converts this observable into a multicast observable, useful for turning a cold observable into a hot one (i.e.
Converts this observable into a multicast observable, useful for turning a cold observable into a hot one (i.e. whose source is shared by all observers).
final def ne(arg0: AnyRef): Boolean

Definition Classes
AnyRef
def nonEmpty: Observable[Boolean]

Returns an Observable that emits false if the source Observable is empty, otherwise true.
final def notify(): Unit

Definition Classes
AnyRef
final def notifyAll(): Unit

Definition Classes
AnyRef
def onErrorFallbackTo[U >: T](that: ⇒ Observable[U]): Observable[U]

Returns an Observable that mirrors the behavior of the source, unless the source is terminated with an onError, in which case the streaming of events continues with the specified backup sequence.
Returns an Observable that mirrors the behavior of the source, unless the source is terminated with an onError, in which case the streaming of events continues with the specified backup sequence.
The created Observable mirrors the behavior of the source in case the source does not end with an error.
NOTE that compared with onErrorResumeNext from Rx.NET, the streaming is not resumed in case the source is terminated normally with an onComplete.
that
- a backup sequence that's being subscribed in case the source terminates with an error.
def onErrorRecoverWith[U >: T](pf: PartialFunction[Throwable, Observable[U]]): Observable[U]

Returns an Observable that mirrors the behavior of the source, unless the source is terminated with an onError, in which case the streaming of events continues with the specified backup sequence generated by the given partial function.
Returns an Observable that mirrors the behavior of the source, unless the source is terminated with an onError, in which case the streaming of events continues with the specified backup sequence generated by the given partial function.
The created Observable mirrors the behavior of the source in case the source does not end with an error or if the thrown Throwable is not matched.
NOTE that compared with onErrorResumeNext from Rx.NET, the streaming is not resumed in case the source is terminated normally with an onComplete.
pf
- a partial function that matches errors with a backup throwable that is subscribed when the source throws an error.
def onErrorRetry(maxRetries: Long): Observable[T]

Returns an Observable that mirrors the behavior of the source, unless the source is terminated with an onError, in which case it tries subscribing to the source again in the hope that it will complete without an error.
Returns an Observable that mirrors the behavior of the source, unless the source is terminated with an onError, in which case it tries subscribing to the source again in the hope that it will complete without an error.
The number of retries is limited by the specified maxRetries parameter, so for an Observable that always ends in error the total number of subscriptions that will eventually happen is maxRetries + 1.
def onErrorRetryIf(p: (Throwable) ⇒ Boolean): Observable[T]

Returns an Observable that mirrors the behavior of the source, unless the source is terminated with an onError, in which case it tries subscribing to the source again in the hope that it will complete without an error.
Returns an Observable that mirrors the behavior of the source, unless the source is terminated with an onError, in which case it tries subscribing to the source again in the hope that it will complete without an error.
The given predicate establishes if the subscription should be retried or not.
def onErrorRetryUnlimited: Observable[T]

Returns an Observable that mirrors the behavior of the source, unless the source is terminated with an onError, in which case it tries subscribing to the source again in the hope that it will complete without an error.
Returns an Observable that mirrors the behavior of the source, unless the source is terminated with an onError, in which case it tries subscribing to the source again in the hope that it will complete without an error.
NOTE: The number of retries is unlimited, so something like Observable.error(new RuntimeException).onErrorRetryUnlimited will loop forever.
def publish()(implicit s: Scheduler): ConnectableObservable[T]

Converts this observable into a multicast observable, useful for turning a cold observable into a hot one (i.e.
Converts this observable into a multicast observable, useful for turning a cold observable into a hot one (i.e. whose source is shared by all observers). The underlying subject used is a PublishSubject.
def publishLast()(implicit s: Scheduler): ConnectableObservable[T]

Converts this observable into a multicast observable, useful for turning a cold observable into a hot one (i.e.
Converts this observable into a multicast observable, useful for turning a cold observable into a hot one (i.e. whose source is shared by all observers). The underlying subject used is a AsyncSubject.
def publisher[U >: T](implicit s: Scheduler): Publisher[U]

Wraps this Observable into a org.reactivestreams.Publisher.
def reduce[U >: T](op: (U, U) ⇒ U): Observable[U]

Applies a binary operator to a start value and all elements of this Observable, going left to right and returns a new Observable that emits only one item before onComplete.
def repeat: Observable[T]

Repeats the items emitted by this Observable continuously.
Repeats the items emitted by this Observable continuously. It caches the generated items until onComplete and repeats them ad infinitum. On error it terminates.
def replay()(implicit s: Scheduler): ConnectableObservable[T]

Converts this observable into a multicast observable, useful for turning a cold observable into a hot one (i.e.
Converts this observable into a multicast observable, useful for turning a cold observable into a hot one (i.e. whose source is shared by all observers). The underlying subject used is a ReplaySubject.
def sample(initialDelay: FiniteDuration, delay: FiniteDuration): Observable[T]

Emit the most recent items emitted by an Observable within periodic time intervals.
Emit the most recent items emitted by an Observable within periodic time intervals.
Use the sample() method to periodically look at an Observable to see what item it has most recently emitted since the previous sampling. Note that if the source Observable has emitted no items since the last time it was sampled, the Observable that results from the sample( ) operator will emit no item for that sampling period.
initialDelay
the initial delay after which sampling can happen
delay
the timespan at which sampling occurs and note that this is not accurate as it is subject to back-pressure concerns - as in if the delay is 1 second and the processing of an event on onNext in the observer takes one second, then the actual sampling delay will be 2 seconds.
def sample(delay: FiniteDuration): Observable[T]

Emit the most recent items emitted by an Observable within periodic time intervals.
Emit the most recent items emitted by an Observable within periodic time intervals.
Use the sample() method to periodically look at an Observable to see what item it has most recently emitted since the previous sampling. Note that if the source Observable has emitted no items since the last time it was sampled, the Observable that results from the sample( ) operator will emit no item for that sampling period.
delay
the timespan at which sampling occurs and note that this is not accurate as it is subject to back-pressure concerns - as in if the delay is 1 second and the processing of an event on onNext in the observer takes one second, then the actual sampling delay will be 2 seconds.
def sampleRepeated(initialDelay: FiniteDuration, delay: FiniteDuration): Observable[T]

Emit the most recent items emitted by an Observable within periodic time intervals.
Emit the most recent items emitted by an Observable within periodic time intervals. If no new value has been emitted since the last time it was sampled, the emit the last emitted value anyway.
Also see Observable!.sample.
initialDelay
the initial delay after which sampling can happen
delay
the timespan at which sampling occurs and note that this is not accurate as it is subject to back-pressure concerns - as in if the delay is 1 second and the processing of an event on onNext in the observer takes one second, then the actual sampling delay will be 2 seconds.
def sampleRepeated(delay: FiniteDuration): Observable[T]

Emit the most recent items emitted by an Observable within periodic time intervals.
Emit the most recent items emitted by an Observable within periodic time intervals. If no new value has been emitted since the last time it was sampled, the emit the last emitted value anyway.
Also see Observable.sample.
delay
the timespan at which sampling occurs and note that this is not accurate as it is subject to back-pressure concerns - as in if the delay is 1 second and the processing of an event on onNext in the observer takes one second, then the actual sampling delay will be 2 seconds.
def scan[R](initial: R)(op: (R, T) ⇒ R): Observable[R]

Applies a binary operator to a start value and all elements of this Observable, going left to right and returns a new Observable that emits on each step the result of the applied function.
Applies a binary operator to a start value and all elements of this Observable, going left to right and returns a new Observable that emits on each step the result of the applied function.
Similar to foldLeft, but emits the state on each step. Useful for modeling finite state machines.
def startWith[U >: T](elems: U*): Observable[U]

Creates a new Observable that emits the given elements and then it also emits the events of the source (prepend operation).
def subscribe(nextFn: (T) ⇒ Future[Ack])(implicit s: Scheduler): BooleanCancelable

Creates the subscription and starts the stream.
def subscribe()(implicit s: Scheduler): Cancelable

Creates the subscription and starts the stream.
def subscribe(nextFn: (T) ⇒ Future[Ack], errorFn: (Throwable) ⇒ Unit)(implicit s: Scheduler): BooleanCancelable

Creates the subscription and starts the stream.
def subscribe(nextFn: (T) ⇒ Future[Ack], errorFn: (Throwable) ⇒ Unit, completedFn: () ⇒ Unit)(implicit s: Scheduler): BooleanCancelable

Creates the subscription and starts the stream.
def subscribe(observer: Observer[T])(implicit s: Scheduler): BooleanCancelable

Creates the subscription and that starts the stream.
Creates the subscription and that starts the stream.
observer
is an Observer on which onNext, onComplete and onError happens, according to the Monifu Rx contract.
def subscribeOn(s: Scheduler): Observable[T]

Returns a new Observable that uses the specified Scheduler for initiating the subscription.
def sum[U >: T](implicit ev: Numeric[U]): Observable[U]

Given a source that emits numeric values, the sum operator sums up all values and at onComplete it emits the total.
final def synchronized[T0](arg0: ⇒ T0): T0

Definition Classes
AnyRef
def tail: Observable[T]

Drops the first element of the source observable, emitting the rest.
def take(timespan: FiniteDuration): Observable[T]

Creates a new Observable that emits the events of the source, only for the specified timestamp, after which it completes.
Creates a new Observable that emits the events of the source, only for the specified timestamp, after which it completes.
timespan
the window of time during which the new Observable is allowed to emit the events of the source
def take(n: Int): Observable[T]

Selects the first n elements (from the start).
Selects the first n elements (from the start).
n
the number of elements to take
returns
a new Observable that emits only the first n elements from the source
def takeRight(n: Int): Observable[T]

Creates a new Observable that only emits the last n elements emitted by the source.
def takeWhile(p: (T) ⇒ Boolean): Observable[T]

Takes longest prefix of elements that satisfy the given predicate and returns a new Observable that emits those elements.
def takeWhileNotCanceled(c: BooleanCancelable): Observable[T]

Takes longest prefix of elements that satisfy the given predicate and returns a new Observable that emits those elements.
def toString(): String

Definition Classes
AnyRef → Any
def unsafeSubscribe(subscriber: Subscriber[T]): Unit

Creates the subscription that eventually starts the stream.
Creates the subscription that eventually starts the stream.
This function is "unsafe" to call because it does not protect the calls to the given Observer implementation in regards to unexpected exceptions that violate the contract, therefore the given instance must respect its contract and not throw any exceptions when the observable calls onNext, onComplete and onError. if it does, then the behavior is undefined.
def unsafeSubscribe(observer: Observer[T])(implicit s: Scheduler): Unit

Creates the subscription that eventually starts the stream.
Creates the subscription that eventually starts the stream.
This function is "unsafe" to call because it does not protect the calls to the given Observer implementation in regards to unexpected exceptions that violate the contract, therefore the given instance must respect its contract and not throw any exceptions when the observable calls onNext, onComplete and onError. if it does, then the behavior is undefined.
observer
is an Observer that respects Monifu Rx contract.
final def wait(): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )
final def wait(arg0: Long, arg1: Int): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )
final def wait(arg0: Long): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )
def whileBusyBufferEvents(bufferSize: Int): Observable[Seq[T]]

While the destination observer is busy, buffers events then send whatever was buffered in one big batch.
def whileBusyDropEvents: Observable[T]

While the destination observer is busy, drop the incoming events.
def zip[U](other: Observable[U]): Observable[(T, U)]

Creates a new Observable from this Observable and another given Observable, by emitting elements combined in pairs.
Creates a new Observable from this Observable and another given Observable, by emitting elements combined in pairs. If one of the Observable emits fewer events than the other, then the rest of the unpaired events are ignored.

Related Docs: object Observable | package reactive

trait Observable[+T] extends AnyRef

Abstract Value Members

abstract def subscribeFn(subscriber: Subscriber[T]): Unit

Concrete Value Members

final def !=(arg0: Any): Boolean

final def ##(): Int

def ++[U >: T](other: ⇒ Observable[U]): Observable[U]

def +:[U >: T](elem: U): Observable[U]

def :+[U >: T](elem: U): Observable[U]

final def ==(arg0: Any): Boolean

def ambWith[U >: T](other: Observable[U]): Observable[U]

def asFuture(implicit s: Scheduler): Future[Option[T]]

final def asInstanceOf[T0]: T0

def asyncBoundary(policy: BufferPolicy = defaultPolicy): Observable[T]

def behavior[U >: T](initialValue: U)(implicit s: Scheduler): ConnectableObservable[U]

def buffer(count: Int): Observable[Seq[T]]

def bufferSizedAndTimed(maxSize: Int, timespan: FiniteDuration): Observable[Seq[T]]

def bufferTimed(timespan: FiniteDuration): Observable[Seq[T]]

def clone(): AnyRef

def collect[U](pf: PartialFunction[T, U]): Observable[U]

def combineLatest[U](other: Observable[U]): Observable[(T, U)]

def combineLatestDelayError[U](other: Observable[U]): Observable[(T, U)]

def complete: Observable[Nothing]

def concat[U](implicit ev: <:<[T, Observable[U]]): Observable[U]

def concatDelayError[U](implicit ev: <:<[T, Observable[U]]): Observable[U]

def concatMap[U](f: (T) ⇒ Observable[U]): Observable[U]

def concatMapDelayError[U](f: (T) ⇒ Observable[U]): Observable[U]

def count(): Observable[Long]

def debounce(timeout: FiniteDuration): Observable[T]

def defaultIfEmpty[U >: T](default: U): Observable[U]

def delaySubscription(timespan: FiniteDuration): Observable[T]

def delaySubscription(future: Future[_]): Observable[T]

def distinct[U](fn: (T) ⇒ U): Observable[T]

def distinct: Observable[T]

def distinctUntilChanged[U](fn: (T) ⇒ U): Observable[T]

def distinctUntilChanged: Observable[T]

def doOnCanceled(cb: ⇒ Unit): Observable[T]

def doOnComplete(cb: ⇒ Unit): Observable[T]

def doOnError(cb: (Throwable) ⇒ Unit): Observable[T]

def doOnStart(cb: (T) ⇒ Unit): Observable[T]

def doWork(cb: (T) ⇒ Unit): Observable[T]

def drop(n: Int): Observable[T]

def dropByTimespan(timespan: FiniteDuration): Observable[T]

def dropWhile(p: (T) ⇒ Boolean): Observable[T]

def dropWhileWithIndex(p: (T, Int) ⇒ Boolean): Observable[T]

def dump(prefix: String, out: PrintStream = System.out): Observable[T]

def endWith[U >: T](elems: U*): Observable[U]

def endWithError(error: Throwable): Observable[T]

final def eq(arg0: AnyRef): Boolean

def equals(arg0: Any): Boolean

def error: Observable[Throwable]

def exists(p: (T) ⇒ Boolean): Observable[Boolean]

def filter(p: (T) ⇒ Boolean): Observable[T]

def finalize(): Unit

def find(p: (T) ⇒ Boolean): Observable[T]

def firstOrElse[U >: T](default: ⇒ U): Observable[U]

def flatMap[U](f: (T) ⇒ Observable[U]): Observable[U]

def flatMapDelayError[U](f: (T) ⇒ Observable[U]): Observable[U]

def flatScan[R](initial: R)(op: (R, T) ⇒ Observable[R]): Observable[R]

def flatScanDelayError[R](initial: R)(op: (R, T) ⇒ Observable[R]): Observable[R]

def flatten[U](implicit ev: <:<[T, Observable[U]]): Observable[U]

def flattenDelayError[U](implicit ev: <:<[T, Observable[U]]): Observable[U]

def foldLeft[R](initial: R)(op: (R, T) ⇒ R): Observable[R]

def forAll(p: (T) ⇒ Boolean): Observable[Boolean]

def foreach(cb: (T) ⇒ Unit)(implicit s: Scheduler): Unit

final def getClass(): Class[_]

def hashCode(): Int

def head: Observable[T]

def headOrElse[B >: T](default: ⇒ B): Observable[B]

def isEmpty: Observable[Boolean]

final def isInstanceOf[T0]: Boolean

def last: Observable[T]

def lift[U](f: (Observable[T]) ⇒ Observable[U]): Observable[U]

def map[U](f: (T) ⇒ U): Observable[U]

def materialize: Observable[Notification[T]]

def max[U >: T](implicit ev: Ordering[U]): Observable[U]

def maxBy[U](f: (T) ⇒ U)(implicit ev: Ordering[U]): Observable[T]

def merge[U](bufferPolicy: BufferPolicy = defaultPolicy)(implicit ev: <:<[T, Observable[U]]): Observable[U]