Class QueuedProducer<T>
- Type Parameters:
T
- the value type
- All Implemented Interfaces:
Serializable
,Observer<T>
,Producer
- See Also:
-
Field Summary
FieldsModifier and TypeFieldDescription(package private) final Subscriber
<? super T> (package private) boolean
(package private) Throwable
(package private) static final Object
private static final long
(package private) final AtomicInteger
-
Constructor Summary
ConstructorsConstructorDescriptionQueuedProducer
(Subscriber<? super T> child) Constructs an instance with the target child subscriber and an Spsc Linked (Atomic) Queue as the queue implementation.QueuedProducer
(Subscriber<? super T> child, Queue<Object> queue) Constructs an instance with the target child subscriber and a custom queue implementation -
Method Summary
Modifier and TypeMethodDescriptionprivate boolean
checkTerminated
(boolean isDone, boolean isEmpty) private void
drain()
boolean
Offers a value to this producer and tries to emit any queued values if the child requests allow it.void
Notifies the Observer that theObservable
has finished sending push-based notifications.void
Notifies the Observer that theObservable
has experienced an error condition.void
Provides the Observer with a new item to observe.void
request
(long n) Request a certain maximum number of items from this Producer.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:
-
child
-
queue
-
wip
-
error
Throwable error -
done
volatile boolean done -
NULL_SENTINEL
-
-
Constructor Details
-
QueuedProducer
Constructs an instance with the target child subscriber and an Spsc Linked (Atomic) Queue as the queue implementation.- Parameters:
child
- the target child subscriber
-
QueuedProducer
Constructs an instance with the target child subscriber and a custom queue implementation- Parameters:
child
- the target child subscriberqueue
- the queue to use
-
-
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);
-
offer
Offers a value to this producer and tries to emit any queued values if the child requests allow it.- Parameters:
value
- the value to enqueue and attempt to drain- Returns:
- true if the queue accepted the offer, false otherwise
-
onNext
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 eitherObserver.onCompleted()
orObserver.onError(java.lang.Throwable)
. -
onError
Description copied from interface:Observer
Notifies the Observer that theObservable
has experienced an error condition.If the
Observable
calls this method, it will not thereafter callObserver.onNext(T)
orObserver.onCompleted()
. -
onCompleted
public void onCompleted()Description copied from interface:Observer
Notifies the Observer that theObservable
has finished sending push-based notifications.The
Observable
will not call this method if it callsObserver.onError(java.lang.Throwable)
.- Specified by:
onCompleted
in interfaceObserver<T>
-
checkTerminated
private boolean checkTerminated(boolean isDone, boolean isEmpty) -
drain
private void drain()
-