Top Description Inners Fields Constructors Methods
io.reactivex.internal.operators.flowable

public final Class FlowablePublishAlt<T>

extends ConnectableFlowable<T>
implements HasUpstreamPublisher<T>, ResettableConnectable
Class Inheritance
All Implemented Interfaces
io.reactivex.internal.disposables.ResettableConnectable, io.reactivex.internal.fuseable.HasUpstreamPublisher
Type Parameters
<T>
the element type
Imports
java.util.concurrent.atomic.*, org.reactivestreams.*, io.reactivex.FlowableSubscriber, io.reactivex.disposables.Disposable, io.reactivex.exceptions.*, io.reactivex.flowables.ConnectableFlowable, io.reactivex.functions.Consumer, io.reactivex.internal.disposables.ResettableConnectable, io.reactivex.internal.fuseable.*, io.reactivex.internal.queue.SpscArrayQueue, io.reactivex.internal.subscriptions.SubscriptionHelper, io.reactivex.internal.util.*, io.reactivex.plugins.RxJavaPlugins
Shares a single underlying connection to the upstream Publisher and multicasts events to all subscribed subscribers until the upstream completes or the connection is disposed.

The difference to FlowablePublish is that when the upstream terminates, late subscriberss will receive that terminal event until the connection is disposed and the ConnectableFlowable is reset to its fresh state.

Since
2.2.10

Nested and Inner Type Summary

Modifier and TypeClass and Description
pack-priv static class
FlowablePublishAlt.InnerSubscription<T>

pack-priv static class
FlowablePublishAlt.PublishConnection<T>

Field Summary

Modifier and TypeField and Description
pack-priv final int
bufferSize

pack-priv final AtomicReference<FlowablePublishAlt.PublishConnection<T>>
current

pack-priv final Publisher<T>
source

Constructor Summary

AccessConstructor and Description
public
FlowablePublishAlt(Publisher<T> source, int bufferSize)

Method Summary

Modifier and TypeMethod and Description
public void
connect(Consumer<? super Disposable>
the action that receives the connection subscription before the subscription to source happens allowing the caller to synchronously disconnect a synchronous source
connection)

Implements abstract io.reactivex.flowables.ConnectableFlowable.connect.

Instructs the ConnectableFlowable to begin emitting the items from its underlying Flowable to its Subscribers.
public int

Returns:

The internal buffer size of this FloawblePublishAlt operator.
publishBufferSize()

The internal buffer size of this FloawblePublishAlt operator.

public void
resetIf(Disposable
the disposable received from a previous connect() call.
connection)

Implements io.reactivex.internal.disposables.ResettableConnectable.resetIf.

Reset the connectable source only if the given Disposable connection instance is still representing a connection established by a previous connect() connection.
public Publisher<T>
source()

Implements io.reactivex.internal.fuseable.HasUpstreamPublisher.source.

Returns the source Publisher.
protected void
subscribeActual(Subscriber<? super T>
the incoming Subscriber, never null
s)

Implements abstract io.reactivex.Flowable.subscribeActual.

Operator implementations (both source and intermediate) should implement this method that performs the necessary business logic and handles the incoming Subscribers.
Inherited from io.reactivex.flowables.ConnectableFlowable:
autoConnectautoConnectautoConnectconnectrefCountrefCountrefCountrefCountrefCountrefCount

Field Detail

bufferSizeback to summary
pack-priv final int bufferSize
currentback to summary
pack-priv final AtomicReference<FlowablePublishAlt.PublishConnection<T>> current
sourceback to summary
pack-priv final Publisher<T> source

Constructor Detail

FlowablePublishAltback to summary
public FlowablePublishAlt(Publisher<T> source, int bufferSize)

Method Detail

connectback to summary
public void connect(Consumer<? super Disposable> connection)

Implements abstract io.reactivex.flowables.ConnectableFlowable.connect.

Doc from io.reactivex.flowables.ConnectableFlowable.connect.

Instructs the ConnectableFlowable to begin emitting the items from its underlying Flowable to its Subscribers.

Parameters
connection:Consumer<? super Disposable>

the action that receives the connection subscription before the subscription to source happens allowing the caller to synchronously disconnect a synchronous source

Annotations
@Override
publishBufferSizeback to summary
public int publishBufferSize()

The internal buffer size of this FloawblePublishAlt operator.

Returns:int

