reactor.core.publisher

Class TopicProcessor.Builder<T>

java.lang.Object

reactor.core.publisher.TopicProcessor.Builder<T>

Type Parameters:

T - Type of dispatched signal

Enclosing class:

TopicProcessor<E>

public static final class TopicProcessor.Builder<T>
extends Object

TopicProcessor builder that can be used to create new processors. Instantiate it through the TopicProcessor.builder() static method:

TopicProcessor<String> processor = TopicProcessor.<String>builder().build()

Method Summary

Modifier and Type	Method and Description
TopicProcessor.Builder<T>	autoCancel(boolean autoCancel) Configures auto-cancel for this builder.
TopicProcessor.Builder<T>	bufferSize(int bufferSize) Configures buffer size for this builder.
TopicProcessor<T>	build() Creates a new TopicProcessor using the properties of this builder.
TopicProcessor.Builder<T>	executor(ExecutorService executor) Configures an ExecutorService to execute as many event-loop consuming the ringbuffer as subscribers.
TopicProcessor.Builder<T>	name(String name) Configures name for this builder.
TopicProcessor.Builder<T>	requestTaskExecutor(ExecutorService requestTaskExecutor) Configures an additional ExecutorService that is used internally on each subscription.
TopicProcessor.Builder<T>	share(boolean share) Configures sharing state for this builder.
TopicProcessor.Builder<T>	signalSupplier(Supplier<T> signalSupplier) Configures a supplier of dispatched signals to preallocate in the ring buffer
TopicProcessor.Builder<T>	waitStrategy(WaitStrategy waitStrategy) Configures wait strategy for this builder.

Methods inherited from class java.lang.Object

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

Method Detail

name

public TopicProcessor.Builder<T> name(@Nullable
                                      String name)

Configures name for this builder. Default value is TopicProcessor. Name is set to default if the provided name is null.

Parameters:

name - Use a new cached ExecutorService and assign this name to the created threads if executor(ExecutorService) is not configured.

Returns:

builder with provided name

bufferSize

public TopicProcessor.Builder<T> bufferSize(int bufferSize)

Configures buffer size for this builder. Default value is Queues.SMALL_BUFFER_SIZE.

Parameters:

bufferSize - the internal buffer size to hold signals, must be a power of 2.

Returns:

builder with provided buffer size

waitStrategy

public TopicProcessor.Builder<T> waitStrategy(@Nullable
                                              WaitStrategy waitStrategy)

Configures wait strategy for this builder. Default value is WaitStrategy.phasedOffLiteLock(long, long, TimeUnit). Wait strategy is set to default if the provided waitStrategy is null.

Parameters:

waitStrategy - A RingBuffer WaitStrategy to use instead of the default blocking wait strategy.

Returns:

builder with provided wait strategy

autoCancel

public TopicProcessor.Builder<T> autoCancel(boolean autoCancel)

Configures auto-cancel for this builder. Default value is true.

Parameters:

autoCancel - automatically cancel

Returns:

builder with provided auto-cancel

executor

public TopicProcessor.Builder<T> executor(@Nullable
                                          ExecutorService executor)

Configures an ExecutorService to execute as many event-loop consuming the ringbuffer as subscribers. Name configured using name(String) will be ignored if executor is set.

Parameters:

executor - A provided ExecutorService to manage threading infrastructure

Returns:

builder with provided executor

requestTaskExecutor

public TopicProcessor.Builder<T> requestTaskExecutor(@Nullable
                                                     ExecutorService requestTaskExecutor)

Configures an additional ExecutorService that is used internally on each subscription.

Parameters:

requestTaskExecutor - internal request executor

Returns:

builder with provided internal request executor

share

public TopicProcessor.Builder<T> share(boolean share)

Configures sharing state for this builder. A shared Processor authorizes concurrent onNext calls and is suited for multi-threaded publisher that will fan-in data.

Parameters:

share - true to support concurrent onNext calls

Returns:

builder with specified sharing

signalSupplier

public TopicProcessor.Builder<T> signalSupplier(@Nullable
                                                Supplier<T> signalSupplier)

Configures a supplier of dispatched signals to preallocate in the ring buffer

Parameters:

signalSupplier - A supplier of dispatched signals to preallocate

Returns:

builder with provided signal supplier

build

public TopicProcessor<T> build()

Creates a new TopicProcessor using the properties of this builder.

Returns:

a fresh processor