Package rx.internal.operators

Class OperatorOnBackpressureLatest.LatestEmitter<T>

java.lang.Object

java.lang.Number

java.util.concurrent.atomic.AtomicLong

rx.internal.operators.OperatorOnBackpressureLatest.LatestEmitter<T>

Type Parameters:

T -

All Implemented Interfaces:

Serializable, Observer<T>, Producer, Subscription

Enclosing class:

OperatorOnBackpressureLatest<T>

static final class OperatorOnBackpressureLatest.LatestEmitter<T>
extends AtomicLong
implements Producer, Subscription, Observer<T>

A terminable producer which emits the latest items on request.

Field Summary

Fields

Modifier and Type	Field	Description
(package private) final Subscriber<? super T>	child
(package private) boolean	done
(package private) boolean	emitting	Guarded by this.
(package private) static final Object	EMPTY
(package private) boolean	missed	Guarded by this.
(package private) static final long	NOT_REQUESTED
(package private) OperatorOnBackpressureLatest.LatestSubscriber<? super T>	parent
private static final long	serialVersionUID
(package private) Throwable	terminal	Written before done, read after done.
(package private) final AtomicReference<Object>	value

Constructor Summary

Constructors

Constructor	Description
LatestEmitter(Subscriber<? super T> child)

Method Summary

Modifier and Type	Method	Description
(package private) void	emit()
boolean	isUnsubscribed()	Indicates whether this Subscription is currently unsubscribed.
void	onCompleted()	Notifies the Observer that the Observable has finished sending push-based notifications.
void	onError(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.
(package private) long	produced(long n)
void	request(long n)	Request a certain maximum number of items from this Producer.
void	unsubscribe()	Stops the receipt of notifications on the Subscriber that was registered when this Subscription was received.

Methods inherited from class java.util.concurrent.atomic.AtomicLong

accumulateAndGet, addAndGet, compareAndExchange, compareAndExchangeAcquire, compareAndExchangeRelease, compareAndSet, decrementAndGet, doubleValue, floatValue, get, getAcquire, getAndAccumulate, getAndAdd, getAndDecrement, getAndIncrement, getAndSet, getAndUpdate, getOpaque, getPlain, incrementAndGet, intValue, lazySet, longValue, set, setOpaque, setPlain, setRelease, toString, updateAndGet, weakCompareAndSet, weakCompareAndSetAcquire, weakCompareAndSetPlain, weakCompareAndSetRelease, weakCompareAndSetVolatile

Methods inherited from class java.lang.Number

byteValue, shortValue

Methods inherited from class java.lang.Object

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

Field Details

serialVersionUID

private static final long serialVersionUID

See Also:

• Constant Field Values

child

final Subscriber<? super T> child

parent

OperatorOnBackpressureLatest.LatestSubscriber<? super T> parent

value

final AtomicReference<Object> value

terminal

Throwable terminal

Written before done, read after done.

done

volatile boolean done

emitting

boolean emitting

Guarded by this.

missed

boolean missed

Guarded by this.

EMPTY

static final Object EMPTY

NOT_REQUESTED

static final long NOT_REQUESTED

See Also:

• Constant Field Values

Constructor Details

LatestEmitter

public LatestEmitter(Subscriber<? super T> child)

Method Details

request

public void request(long n)

Description copied from interface: Producer

Request a certain maximum number of items from this Producer. This is a way of requesting backpressure. To disable backpressure, pass Long.MAX_VALUE to this method.

Requests are additive but if a sequence of requests totals more than Long.MAX_VALUE then Long.MAX_VALUE requests will be actioned and the extras may be ignored. Arriving at Long.MAX_VALUE by addition of requests cannot be assumed to disable backpressure. For example, the code below may result in Long.MAX_VALUE requests being actioned only.

 request(100);
 request(Long.MAX_VALUE-1);
 

Specified by:

request in interface Producer

Parameters:

n - the maximum number of items you want this Producer to produce, or Long.MAX_VALUE if you want the Producer to produce items at its own pace

produced

long produced(long n)

isUnsubscribed

public boolean isUnsubscribed()

Description copied from interface: Subscription

Indicates whether this Subscription is currently unsubscribed.

Specified by:

isUnsubscribed in interface Subscription

Returns:

true if this Subscription is currently unsubscribed, false otherwise

unsubscribe

public void unsubscribe()

Description copied from interface: Subscription

Stops the receipt of notifications on the Subscriber that was registered when this Subscription was received.

This allows unregistering an Subscriber before it has finished receiving all events (i.e. before onCompleted is called).

Specified by:

unsubscribe in interface Subscription

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 method 0 or more times.

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

Specified by:

onNext in interface Observer<T>

Parameters:

t - the item emitted by the Observable

onError

public void onError(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().

Specified by:

onError in interface Observer<T>

Parameters:

e - the exception encountered by the Observable

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).

Specified by:

onCompleted in interface Observer<T>

emit

void emit()