Class DeferredScalarDisposable<T>
- java.lang.Object
-
- java.lang.Number
-
- java.util.concurrent.atomic.AtomicInteger
-
- io.reactivex.rxjava3.internal.observers.BasicIntQueueDisposable<T>
-
- io.reactivex.rxjava3.internal.observers.DeferredScalarDisposable<T>
-
- Type Parameters:
T- the value type received and emitted
- All Implemented Interfaces:
Disposable,QueueDisposable<T>,QueueFuseable<T>,SimpleQueue<T>,java.io.Serializable
- Direct Known Subclasses:
AsyncSubject.AsyncDisposable,DeferredScalarObserver,MaybeToObservable.MaybeToObservableObserver,ObservableCollectWithCollector.CollectorObserver,ObservableFromCompletionStage.CompletionStageHandler,SingleToObservable.SingleToObservableObserver
public class DeferredScalarDisposable<T> extends BasicIntQueueDisposable<T>
Represents a fuseable container for a single value.- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description (package private) static intDISPOSEDIndicates the Disposable has been disposed.protected Observer<? super T>downstreamThe target of the events.(package private) static intFUSED_CONSUMEDIndicates this Disposable is in fusion mode and its value has been consumed.(package private) static intFUSED_EMPTYIndicates this Disposable is in fusion mode and is currently empty.(package private) static intFUSED_READYIndicates this Disposable is in fusion mode and has a value.private static longserialVersionUID(package private) static intTERMINATEDIndicates there was a call to complete(T).protected TvalueThe value stored temporarily when in fusion mode.
-
Constructor Summary
Constructors Constructor Description DeferredScalarDisposable(Observer<? super T> downstream)Constructs a DeferredScalarDisposable by wrapping the Observer.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidclear()Removes all enqueued items from this queue.voidcomplete()Complete the target without any value.voidcomplete(T value)Complete the target with a single value or indicate there is a value available in fusion mode.voiddispose()Dispose the resource, the operation should be idempotent.voiderror(java.lang.Throwable t)Complete the target with an error signal.booleanisDisposed()Returns true if this resource has been disposed.booleanisEmpty()Returns true if the queue is empty.Tpoll()Tries to dequeue a value (non-null) or returns null if the queue is empty.intrequestFusion(int mode)Request a fusion mode from the upstream.booleantryDispose()Try disposing this Disposable and return true if the current thread succeeded.-
Methods inherited from class io.reactivex.rxjava3.internal.observers.BasicIntQueueDisposable
offer, offer
-
Methods inherited from class java.util.concurrent.atomic.AtomicInteger
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
-
-
-
-
Field Detail
-
serialVersionUID
private static final long serialVersionUID
- See Also:
- Constant Field Values
-
value
protected T value
The value stored temporarily when in fusion mode.
-
TERMINATED
static final int TERMINATED
Indicates there was a call to complete(T).- See Also:
- Constant Field Values
-
DISPOSED
static final int DISPOSED
Indicates the Disposable has been disposed.- See Also:
- Constant Field Values
-
FUSED_EMPTY
static final int FUSED_EMPTY
Indicates this Disposable is in fusion mode and is currently empty.- See Also:
- Constant Field Values
-
FUSED_READY
static final int FUSED_READY
Indicates this Disposable is in fusion mode and has a value.- See Also:
- Constant Field Values
-
FUSED_CONSUMED
static final int FUSED_CONSUMED
Indicates this Disposable is in fusion mode and its value has been consumed.- See Also:
- Constant Field Values
-
-
Method Detail
-
requestFusion
public final int requestFusion(int mode)
Description copied from interface:QueueFuseableRequest a fusion mode from the upstream.This should be called before
onSubscribereturns.Calling this method multiple times or after
onSubscribefinished is not allowed and may result in undefined behavior.- Parameters:
mode- the requested fusion mode, allowed values areQueueFuseable.SYNC,QueueFuseable.ASYNC,QueueFuseable.ANYcombined withQueueFuseable.BOUNDARY(e.g.,requestFusion(SYNC | BOUNDARY)).- Returns:
- the established fusion mode:
QueueFuseable.NONE,QueueFuseable.SYNC,QueueFuseable.ASYNC.
-
complete
public final void complete(T value)
Complete the target with a single value or indicate there is a value available in fusion mode.- Parameters:
value- the value to signal, not null (not verified)
-
error
public final void error(java.lang.Throwable t)
Complete the target with an error signal.- Parameters:
t- the Throwable to signal, not null (not verified)
-
complete
public final void complete()
Complete the target without any value.
-
poll
@Nullable public final T poll()
Description copied from interface:SimpleQueueTries to dequeue a value (non-null) or returns null if the queue is empty.If the producer uses
SimpleQueue.offer(Object, Object)and when polling in pairs, if the first poll() returns a non-null item, the second poll() is guaranteed to return a non-null item as well.- Returns:
- the item or null to indicate an empty queue
-
isEmpty
public final boolean isEmpty()
Description copied from interface:SimpleQueueReturns true if the queue is empty.Note however that due to potential fused functions in
SimpleQueue.poll()it is possible this method returns false but then poll() returns null because the fused function swallowed the available item(s).- Returns:
- true if the queue is empty
-
clear
public final void clear()
Description copied from interface:SimpleQueueRemoves all enqueued items from this queue.
-
dispose
public void dispose()
Description copied from interface:DisposableDispose the resource, the operation should be idempotent.
-
tryDispose
public final boolean tryDispose()
Try disposing this Disposable and return true if the current thread succeeded.- Returns:
- true if the current thread succeeded
-
isDisposed
public final boolean isDisposed()
Description copied from interface:DisposableReturns true if this resource has been disposed.- Returns:
- true if this resource has been disposed
-
-