com.alipay.disruptor.dsl

类 Disruptor<T>

java.lang.Object

com.alipay.disruptor.dsl.Disruptor<T>

类型参数:

T - the type of event used.

public class Disruptor<T>
extends Object

A DSL-style API for setting up the disruptor pattern around a ring buffer (aka the Builder pattern).

A simple example of setting up the disruptor with two event handlers that must process events in order:

 Disruptor<MyEvent> disruptor = new Disruptor<MyEvent>(MyEvent.FACTORY, 32, Executors.newCachedThreadPool());
 EventHandler<MyEvent> handler1 = new EventHandler<MyEvent>() { ... };
 EventHandler<MyEvent> handler2 = new EventHandler<MyEvent>() { ... };
 disruptor.handleEventsWith(handler1);
 disruptor.after(handler1).handleEventsWith(handler2);

 RingBuffer ringBuffer = disruptor.start();
 

构造器概要

构造器

构造器和说明
Disruptor(EventFactory<T> eventFactory, int ringBufferSize, Executor executor) 已过时。 Use a ThreadFactory instead of an Executor as a the ThreadFactory is able to report errors when it is unable to construct a thread to run a producer.
Disruptor(EventFactory<T> eventFactory, int ringBufferSize, Executor executor, ProducerType producerType, WaitStrategy waitStrategy) 已过时。 Use a ThreadFactory instead of an Executor as a the ThreadFactory is able to report errors when it is unable to construct a thread to run a producer.
Disruptor(EventFactory<T> eventFactory, int ringBufferSize, ThreadFactory threadFactory) Create a new Disruptor.
Disruptor(EventFactory<T> eventFactory, int ringBufferSize, ThreadFactory threadFactory, ProducerType producerType, WaitStrategy waitStrategy) Create a new Disruptor.

方法概要

方法

限定符和类型	方法和说明
EventHandlerGroup<T>	after(EventHandler<T>... handlers) Create a group of event handlers to be used as a dependency.
EventHandlerGroup<T>	after(EventProcessor... processors) Create a group of event processors to be used as a dependency.
T	get(long sequence) Get the event for a given sequence in the RingBuffer.
SequenceBarrier	getBarrierFor(EventHandler<T> handler) Get the SequenceBarrier used by a specific handler.
long	getBufferSize() The capacity of the data structure to hold entries.
long	getCursor() Get the value of the cursor indicating the published sequence.
RingBuffer<T>	getRingBuffer() The RingBuffer used by this Disruptor.
long	getSequenceValueFor(EventHandler<T> b1) Gets the sequence value for the specified event handlers.
void	halt() Calls EventProcessor.halt() on all of the event processors created via this disruptor.
EventHandlerGroup<T>	handleEventsWith(EventHandler<? super T>... handlers) Set up event handlers to handle events from the ring buffer.
EventHandlerGroup<T>	handleEventsWith(EventProcessor... processors) Set up custom event processors to handle events from the ring buffer.
EventHandlerGroup<T>	handleEventsWith(EventProcessorFactory<T>... eventProcessorFactories) Set up custom event processors to handle events from the ring buffer.
EventHandlerGroup<T>	handleEventsWithWorkerPool(WorkHandler<T>... workHandlers) Set up a WorkerPool to distribute an event to one of a pool of work handler threads.
ExceptionHandlerSetting<T>	handleExceptionsFor(EventHandler<T> eventHandler) Override the default exception handler for a specific handler.
void	handleExceptionsWith(ExceptionHandler<? super T> exceptionHandler) 已过时。 This method only applies to future event handlers. Use setDefaultExceptionHandler instead which applies to existing and new event handlers.
void	publishEvent(EventTranslator<T> eventTranslator) Publish an event to the ring buffer.
<A> void	publishEvent(EventTranslatorOneArg<T,A> eventTranslator, A arg) Publish an event to the ring buffer.
<A> void	publishEvents(EventTranslatorOneArg<T,A> eventTranslator, A[] arg) Publish a batch of events to the ring buffer.
void	setDefaultExceptionHandler(ExceptionHandler<? super T> exceptionHandler) Specify an exception handler to be used for event handlers and worker pools created by this Disruptor.
void	shutdown() Waits until all events currently in the disruptor have been processed by all event processors and then halts the processors.
void	shutdown(long timeout, TimeUnit timeUnit) Waits until all events currently in the disruptor have been processed by all event processors and then halts the processors.
RingBuffer<T>	start() Starts the event processors and returns the fully configured ring buffer.
String	toString()

从类继承的方法 java.lang.Object

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

构造器详细资料

Disruptor

@Deprecated
public Disruptor(EventFactory<T> eventFactory,
                    int ringBufferSize,
                    Executor executor)