The internal buffer size of this FloawblePublishAlt operator.

resetIfback to summary
public void resetIf(Disposable connection)

Implements io.reactivex.internal.disposables.ResettableConnectable.resetIf.

Doc from io.reactivex.internal.disposables.ResettableConnectable.resetIf.

Reset the connectable source only if the given Disposable connection instance is still representing a connection established by a previous connect() connection.

For example, an immediately previous connection should reset the connectable source: 


Disposable d = connectable.connect();

((ResettableConnectable)connectable).resetIf(d);
However, if the connection indicator Disposable is from a much earlier connection, it should not affect the current connection: 

Disposable d1 = connectable.connect();
d.dispose();

Disposable d2 = connectable.connect();

((ResettableConnectable)connectable).resetIf(d);

assertFalse(d2.isDisposed());
Parameters
connection:Disposable

the disposable received from a previous connect() call.

Annotations
@SuppressWarnings:unchecked
@Override
sourceback to summary
public Publisher<T> source()

Implements io.reactivex.internal.fuseable.HasUpstreamPublisher.source.

Doc from io.reactivex.internal.fuseable.HasUpstreamPublisher.source.

Returns the source Publisher.

This method is intended to discover the assembly graph of sequences.

Returns:Publisher<T>

the source Publisher

Annotations
@Override
subscribeActualback to summary
protected void subscribeActual(Subscriber<? super T> s)

Implements abstract io.reactivex.Flowable.subscribeActual.

Doc from io.reactivex.Flowable.subscribeActual.

Operator implementations (both source and intermediate) should implement this method that performs the necessary business logic and handles the incoming Subscribers.

There is no need to call any of the plugin hooks on the current Flowable instance or the Subscriber; all hooks and basic safeguards have been applied by subscribe(Subscriber) before this method gets called.

Parameters
s:Subscriber<? super T>

the incoming Subscriber, never null

Annotations
@Override
io.reactivex.internal.operators.flowable back to summary

pack-priv final Class FlowablePublishAlt.InnerSubscription<T>

extends AtomicLong
implements Subscription
Class Inheritance
All Implemented Interfaces
org.reactivestreams.Subscription

Field Summary

Modifier and TypeField and Description
pack-priv final Subscriber<? super T>
downstream

pack-priv long
emitted

pack-priv final FlowablePublishAlt.PublishConnection<T>
parent

private static final long
serialVersionUID

Hides java.util.concurrent.atomic.AtomicLong.serialVersionUID.

Constructor Summary

AccessConstructor and Description
pack-priv
InnerSubscription(Subscriber<? super T> downstream, FlowablePublishAlt.PublishConnection<T> parent)

Method Summary

Modifier and TypeMethod and Description
public void
cancel()

Implements org.reactivestreams.Subscription.cancel.

Request the Publisher to stop sending data and clean up resources.
public boolean
isCancelled()

public void
request(long
the strictly positive number of elements to requests to the upstream Publisher
n)

Implements org.reactivestreams.Subscription.request.

No events will be sent by a Publisher until demand is signaled via this method.
Inherited from java.util.concurrent.atomic.AtomicLong:
accumulateAndGetaddAndGetcompareAndExchangecompareAndExchangeAcquirecompareAndExchangeReleasecompareAndSetdecrementAndGetdoubleValuefloatValuegetgetAcquiregetAndAccumulategetAndAddgetAndDecrementgetAndIncrementgetAndSetgetAndUpdategetOpaquegetPlainincrementAndGetintValuelazySetlongValuesetsetOpaquesetPlainsetReleasetoStringupdateAndGetweakCompareAndSetweakCompareAndSetAcquireweakCompareAndSetPlainweakCompareAndSetReleaseweakCompareAndSetVolatile

Field Detail

downstreamback to summary
pack-priv final Subscriber<? super T> downstream
emittedback to summary
pack-priv long emitted
parentback to summary
pack-priv final FlowablePublishAlt.PublishConnection<T> parent
serialVersionUIDback to summary
private static final long serialVersionUID

Hides java.util.concurrent.atomic.AtomicLong.serialVersionUID.

Constructor Detail

InnerSubscriptionback to summary
pack-priv InnerSubscription(Subscriber<? super T> downstream, FlowablePublishAlt.PublishConnection<T> parent)

Method Detail

cancelback to summary
public void cancel()

Implements org.reactivestreams.Subscription.cancel.

