Enum Class EmptySubscription
- All Implemented Interfaces:
QueueFuseable<Object>
,QueueSubscription<Object>
,SimpleQueue<Object>
,Serializable
,Comparable<EmptySubscription>
,Constable
,org.reactivestreams.Subscription
-
Nested Class Summary
Nested classes/interfaces inherited from class java.lang.Enum
Enum.EnumDesc<E extends Enum<E>>
-
Enum Constant Summary
Enum Constants -
Field Summary
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
cancel()
void
clear()
Removes all enqueued items from this queue.static void
complete
(org.reactivestreams.Subscriber<?> s) Sets the empty subscription instance on the subscriber and then calls onComplete.static void
Sets the empty subscription instance on the subscriber and then calls onError with the supplied error.boolean
isEmpty()
Returns true if the queue is empty.boolean
Atomically enqueue a single value.boolean
Atomically enqueue two values.poll()
Tries to dequeue a value (non-null) or returns null if the queue is empty.void
request
(long n) int
requestFusion
(int mode) Request a fusion mode from the upstream.toString()
static EmptySubscription
Returns the enum constant of this class with the specified name.static EmptySubscription[]
values()
Returns an array containing the constants of this enum class, in the order they are declared.
-
Enum Constant Details
-
INSTANCE
A singleton, stateless instance.
-
-
Constructor Details
-
EmptySubscription
private EmptySubscription()
-
-
Method Details
-
values
Returns an array containing the constants of this enum class, in the order they are declared.- Returns:
- an array containing the constants of this enum class, in the order they are declared
-
valueOf
Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)- Parameters:
name
- the name of the enum constant to be returned.- Returns:
- the enum constant with the specified name
- Throws:
IllegalArgumentException
- if this enum class has no constant with the specified nameNullPointerException
- if the argument is null
-
request
public void request(long n) - Specified by:
request
in interfaceorg.reactivestreams.Subscription
-
cancel
public void cancel()- Specified by:
cancel
in interfaceorg.reactivestreams.Subscription
-
toString
- Overrides:
toString
in classEnum<EmptySubscription>
-
error
Sets the empty subscription instance on the subscriber and then calls onError with the supplied error.Make sure this is only called if the subscriber hasn't received a subscription already (there is no way of telling this).
- Parameters:
e
- the error to deliver to the subscribers
- the target subscriber
-
complete
public static void complete(org.reactivestreams.Subscriber<?> s) Sets the empty subscription instance on the subscriber and then calls onComplete.Make sure this is only called if the subscriber hasn't received a subscription already (there is no way of telling this).
- Parameters:
s
- the target subscriber
-
poll
Description copied from interface:SimpleQueue
Tries 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.- Specified by:
poll
in interfaceSimpleQueue<Object>
- Returns:
- the item or null to indicate an empty queue
-
isEmpty
public boolean isEmpty()Description copied from interface:SimpleQueue
Returns 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).- Specified by:
isEmpty
in interfaceSimpleQueue<Object>
- Returns:
- true if the queue is empty
-
clear
public void clear()Description copied from interface:SimpleQueue
Removes all enqueued items from this queue.- Specified by:
clear
in interfaceSimpleQueue<Object>
-
requestFusion
public int requestFusion(int mode) Description copied from interface:QueueFuseable
Request a fusion mode from the upstream.This should be called before
onSubscribe
returns.Calling this method multiple times or after
onSubscribe
finished is not allowed and may result in undefined behavior.- Specified by:
requestFusion
in interfaceQueueFuseable<Object>
- Parameters:
mode
- the requested fusion mode, allowed values areQueueFuseable.SYNC
,QueueFuseable.ASYNC
,QueueFuseable.ANY
combined withQueueFuseable.BOUNDARY
(e.g.,requestFusion(SYNC | BOUNDARY)
).- Returns:
- the established fusion mode:
QueueFuseable.NONE
,QueueFuseable.SYNC
,QueueFuseable.ASYNC
.
-
offer
Description copied from interface:SimpleQueue
Atomically enqueue a single value.- Specified by:
offer
in interfaceSimpleQueue<Object>
- Parameters:
value
- the value to enqueue, not null- Returns:
- true if successful, false if the value was not enqueued likely due to reaching the queue capacity)
-
offer
Description copied from interface:SimpleQueue
Atomically enqueue two values.- Specified by:
offer
in interfaceSimpleQueue<Object>
- Parameters:
v1
- the first value to enqueue, not nullv2
- the second value to enqueue, not null- Returns:
- true if successful, false if the value was not enqueued likely due to reaching the queue capacity)
-