已过时。 Use a ThreadFactory instead of an Executor as a the ThreadFactory is able to report errors when it is unable to construct a thread to run a producer.

Create a new Disruptor. Will default to BlockingWaitStrategy and ProducerType.MULTI

参数:

eventFactory - the factory to create events in the ring buffer.

ringBufferSize - the size of the ring buffer.

executor - an Executor to execute event processors.

Disruptor

@Deprecated
public Disruptor(EventFactory<T> eventFactory,
                    int ringBufferSize,
                    Executor executor,
                    ProducerType producerType,
                    WaitStrategy waitStrategy)

已过时。 Use a ThreadFactory instead of an Executor as a the ThreadFactory is able to report errors when it is unable to construct a thread to run a producer.

Create a new Disruptor.

参数:

eventFactory - the factory to create events in the ring buffer.

ringBufferSize - the size of the ring buffer, must be power of 2.

executor - an Executor to execute event processors.

producerType - the claim strategy to use for the ring buffer.

waitStrategy - the wait strategy to use for the ring buffer.

Disruptor

public Disruptor(EventFactory<T> eventFactory,
         int ringBufferSize,
         ThreadFactory threadFactory)

Create a new Disruptor. Will default to BlockingWaitStrategy and ProducerType.MULTI

参数:

eventFactory - the factory to create events in the ring buffer.

ringBufferSize - the size of the ring buffer.

threadFactory - a ThreadFactory to create threads to for processors.

Disruptor

public Disruptor(EventFactory<T> eventFactory,
         int ringBufferSize,
         ThreadFactory threadFactory,
         ProducerType producerType,
         WaitStrategy waitStrategy)

Create a new Disruptor.

参数:

eventFactory - the factory to create events in the ring buffer.

ringBufferSize - the size of the ring buffer, must be power of 2.

threadFactory - a ThreadFactory to create threads for processors.

producerType - the claim strategy to use for the ring buffer.

waitStrategy - the wait strategy to use for the ring buffer.

方法详细资料

handleEventsWith

public EventHandlerGroup<T> handleEventsWith(EventHandler<? super T>... handlers)

Set up event handlers to handle events from the ring buffer. These handlers will process events as soon as they become available, in parallel.

This method can be used as the start of a chain. For example if the handler A must process events before handler B:

dw.handleEventsWith(A).then(B);

参数:

handlers - the event handlers that will process events.

返回:

a EventHandlerGroup that can be used to chain dependencies.

handleEventsWith

public EventHandlerGroup<T> handleEventsWith(EventProcessorFactory<T>... eventProcessorFactories)

Set up custom event processors to handle events from the ring buffer. The Disruptor will automatically start these processors when start() is called.

This method can be used as the start of a chain. For example if the handler A must process events before handler B:

dw.handleEventsWith(A).then(B);

Since this is the start of the chain, the processor factories will always be passed an empty Sequence array, so the factory isn't necessary in this case. This method is provided for consistency with EventHandlerGroup.handleEventsWith(EventProcessorFactory...) and EventHandlerGroup.then(EventProcessorFactory...) which do have barrier sequences to provide.

参数:

eventProcessorFactories - the event processor factories to use to create the event processors that will process events.

返回:

a EventHandlerGroup that can be used to chain dependencies.

handleEventsWith

public EventHandlerGroup<T> handleEventsWith(EventProcessor... processors)

Set up custom event processors to handle events from the ring buffer. The Disruptor will automatically start this processors when start() is called.

This method can be used as the start of a chain. For example if the processor A must process events before handler B:

dw.handleEventsWith(A).then(B);

参数:

processors - the event processors that will process events.

返回:

a EventHandlerGroup that can be used to chain dependencies.

handleEventsWithWorkerPool

public EventHandlerGroup<T> handleEventsWithWorkerPool(WorkHandler<T>... workHandlers)

Set up a WorkerPool to distribute an event to one of a pool of work handler threads. Each event will only be processed by one of the work handlers. The Disruptor will automatically start this processors when start() is called.

参数:

workHandlers - the work handlers that will process events.

返回:

a EventHandlerGroup that can be used to chain dependencies.

handleExceptionsWith

public void handleExceptionsWith(ExceptionHandler<? super T> exceptionHandler)

已过时。 This method only applies to future event handlers. Use setDefaultExceptionHandler instead which applies to existing and new event handlers.

Specify an exception handler to be used for any future event handlers.

Note that only event handlers set up after calling this method will use the exception handler.

参数:

exceptionHandler - the exception handler to use for any future EventProcessor.

setDefaultExceptionHandler

public void setDefaultExceptionHandler(ExceptionHandler<? super T> exceptionHandler)