Doc from org.reactivestreams.Subscription.cancel.

Request the Publisher to stop sending data and clean up resources.

Data may still be sent to meet previously signalled demand after calling cancel.

Annotations
@Override
isCancelledback to summary
public boolean isCancelled()
requestback to summary
public void request(long n)

Implements org.reactivestreams.Subscription.request.

Doc from org.reactivestreams.Subscription.request.

No events will be sent by a Publisher until demand is signaled via this method.

It can be called however often and whenever needed—but if the outstanding cumulative demand ever becomes Long.MAX_VALUE or more, it may be treated by the Publisher as "effectively unbounded".

Whatever has been requested can be sent by the Publisher so only signal demand for what can be safely handled.

A Publisher can send less than is requested if the stream ends but then must emit either Subscriber#onError(Throwable) or Subscriber#onComplete().

Parameters
n:long

the strictly positive number of elements to requests to the upstream Publisher

Annotations
@Override
io.reactivex.internal.operators.flowable back to summary

pack-priv final Class FlowablePublishAlt.PublishConnection<T>

extends AtomicInteger
implements FlowableSubscriber<T>, Disposable
Class Inheritance
All Implemented Interfaces
io.reactivex.disposables.Disposable, io.reactivex.FlowableSubscriber, org.reactivestreams.Subscriber

Field Summary

Modifier and TypeField and Description
pack-priv final int
bufferSize

pack-priv final AtomicBoolean
connect

pack-priv int
consumed

pack-priv final AtomicReference<FlowablePublishAlt.PublishConnection<T>>
current

pack-priv volatile boolean
done

pack-priv static final FlowablePublishAlt.InnerSubscription<T>[]
EMPTY

pack-priv Throwable
error

pack-priv volatile SimpleQueue<T>
queue

private static final long
serialVersionUID

Hides java.util.concurrent.atomic.AtomicInteger.serialVersionUID.

pack-priv int
sourceMode

pack-priv final AtomicReference<FlowablePublishAlt.InnerSubscription<T>[]>
subscribers

pack-priv static final FlowablePublishAlt.InnerSubscription<T>[]
TERMINATED

pack-priv final AtomicReference<Subscription>
upstream

Constructor Summary

AccessConstructor and Description
pack-priv
PublishConnection(AtomicReference<FlowablePublishAlt.PublishConnection<T>> current, int bufferSize)

Method Summary

Modifier and TypeMethod and Description
pack-priv boolean
add(FlowablePublishAlt.InnerSubscription<T> inner)

pack-priv boolean
checkTerminated(boolean isDone, boolean isEmpty)

public void
dispose()

Implements io.reactivex.disposables.Disposable.dispose.

Dispose the resource, the operation should be idempotent.
pack-priv void
drain()

public boolean
isDisposed()

Implements io.reactivex.disposables.Disposable.isDisposed.

Returns true if this resource has been disposed.
public void
onComplete()

Implements org.reactivestreams.Subscriber.onComplete.

Successful terminal state.
public void
onError(Throwable
the throwable signaled
t)

Implements org.reactivestreams.Subscriber.onError.

Failed terminal state.
public void
onNext(T
the element signaled
t)

Implements org.reactivestreams.Subscriber.onNext.

Data notification sent by the Publisher in response to requests to Subscription#request(long).
public void
onSubscribe(Subscription
the Subscription that allows requesting data via Subscription#request(long)
s)

Implements io.reactivex.FlowableSubscriber.onSubscribe.

Implementors of this method should make sure everything that needs to be visible in onNext(Object) is established before calling Subscription#request(long).
pack-priv void
remove(FlowablePublishAlt.InnerSubscription<T> inner)

pack-priv void
signalError(Throwable ex)

Inherited from java.util.concurrent.atomic.AtomicInteger:
accumulateAndGetaddAndGetcompareAndExchangecompareAndExchangeAcquirecompareAndExchangeReleasecompareAndSetdecrementAndGetdoubleValuefloatValuegetgetAcquiregetAndAccumulategetAndAddgetAndDecrementgetAndIncrementgetAndSetgetAndUpdategetOpaquegetPlainincrementAndGetintValuelazySetlongValuesetsetOpaquesetPlainsetReleasetoStringupdateAndGetweakCompareAndSetweakCompareAndSetAcquireweakCompareAndSetPlainweakCompareAndSetReleaseweakCompareAndSetVolatile

