rx.observers

Class TestSubscriber<T>

java.lang.Object

rx.Subscriber<T>

rx.observers.TestSubscriber<T>

All Implemented Interfaces:

Observer<T>, Subscription

public class TestSubscriber<T>
extends Subscriber<T>

Subscriber usable for unit testing to perform assertions, inspect received events or wrap a mocked Subscriber.

Constructor Summary

Constructors

Constructor and Description
TestSubscriber()
TestSubscriber(Observer<T> delegate)
TestSubscriber(Subscriber<T> delegate)

Method Summary

Methods

Modifier and Type	Method and Description
void	assertReceivedOnNext(java.util.List<T> items) Assert that a particular sequence of items was received in order.
void	assertTerminalEvent() Assert that a single terminal event occurred, either TestSubscriber.onCompleted() or TestSubscriber.onError(java.lang.Throwable).
void	assertUnsubscribed() Assert that this Subscriber is unsubscribed.
void	awaitTerminalEvent()
void	awaitTerminalEvent(long timeout, java.util.concurrent.TimeUnit unit)
void	awaitTerminalEventAndUnsubscribeOnTimeout(long timeout, java.util.concurrent.TimeUnit unit)
java.lang.Thread	getLastSeenThread()
java.util.List<Notification<T>>	getOnCompletedEvents() Get the Notifications representing each time this subscriber was notified of sequence completion via TestSubscriber.onCompleted(), as a List.
java.util.List<java.lang.Throwable>	getOnErrorEvents() Get the Throwables this subscriber was notified of via TestSubscriber.onError(java.lang.Throwable) as a List.
java.util.List<T>	getOnNextEvents() Get the sequence of items observed by this subscriber, as an ordered List.
void	onCompleted() Notifies the Observer that the Observable has finished sending push-based notifications.
void	onError(java.lang.Throwable e) Notifies the Observer that the Observable has experienced an error condition.
void	onNext(T t) Provides the Observer with a new item to observe.

Methods inherited from class rx.Subscriber

add, isUnsubscribed, unsubscribe

Methods inherited from class java.lang.Object

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

Constructor Detail

TestSubscriber

public TestSubscriber(Subscriber<T> delegate)

TestSubscriber

public TestSubscriber(Observer<T> delegate)

TestSubscriber

public TestSubscriber()

Method Detail

onCompleted

public void onCompleted()

Description copied from interface: Observer

Notifies the Observer that the Observable has finished sending push-based notifications.

The Observable will not call this method if it calls Observer.onError(java.lang.Throwable).

getOnCompletedEvents

public java.util.List<Notification<T>> getOnCompletedEvents()

Get the Notifications representing each time this subscriber was notified of sequence completion via TestSubscriber.onCompleted(), as a List.

Returns:

a list of Notifications representing calls to this subscriber's TestSubscriber.onCompleted() method

onError

public void onError(java.lang.Throwable e)

Description copied from interface: Observer

Notifies the Observer that the Observable has experienced an error condition.

If the Observable calls this method, it will not thereafter call Observer.onNext(T) or Observer.onCompleted().

Parameters:

e - the exception encountered by the Observable

getOnErrorEvents

public java.util.List<java.lang.Throwable> getOnErrorEvents()

Get the Throwables this subscriber was notified of via TestSubscriber.onError(java.lang.Throwable) as a List.

Returns:

a list of Throwables passed to this subscriber's TestSubscriber.onError(java.lang.Throwable) method

onNext

public void onNext(T t)

Description copied from interface: Observer

Provides the Observer with a new item to observe.

The Observable may call this closure 0 or more times.

The Observable will not call this closure again after it calls either Observer.onCompleted() or Observer.onError(java.lang.Throwable).

Parameters:

t - the item emitted by the Observable

getOnNextEvents

public java.util.List<T> getOnNextEvents()

Get the sequence of items observed by this subscriber, as an ordered List.

Returns:

a list of items observed by this subscriber, in the order in which they were observed

assertReceivedOnNext

public void assertReceivedOnNext(java.util.List<T> items)

Assert that a particular sequence of items was received in order.

Parameters:

items - the sequence of items expected to have been observed

Throws:

java.lang.AssertionError - if the sequence of items observed does not exactly match items

assertTerminalEvent

public void assertTerminalEvent()

Assert that a single terminal event occurred, either TestSubscriber.onCompleted() or TestSubscriber.onError(java.lang.Throwable).

Throws:

java.lang.AssertionError - if not exactly one terminal event notification was received

assertUnsubscribed

public void assertUnsubscribed()

Assert that this Subscriber is unsubscribed.

Throws:

java.lang.AssertionError - if this Subscriber is not unsubscribed

awaitTerminalEvent

public void awaitTerminalEvent()

awaitTerminalEvent

public void awaitTerminalEvent(long timeout,
                      java.util.concurrent.TimeUnit unit)

awaitTerminalEventAndUnsubscribeOnTimeout

public void awaitTerminalEventAndUnsubscribeOnTimeout(long timeout,
                                             java.util.concurrent.TimeUnit unit)

getLastSeenThread

public java.lang.Thread getLastSeenThread()