Specify an exception handler to be used for event handlers and worker pools created by this Disruptor.

The exception handler will be used by existing and future event handlers and worker pools created by this Disruptor instance.

参数:

exceptionHandler - the exception handler to use.

handleExceptionsFor

public ExceptionHandlerSetting<T> handleExceptionsFor(EventHandler<T> eventHandler)

Override the default exception handler for a specific handler.

disruptorWizard.handleExceptionsIn(eventHandler).with(exceptionHandler);

参数:

eventHandler - the event handler to set a different exception handler for.

返回:

an ExceptionHandlerSetting dsl object - intended to be used by chaining the with method call.

after

public EventHandlerGroup<T> after(EventHandler<T>... handlers)

Create a group of event handlers to be used as a dependency. For example if the handler A must process events before handler B:

dw.after(A).handleEventsWith(B);

参数:

handlers - the event handlers, previously set up with handleEventsWith(com.alipay.disruptor.EventHandler[]), that will form the barrier for subsequent handlers or processors.

返回:

an EventHandlerGroup that can be used to setup a dependency barrier over the specified event handlers.

after

public EventHandlerGroup<T> after(EventProcessor... processors)

Create a group of event processors to be used as a dependency.

参数:

processors - the event processors, previously set up with handleEventsWith(com.alipay.disruptor.EventProcessor...), that will form the barrier for subsequent handlers or processors.

返回:

an EventHandlerGroup that can be used to setup a SequenceBarrier over the specified event processors.

另请参阅:

after(com.alipay.disruptor.EventHandler[])

publishEvent

public void publishEvent(EventTranslator<T> eventTranslator)

Publish an event to the ring buffer.

参数:

eventTranslator - eventTranslator the translator that will load data into the event.

publishEvent

public <A> void publishEvent(EventTranslatorOneArg<T,A> eventTranslator,
                    A arg)

Publish an event to the ring buffer.

类型参数:

A - A single argument to load into the event

参数:

eventTranslator - the translator that will load data into the event.

arg - A single argument to load into the event

publishEvents

public <A> void publishEvents(EventTranslatorOneArg<T,A> eventTranslator,
                     A[] arg)

Publish a batch of events to the ring buffer.

类型参数:

A - the translator that will load data into the event.

参数:

eventTranslator - the translator that will load data into the event.

arg - An array single arguments to load into the events. One Per event.

start

public RingBuffer<T> start()

Starts the event processors and returns the fully configured ring buffer.

The ring buffer is set up to prevent overwriting any entry that is yet to be processed by the slowest event processor.

This method must only be called once after all event processors have been added.

返回:

the configured ring buffer.

halt

public void halt()

Calls EventProcessor.halt() on all of the event processors created via this disruptor.

shutdown

public void shutdown()

Waits until all events currently in the disruptor have been processed by all event processors and then halts the processors. It is critical that publishing to the ring buffer has stopped before calling this method, otherwise it may never return.

This method will not shutdown the executor, nor will it await the final termination of the processor threads.

shutdown

public void shutdown(long timeout,
            TimeUnit timeUnit)
              throws TimeoutException

Waits until all events currently in the disruptor have been processed by all event processors and then halts the processors.

This method will not shutdown the executor, nor will it await the final termination of the processor threads.

参数:

timeout - the amount of time to wait for all events to be processed. -1 will give an infinite timeout

timeUnit - the unit the timeOut is specified in

抛出:

TimeoutException - TimeoutException

getRingBuffer

public RingBuffer<T> getRingBuffer()

The RingBuffer used by this Disruptor. This is useful for creating custom event processors if the behaviour of BatchEventProcessor is not suitable.

返回:

the ring buffer used by this Disruptor.

getCursor

public long getCursor()

Get the value of the cursor indicating the published sequence.

返回:

value of the cursor for events that have been published.

getBufferSize

public long getBufferSize()

The capacity of the data structure to hold entries.

返回:

the size of the RingBuffer.

另请参阅:

Sequenced.getBufferSize()

get

public T get(long sequence)

Get the event for a given sequence in the RingBuffer.

参数:

sequence - for the event.

返回:

event for the sequence.

另请参阅:

RingBuffer.get(long)

getBarrierFor

public SequenceBarrier getBarrierFor(EventHandler<T> handler)

Get the SequenceBarrier used by a specific handler. Note that the SequenceBarrier may be shared by multiple event handlers.

参数:

handler - the handler to get the barrier for.

返回:

the SequenceBarrier used by handler.

getSequenceValueFor

public long getSequenceValueFor(EventHandler<T> b1)

Gets the sequence value for the specified event handlers.

参数:

b1 - b1

返回:

long

toString

public String toString()

覆盖:

toString 在类中 Object