Package io.reactivex.rxjava3.internal.jdk8

Class ObservableFromStream.StreamDisposable<T>

java.lang.Object

io.reactivex.rxjava3.internal.jdk8.ObservableFromStream.StreamDisposable<T>

All Implemented Interfaces:

Disposable, QueueDisposable<T>, QueueFuseable<T>, SimpleQueue<T>

Enclosing class:

ObservableFromStream<T>

static final class ObservableFromStream.StreamDisposable<T>
extends java.lang.Object
implements QueueDisposable<T>

Field Summary

Fields

Modifier and Type	Field	Description
(package private) java.lang.AutoCloseable	closeable
(package private) boolean	disposed
(package private) Observer<? super T>	downstream
(package private) java.util.Iterator<T>	iterator
(package private) boolean	once
(package private) boolean	outputFused

Fields inherited from interface io.reactivex.rxjava3.operators.QueueFuseable

ANY, ASYNC, BOUNDARY, NONE, SYNC

Constructor Summary

Constructors

Constructor	Description
StreamDisposable(Observer<? super T> downstream, java.util.Iterator<T> iterator, java.lang.AutoCloseable closeable)

Method Summary

Modifier and Type	Method	Description
void	clear()	Removes all enqueued items from this queue.
void	dispose()	Dispose the resource, the operation should be idempotent.
boolean	isDisposed()	Returns true if this resource has been disposed.
boolean	isEmpty()	Returns true if the queue is empty.
boolean	offer(T value)	Atomically enqueue a single value.
boolean	offer(T v1, T v2)	Atomically enqueue two values.
T	poll()	Tries to dequeue a value (non-null) or returns null if the queue is empty.
int	requestFusion(int mode)	Request a fusion mode from the upstream.
void	run()

Methods inherited from class java.lang.Object

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

Field Detail

downstream

final Observer<? super T> downstream

iterator

java.util.Iterator<T> iterator

closeable

java.lang.AutoCloseable closeable

disposed

volatile boolean disposed

once

boolean once

outputFused

boolean outputFused

Constructor Detail

StreamDisposable

StreamDisposable(Observer<? super T> downstream,
                 java.util.Iterator<T> iterator,
                 java.lang.AutoCloseable closeable)

Method Detail

dispose

public void dispose()

Description copied from interface: Disposable

Dispose the resource, the operation should be idempotent.

Specified by:

dispose in interface Disposable

isDisposed

public boolean isDisposed()

Description copied from interface: Disposable

Returns true if this resource has been disposed.

Specified by:

isDisposed in interface Disposable

Returns:

true if this resource has been disposed

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 interface QueueFuseable<T>

Parameters:

mode - the requested fusion mode, allowed values are QueueFuseable.SYNC, QueueFuseable.ASYNC, QueueFuseable.ANY combined with QueueFuseable.BOUNDARY (e.g., requestFusion(SYNC | BOUNDARY)).

Returns:

the established fusion mode: QueueFuseable.NONE, QueueFuseable.SYNC, QueueFuseable.ASYNC.

offer

public boolean offer(@NonNull
                     T value)

Description copied from interface: SimpleQueue

Atomically enqueue a single value.

Specified by:

offer in interface SimpleQueue<T>

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

public boolean offer(@NonNull
                     T v1,
                     @NonNull
                     T v2)

Description copied from interface: SimpleQueue

Atomically enqueue two values.

Specified by:

offer in interface SimpleQueue<T>

Parameters:

v1 - the first value to enqueue, not null

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

poll

@Nullable
public T 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 interface SimpleQueue<T>

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 interface SimpleQueue<T>

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 interface SimpleQueue<T>

run

public void run()