Package rx.internal.operators
Class OperatorReplay.InnerProducer<T>
java.lang.Object
java.lang.Number
java.util.concurrent.atomic.AtomicLong
rx.internal.operators.OperatorReplay.InnerProducer<T>
- Type Parameters:
T
- the value type
- All Implemented Interfaces:
Serializable
,Producer
,Subscription
- Enclosing class:
OperatorReplay<T>
static final class OperatorReplay.InnerProducer<T>
extends AtomicLong
implements Producer, Subscription
A Producer and Subscription that manages the request and unsubscription state of a
child subscriber in thread-safe manner.
We use AtomicLong as a base class to save on extra allocation of an AtomicLong and also
save the overhead of the AtomicIntegerFieldUpdater.
-
Field Summary
FieldsModifier and TypeFieldDescription(package private) Subscriber
<? super T> The actual child subscriber.(package private) boolean
Indicates an emission state.(package private) Object
Holds an object that represents the current location in the buffer.(package private) boolean
Indicates a missed update.(package private) final OperatorReplay.ReplaySubscriber
<T> The parent subscriber-to-source used to allow removing the child in case of child unsubscription.private static final long
(package private) final AtomicLong
Keeps the sum of all requested amounts.(package private) static final long
Indicates this child has been unsubscribed: the state is swapped in atomically and will prevent the dispatch() to emit (too many) values to a terminated child subscriber. -
Constructor Summary
ConstructorsConstructorDescriptionInnerProducer
(OperatorReplay.ReplaySubscriber<T> parent, Subscriber<? super T> child) -
Method Summary
Modifier and TypeMethodDescription(package private) void
addTotalRequested
(long n) Increments the total requested amount.(package private) <U> U
index()
Convenience method to auto-cast the index object.boolean
Indicates whether thisSubscription
is currently unsubscribed.long
produced
(long n) Indicate that values have been emitted to this child subscriber by the dispatch() method.void
request
(long n) Request a certain maximum number of items from this Producer.void
Stops the receipt of notifications on theSubscriber
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
-
Field Details
-
serialVersionUID
private static final long serialVersionUID- See Also:
-
parent
The parent subscriber-to-source used to allow removing the child in case of child unsubscription. -
child
Subscriber<? super T> childThe actual child subscriber. -
index
Object indexHolds an object that represents the current location in the buffer. Guarded by the emitter loop. -
totalRequested
Keeps the sum of all requested amounts. -
emitting
boolean emittingIndicates an emission state. Guarded by this. -
missed
boolean missedIndicates a missed update. Guarded by this. -
UNSUBSCRIBED
static final long UNSUBSCRIBEDIndicates this child has been unsubscribed: the state is swapped in atomically and will prevent the dispatch() to emit (too many) values to a terminated child subscriber.- See Also:
-
-
Constructor Details
-
InnerProducer
-
-
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, passLong.MAX_VALUE
to this method.Requests are additive but if a sequence of requests totals more than
Long.MAX_VALUE
thenLong.MAX_VALUE
requests will be actioned and the extras may be ignored. Arriving atLong.MAX_VALUE
by addition of requests cannot be assumed to disable backpressure. For example, the code below may result inLong.MAX_VALUE
requests being actioned only.request(100); request(Long.MAX_VALUE-1);
-
addTotalRequested
void addTotalRequested(long n) Increments the total requested amount.- Parameters:
n
- the additional request amount
-
produced
public long produced(long n) Indicate that values have been emitted to this child subscriber by the dispatch() method.- Parameters:
n
- the number of items emitted- Returns:
- the updated request value (may indicate how much can be produced or a terminal state)
-
isUnsubscribed
public boolean isUnsubscribed()Description copied from interface:Subscription
Indicates whether thisSubscription
is currently unsubscribed.- Specified by:
isUnsubscribed
in interfaceSubscription
- Returns:
true
if thisSubscription
is currently unsubscribed,false
otherwise
-
unsubscribe
public void unsubscribe()Description copied from interface:Subscription
Stops the receipt of notifications on theSubscriber
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 interfaceSubscription
-
index
<U> U index()Convenience method to auto-cast the index object.- Returns:
-