Field Detail

bufferSizeback to summary
pack-priv final int bufferSize
connectback to summary
pack-priv final AtomicBoolean connect
consumedback to summary
pack-priv int consumed
currentback to summary
pack-priv final AtomicReference<FlowablePublishAlt.PublishConnection<T>> current
doneback to summary
pack-priv volatile boolean done
EMPTYback to summary
pack-priv static final FlowablePublishAlt.InnerSubscription<T>[] EMPTY
Annotations
@SuppressWarnings:rawtypes
errorback to summary
pack-priv Throwable error
queueback to summary
pack-priv volatile SimpleQueue<T> queue
serialVersionUIDback to summary
private static final long serialVersionUID

Hides java.util.concurrent.atomic.AtomicInteger.serialVersionUID.

sourceModeback to summary
pack-priv int sourceMode
subscribersback to summary
pack-priv final AtomicReference<FlowablePublishAlt.InnerSubscription<T>[]> subscribers
TERMINATEDback to summary
pack-priv static final FlowablePublishAlt.InnerSubscription<T>[] TERMINATED
Annotations
@SuppressWarnings:rawtypes
upstreamback to summary
pack-priv final AtomicReference<Subscription> upstream

Constructor Detail

PublishConnectionback to summary
pack-priv PublishConnection(AtomicReference<FlowablePublishAlt.PublishConnection<T>> current, int bufferSize)
Annotations
@SuppressWarnings:unchecked

Method Detail

addback to summary
pack-priv boolean add(FlowablePublishAlt.InnerSubscription<T> inner)
checkTerminatedback to summary
pack-priv boolean checkTerminated(boolean isDone, boolean isEmpty)
Annotations
@SuppressWarnings:unchecked
disposeback to summary
public void dispose()

Implements io.reactivex.disposables.Disposable.dispose.

Doc from io.reactivex.disposables.Disposable.dispose.

Dispose the resource, the operation should be idempotent.

Annotations
@SuppressWarnings:unchecked
@Override
drainback to summary
pack-priv void drain()
isDisposedback to summary
public boolean isDisposed()

Implements io.reactivex.disposables.Disposable.isDisposed.

Doc from io.reactivex.disposables.Disposable.isDisposed.

Returns true if this resource has been disposed.

Returns:boolean

true if this resource has been disposed

Annotations
@Override
onCompleteback to summary
public void onComplete()

Implements org.reactivestreams.Subscriber.onComplete.

Doc from org.reactivestreams.Subscriber.onComplete.

Successful terminal state.

No further events will be sent even if Subscription#request(long) is invoked again.

Annotations
@Override
onErrorback to summary
public void onError(Throwable t)

Implements org.reactivestreams.Subscriber.onError.

Doc from org.reactivestreams.Subscriber.onError.

Failed terminal state.

No further events will be sent even if Subscription#request(long) is invoked again.

Parameters
t:Throwable

the throwable signaled

Annotations
@Override
onNextback to summary
public void onNext(T t)

Implements org.reactivestreams.Subscriber.onNext.

Doc from org.reactivestreams.Subscriber.onNext.

Data notification sent by the Publisher in response to requests to Subscription#request(long).

Parameters
t:T

the element signaled

Annotations
@Override
onSubscribeback to summary
public void onSubscribe(Subscription s)

Implements io.reactivex.FlowableSubscriber.onSubscribe.

Doc from io.reactivex.FlowableSubscriber.onSubscribe.

Implementors of this method should make sure everything that needs to be visible in onNext(Object) is established before calling Subscription#request(long). In practice this means no initialization should happen after the request() call and additional behavior is thread safe in respect to onNext. Invoked after calling Publisher#subscribe(Subscriber).

No data will start flowing until Subscription#request(long) is invoked.

It is the responsibility of this Subscriber instance to call Subscription#request(long) whenever more data is wanted.

The Publisher will send notifications only in response to Subscription#request(long).

Parameters
s:Subscription

Doc from org.reactivestreams.Subscriber.onSubscribe.

the Subscription that allows requesting data via Subscription#request(long)

Annotations
@Override
removeback to summary
pack-priv void remove(FlowablePublishAlt.InnerSubscription<T> inner)
Annotations
@SuppressWarnings:unchecked
signalErrorback to summary
pack-priv void signalError(Throwable ex)
Annotations
@SuppressWarnings:unchecked