SwitchIfEmptyStreamTransformer<T> class

When the original observable emits no items, this operator subscribes to the given fallback stream and emits items from that observable instead.

This can be particularly useful when consuming data from multiple sources. For example, when using the Repository Pattern. Assuming you have some data you need to load, you might want to start with the fastest access point and keep falling back to the slowest point. For example, first query an in-memory database, then a database on the file system, then a network call if the data isn't on the local machine.

This can be achieved quite simply with switchIfEmpty!

Example

// Let's pretend we have some Data sources that complete without emitting
// any items if they don't contain the data we're looking for
Stream<Data> memory;
Stream<Data> disk;
Stream<Data> network;

// Start with memory, fallback to disk, then fallback to network.
// Simple as that!
Stream<Data> getThatData =
    memory.switchIfEmpty(disk).switchIfEmpty(network);

Constructors

SwitchIfEmptyStreamTransformer(Stream<T> fallbackStream)
Constructs a StreamTransformer which, when the source Stream emits no events, switches over to fallbackStream.

Properties

hashCode → int
The hash code for this object.
read-only, inherited
runtimeType → Type
A representation of the runtime type of the object.
read-only, inherited

Methods

bind(Stream<T> stream) → Stream<T>
Transforms the provided stream. [...]
cast<RS, RT>() → StreamTransformer<RS, RT>
Provides a StreamTransformer<RS, RT> view of this stream transformer.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a non-existent method or property is accessed.
inherited
toString() → String
Returns a string representation of this object.
inherited

Operators

operator ==(dynamic other) → bool
The equality operator.
inherited