RingBuffer (tracer-core 2.1.4 API)

java.lang.Object
- com.alipay.disruptor.RingBuffer<E>

类型参数:
E - implementation storing the data for sharing during exchange or parallel coordination of an event.

所有已实现的接口:

Cursored, DataProvider<E>, EventSequencer<E>, EventSink<E>, Sequenced
```
public final class RingBuffer<E>
extends Object
implements Cursored, EventSequencer<E>, EventSink<E>
```
Ring based store of reusable entries containing the data representing an event being exchanged between event producer and EventProcessors.

字段概要

字段
限定符和类型	字段和说明
`protected int`	`bufferSize`
`static long`	`INITIAL_CURSOR_VALUE`
`protected long`	`p1`
`protected long`	`p2`
`protected long`	`p3`
`protected long`	`p4`
`protected long`	`p5`
`protected long`	`p6`
`protected long`	`p7`
`protected Sequencer`	`sequencer`

方法概要

方法
限定符和类型	方法和说明
`void`	`addGatingSequences(Sequence... gatingSequences)` Add the specified gating sequences to this instance of the Disruptor.
`E`	`claimAndGetPreallocated(long sequence)` Sets the cursor to a specific sequence and returns the preallocated entry that is stored there.
`static <E> RingBuffer<E>`	`create(ProducerType producerType, EventFactory<E> factory, int bufferSize, WaitStrategy waitStrategy)` Create a new Ring Buffer with the specified producer type (SINGLE or MULTI)
`static <E> RingBuffer<E>`	`createMultiProducer(EventFactory<E> factory, int bufferSize)` Create a new multiple producer RingBuffer using the default wait strategy `BlockingWaitStrategy`.
`static <E> RingBuffer<E>`	`createMultiProducer(EventFactory<E> factory, int bufferSize, WaitStrategy waitStrategy)` Create a new multiple producer RingBuffer with the specified wait strategy.
`static <E> RingBuffer<E>`	`createSingleProducer(EventFactory<E> factory, int bufferSize)` Create a new single producer RingBuffer using the default wait strategy `BlockingWaitStrategy`.
`static <E> RingBuffer<E>`	`createSingleProducer(EventFactory<E> factory, int bufferSize, WaitStrategy waitStrategy)` Create a new single producer RingBuffer with the specified wait strategy.
`protected E`	`elementAt(long sequence)`
`E`	`get(long sequence)` Get the event for a given sequence in the RingBuffer.
`int`	`getBufferSize()` The size of the buffer.
`long`	`getCursor()` Get the current cursor value for the ring buffer.
`long`	`getMinimumGatingSequence()` Get the minimum sequence value from all of the gating sequences added to this ringBuffer.
`boolean`	`hasAvailableCapacity(int requiredCapacity)` Given specified `requiredCapacity` determines if that amount of space is available.
`boolean`	`isPublished(long sequence)` Determines if a particular entry has been published.
`SequenceBarrier`	`newBarrier(Sequence... sequencesToTrack)` Create a new SequenceBarrier to be used by an EventProcessor to track which messages are available to be read from the ring buffer given a list of sequences to track.
`EventPoller<E>`	`newPoller(Sequence... gatingSequences)` Creates an event poller for this ring buffer gated on the supplied sequences.
`long`	`next()` Increment and return the next sequence for the ring buffer.
`long`	`next(int n)` The same functionality as `next()`, but allows the caller to claim the next n sequences.
`void`	`publish(long sequence)` Publish the specified sequence.
`void`	`publish(long lo, long hi)` Publish the specified sequences.
`void`	`publishEvent(EventTranslator<E> translator)` Publishes an event to the ring buffer.
`<A> void`	`publishEvent(EventTranslatorOneArg<E,A> translator, A arg0)` Allows one user supplied argument.
`<A,B,C> void`	`publishEvent(EventTranslatorThreeArg<E,A,B,C> translator, A arg0, B arg1, C arg2)` Allows three user supplied arguments
`<A,B> void`	`publishEvent(EventTranslatorTwoArg<E,A,B> translator, A arg0, B arg1)` Allows two user supplied arguments.
`void`	`publishEvent(EventTranslatorVararg<E> translator, Object... args)` Allows a variable number of user supplied arguments
`void`	`publishEvents(EventTranslator<E>[] translators)` Publishes multiple events to the ring buffer.
`void`	`publishEvents(EventTranslator<E>[] translators, int batchStartsAt, int batchSize)` Publishes multiple events to the ring buffer.
`<A> void`	`publishEvents(EventTranslatorOneArg<E,A> translator, A[] arg0)` Allows one user supplied argument per event.
`<A> void`	`publishEvents(EventTranslatorOneArg<E,A> translator, int batchStartsAt, int batchSize, A[] arg0)` Allows one user supplied argument per event.
`<A,B,C> void`	`publishEvents(EventTranslatorThreeArg<E,A,B,C> translator, A[] arg0, B[] arg1, C[] arg2)` Allows three user supplied arguments per event.
`<A,B,C> void`	`publishEvents(EventTranslatorThreeArg<E,A,B,C> translator, int batchStartsAt, int batchSize, A[] arg0, B[] arg1, C[] arg2)` Allows three user supplied arguments per event.
`<A,B> void`	`publishEvents(EventTranslatorTwoArg<E,A,B> translator, A[] arg0, B[] arg1)` Allows two user supplied arguments per event.
`<A,B> void`	`publishEvents(EventTranslatorTwoArg<E,A,B> translator, int batchStartsAt, int batchSize, A[] arg0, B[] arg1)` Allows two user supplied arguments per event.
`void`	`publishEvents(EventTranslatorVararg<E> translator, int batchStartsAt, int batchSize, Object[]... args)` Allows a variable number of user supplied arguments per event.
`void`	`publishEvents(EventTranslatorVararg<E> translator, Object[]... args)` Allows a variable number of user supplied arguments per event.
`long`	`remainingCapacity()` Get the remaining capacity for this ringBuffer.
`boolean`	`removeGatingSequence(Sequence sequence)` Remove the specified sequence from this ringBuffer.
`void`	`resetTo(long sequence)` 已过时。
`String`	`toString()`
`long`	`tryNext()` Increment and return the next sequence for the ring buffer.
`long`	`tryNext(int n)` The same functionality as `tryNext()`, but allows the caller to attempt to claim the next n sequences.
`boolean`	`tryPublishEvent(EventTranslator<E> translator)` Attempts to publish an event to the ring buffer.
`<A> boolean`	`tryPublishEvent(EventTranslatorOneArg<E,A> translator, A arg0)` Allows one user supplied argument.
`<A,B,C> boolean`	`tryPublishEvent(EventTranslatorThreeArg<E,A,B,C> translator, A arg0, B arg1, C arg2)` Allows three user supplied arguments
`<A,B> boolean`	`tryPublishEvent(EventTranslatorTwoArg<E,A,B> translator, A arg0, B arg1)` Allows two user supplied arguments.
`boolean`	`tryPublishEvent(EventTranslatorVararg<E> translator, Object... args)` Allows a variable number of user supplied arguments
`boolean`	`tryPublishEvents(EventTranslator<E>[] translators)` Attempts to publish multiple events to the ring buffer.
`boolean`	`tryPublishEvents(EventTranslator<E>[] translators, int batchStartsAt, int batchSize)` Attempts to publish multiple events to the ring buffer.
`<A> boolean`	`tryPublishEvents(EventTranslatorOneArg<E,A> translator, A[] arg0)` Allows one user supplied argument.
`<A> boolean`	`tryPublishEvents(EventTranslatorOneArg<E,A> translator, int batchStartsAt, int batchSize, A[] arg0)` Allows one user supplied argument.
`<A,B,C> boolean`	`tryPublishEvents(EventTranslatorThreeArg<E,A,B,C> translator, A[] arg0, B[] arg1, C[] arg2)` Allows three user supplied arguments per event.
`<A,B,C> boolean`	`tryPublishEvents(EventTranslatorThreeArg<E,A,B,C> translator, int batchStartsAt, int batchSize, A[] arg0, B[] arg1, C[] arg2)` Allows three user supplied arguments per event.
`<A,B> boolean`	`tryPublishEvents(EventTranslatorTwoArg<E,A,B> translator, A[] arg0, B[] arg1)` Allows two user supplied arguments per event.
`<A,B> boolean`	`tryPublishEvents(EventTranslatorTwoArg<E,A,B> translator, int batchStartsAt, int batchSize, A[] arg0, B[] arg1)` Allows two user supplied arguments per event.
`boolean`	`tryPublishEvents(EventTranslatorVararg<E> translator, int batchStartsAt, int batchSize, Object[]... args)` Allows a variable number of user supplied arguments per event.
`boolean`	`tryPublishEvents(EventTranslatorVararg<E> translator, Object[]... args)` Allows a variable number of user supplied arguments per event.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 字段详细资料
  - INITIAL_CURSOR_VALUE
```
public static final long INITIAL_CURSOR_VALUE
```
    另请参阅:
    常量字段值
  - p1
```
protected long p1
```
  - p2
```
protected long p2
```
  - p3
```
protected long p3
```
  - p4
```
protected long p4
```
  - p5
```
protected long p5
```
  - p6
```
protected long p6
```
  - p7
```
protected long p7
```
  - bufferSize
```
protected final int bufferSize
```
  - sequencer
```
protected final Sequencer sequencer
```
- 方法详细资料
  - createMultiProducer
```
public static <E> RingBuffer<E> createMultiProducer(EventFactory<E> factory,
                                    int bufferSize,
                                    WaitStrategy waitStrategy)
```
    Create a new multiple producer RingBuffer with the specified wait strategy.
    
    类型参数:
    E - used to create the events within the ring buffer.
    参数:
    factory - used to create the events within the ring buffer.
    bufferSize - number of elements to create within the ring buffer.
    waitStrategy - used to determine how to wait for new elements to become available.
    
    返回:
    RingBuffer
    
    抛出:
    
    IllegalArgumentException - if bufferSize is less than 1 or not a power of 2
    另请参阅:
    MultiProducerSequencer
  - createMultiProducer
```
public static <E> RingBuffer<E> createMultiProducer(EventFactory<E> factory,
                                    int bufferSize)
```
    Create a new multiple producer RingBuffer using the default wait strategy BlockingWaitStrategy.
    
    类型参数:
    E - used to create the events within the ring buffer.
    参数:
    factory - used to create the events within the ring buffer.
    bufferSize - bufferSize
    
    返回:
    ring buffer
    
    抛出:
    
    IllegalArgumentException - if bufferSize is less than 1 or not a power of 2
    另请参阅:
    MultiProducerSequencer
  - createSingleProducer
```
public static <E> RingBuffer<E> createSingleProducer(EventFactory<E> factory,
                                     int bufferSize,
                                     WaitStrategy waitStrategy)
```
    Create a new single producer RingBuffer with the specified wait strategy.
    
    类型参数:
    E - used to create the events within the ring buffer.
    参数:
    factory - used to create the events within the ring buffer.
    bufferSize - number of elements to create within the ring buffer.
    waitStrategy - used to determine how to wait for new elements to become available.
    
    返回:
    ring buffer
    
    抛出:
    
    IllegalArgumentException - if bufferSize is less than 1 or not a power of 2
    另请参阅:
    SingleProducerSequencer
  - createSingleProducer
```
public static <E> RingBuffer<E> createSingleProducer(EventFactory<E> factory,
                                     int bufferSize)
```
    Create a new single producer RingBuffer using the default wait strategy BlockingWaitStrategy.
    
    类型参数:
    E - used to create the events within the ring buffer.
    参数:
    factory - used to create the events within the ring buffer.
    bufferSize - number of elements to create within the ring buffer.
    
    返回:
    ring buffer
    
    抛出:
    
    IllegalArgumentException - if bufferSize is less than 1 or not a power of 2
    另请参阅:
    MultiProducerSequencer
  - create
```
public static <E> RingBuffer<E> create(ProducerType producerType,
                       EventFactory<E> factory,
                       int bufferSize,
                       WaitStrategy waitStrategy)
```
    Create a new Ring Buffer with the specified producer type (SINGLE or MULTI)
    
    类型参数:
    E - used to create events within the ring buffer.
    参数:
    producerType - producer type to use ProducerType.
    factory - used to create events within the ring buffer.
    bufferSize - number of elements to create within the ring buffer.
    waitStrategy - used to determine how to wait for new elements to become available.
    
    返回:
    RingBuffer
    
    抛出:
    
    IllegalArgumentException - if bufferSize is less than 1 or not a power of 2
  - get
```
public E get(long sequence)
```
    Get the event for a given sequence in the RingBuffer.
    
    This call has 2 uses. Firstly use this call when publishing to a ring buffer. After calling next() use this call to get hold of the preallocated event to fill with data before calling publish(long).
    
    Secondly use this call when consuming data from the ring buffer. After calling SequenceBarrier.waitFor(long) call this method with any value greater than that your current consumer sequence and less than or equal to the value returned from the SequenceBarrier.waitFor(long) method.
    
    指定者:
    
    get 在接口中 DataProvider<E>
    
    参数:
    sequence - for the event
    
    返回:
    the event for the given sequence
  - next
```
public long next()
```
    Increment and return the next sequence for the ring buffer. Calls of this method should ensure that they always publish the sequence afterward. E.g.
```
 long sequence = ringBuffer.next();
 try {
     Event e = ringBuffer.get(sequence);
     // Do some work with the event.
 } finally {
     ringBuffer.publish(sequence);
 }
 
```
    指定者:
    
    next 在接口中 Sequenced
    
    返回:
    The next sequence to publish to.
    另请参阅:
    publish(long), get(long)
  - next
```
public long next(int n)
```
    The same functionality as next(), but allows the caller to claim the next n sequences.
    
    指定者:
    
    next 在接口中 Sequenced
    
    参数:
    n - number of slots to claim
    
    返回:
    sequence number of the highest slot claimed
    另请参阅:
    Sequenced.next(int)
  - tryNext
```
public long tryNext()
             throws InsufficientCapacityException
```
    Increment and return the next sequence for the ring buffer. Calls of this method should ensure that they always publish the sequence afterward. E.g.
```
 long sequence = ringBuffer.next();
 try {
     Event e = ringBuffer.get(sequence);
     // Do some work with the event.
 } finally {
     ringBuffer.publish(sequence);
 }
 
```
    This method will not block if there is not space available in the ring buffer, instead it will throw an InsufficientCapacityException.
    指定者:
    
    tryNext 在接口中 Sequenced
    
    返回:
    The next sequence to publish to.
    
    抛出:
    
    InsufficientCapacityException - if the necessary space in the ring buffer is not available
    另请参阅:
    publish(long), get(long)
  - tryNext
```
public long tryNext(int n)
             throws InsufficientCapacityException
```
    The same functionality as tryNext(), but allows the caller to attempt to claim the next n sequences.
    
    指定者:
    
    tryNext 在接口中 Sequenced
    
    参数:
    n - number of slots to claim
    
    返回:
    sequence number of the highest slot claimed
    
    抛出:
    
    InsufficientCapacityException - if the necessary space in the ring buffer is not available
  - resetTo
```
@Deprecated
public void resetTo(long sequence)
```
    已过时。
    
    Resets the cursor to a specific value. This can be applied at any time, but it is worth noting that it can cause a data race and should only be used in controlled circumstances. E.g. during initialisation.
    
    参数:
    sequence - The sequence to reset too.
    
    抛出:
    
    IllegalStateException - If any gating sequences have already been specified.
  - claimAndGetPreallocated
```
public E claimAndGetPreallocated(long sequence)
```
    Sets the cursor to a specific sequence and returns the preallocated entry that is stored there. This can cause a data race and should only be done in controlled circumstances, e.g. during initialisation.
    
    参数:
    sequence - The sequence to claim.
    
    返回:
    The preallocated event.
  - isPublished
```
public boolean isPublished(long sequence)
```
    Determines if a particular entry has been published.
    
    参数:
    sequence - The sequence to identify the entry.
    
    返回:
    If the value has been published or not.
  - addGatingSequences
```
public void addGatingSequences(Sequence... gatingSequences)
```
    Add the specified gating sequences to this instance of the Disruptor. They will safely and atomically added to the list of gating sequences.
    
    参数:
    gatingSequences - The sequences to add.
  - getMinimumGatingSequence
```
public long getMinimumGatingSequence()
```
    Get the minimum sequence value from all of the gating sequences added to this ringBuffer.
    
    返回:
    The minimum gating sequence or the cursor sequence if no sequences have been added.
  - removeGatingSequence
```
public boolean removeGatingSequence(Sequence sequence)
```
    Remove the specified sequence from this ringBuffer.
    
    参数:
    sequence - to be removed.
    
    返回:
    true if this sequence was found, false otherwise.
  - newBarrier
```
public SequenceBarrier newBarrier(Sequence... sequencesToTrack)
```
    Create a new SequenceBarrier to be used by an EventProcessor to track which messages are available to be read from the ring buffer given a list of sequences to track.
    
    参数:
    sequencesToTrack - the additional sequences to track
    
    返回:
    A sequence barrier that will track the specified sequences.
    另请参阅:
    SequenceBarrier
  - newPoller
```
public EventPoller<E> newPoller(Sequence... gatingSequences)
```
    Creates an event poller for this ring buffer gated on the supplied sequences.
    
    参数:
    gatingSequences - gatingSequences
    
    返回:
    A poller that will gate on this ring buffer and the supplied sequences.
  - getCursor
```
public long getCursor()
```
    Get the current cursor value for the ring buffer. The actual value received will depend on the type of Sequencer that is being used.
    
    指定者:
    
    getCursor 在接口中 Cursored
    
    返回:
    current cursor value
    另请参阅:
    MultiProducerSequencer, SingleProducerSequencer
  - getBufferSize
```
public int getBufferSize()
```
    The size of the buffer.
    
    指定者:
    
    getBufferSize 在接口中 Sequenced
    
    返回:
    the size of the RingBuffer.
  - hasAvailableCapacity
```
public boolean hasAvailableCapacity(int requiredCapacity)
```
    Given specified requiredCapacity determines if that amount of space is available. Note, you can not assume that if this method returns true that a call to next() will not block. Especially true if this ring buffer is set up to handle multiple producers.
    
    指定者:
    
    hasAvailableCapacity 在接口中 Sequenced
    
    参数:
    requiredCapacity - The capacity to check for.
    
    返回:
    true If the specified requiredCapacity is available false if now.
  - publishEvent
```
public void publishEvent(EventTranslator<E> translator)
```
    从接口复制的说明: EventSink
    
    Publishes an event to the ring buffer. It handles claiming the next sequence, getting the current (uninitialised) event from the ring buffer and publishing the claimed sequence after translation.
    
    指定者:
    
    publishEvent 在接口中 EventSink<E>
    
    参数:
    translator - The user specified translation for the event
    另请参阅:
    EventSink.publishEvent(com.alipay.disruptor.EventTranslator)
  - tryPublishEvent
```
public boolean tryPublishEvent(EventTranslator<E> translator)
```
    从接口复制的说明: EventSink
    
    Attempts to publish an event to the ring buffer. It handles claiming the next sequence, getting the current (uninitialised) event from the ring buffer and publishing the claimed sequence after translation. Will return false if specified capacity was not available.
    
    指定者:
    
    tryPublishEvent 在接口中 EventSink<E>
    
    参数:
    translator - The user specified translation for the event
    
    返回:
    true if the value was published, false if there was insufficient capacity.
    另请参阅:
    EventSink.tryPublishEvent(com.alipay.disruptor.EventTranslator)
  - publishEvent
```
public <A> void publishEvent(EventTranslatorOneArg<E,A> translator,
                    A arg0)
```
    从接口复制的说明: EventSink
    
    Allows one user supplied argument.
    
    指定者:
    
    publishEvent 在接口中 EventSink<E>
    
    类型参数:
    A - A user supplied argument.
    参数:
    translator - The user specified translation for the event
    arg0 - A user supplied argument.
    另请参阅:
    com.alipay.disruptor.EventSink#publishEvent(com.alipay.disruptor.EventTranslatorOneArg, A)
  - tryPublishEvent
```
public <A> boolean tryPublishEvent(EventTranslatorOneArg<E,A> translator,
                          A arg0)
```
    从接口复制的说明: EventSink
    
    Allows one user supplied argument.
    
    指定者:
    
    tryPublishEvent 在接口中 EventSink<E>
    
    类型参数:
    A - A user supplied argument.
    参数:
    translator - The user specified translation for the event
    arg0 - A user supplied argument.
    
    返回:
    true if the value was published, false if there was insufficient capacity.
    另请参阅:
    com.alipay.disruptor.EventSink#tryPublishEvent(com.alipay.disruptor.EventTranslatorOneArg, A)
  - publishEvent
```
public <A,B> void publishEvent(EventTranslatorTwoArg<E,A,B> translator,
                      A arg0,
                      B arg1)
```
    从接口复制的说明: EventSink
    
    Allows two user supplied arguments.
    
    指定者:
    
    publishEvent 在接口中 EventSink<E>
    
    类型参数:
    A - A user supplied argument.
    B - B user supplied argument.
    参数:
    translator - The user specified translation for the event
    arg0 - A user supplied argument.
    arg1 - A user supplied argument.
    另请参阅:
    com.alipay.disruptor.EventSink#publishEvent(com.alipay.disruptor.EventTranslatorTwoArg, A, B)
  - tryPublishEvent
```
public <A,B> boolean tryPublishEvent(EventTranslatorTwoArg<E,A,B> translator,
                            A arg0,
                            B arg1)
```
    从接口复制的说明: EventSink
    
    Allows two user supplied arguments.
    
    指定者:
    
    tryPublishEvent 在接口中 EventSink<E>
    
    类型参数:
    A - A user supplied argument.
    B - B user supplied argument.
    参数:
    translator - The user specified translation for the event
    arg0 - A user supplied argument.
    arg1 - A user supplied argument.
    
    返回:
    true if the value was published, false if there was insufficient capacity.
    另请参阅:
    com.alipay.disruptor.EventSink#tryPublishEvent(com.alipay.disruptor.EventTranslatorTwoArg, A, B)
  - publishEvent
```
public <A,B,C> void publishEvent(EventTranslatorThreeArg<E,A,B,C> translator,
                        A arg0,
                        B arg1,
                        C arg2)
```
    从接口复制的说明: EventSink
    
    Allows three user supplied arguments
    
    指定者:
    
    publishEvent 在接口中 EventSink<E>
    
    类型参数:
    A - A user supplied argument.
    B - B user supplied argument.
    C - C user supplied argument.
    参数:
    translator - The user specified translation for the event
    arg0 - A user supplied argument.
    arg1 - A user supplied argument.
    arg2 - A user supplied argument.
    另请参阅:
    com.alipay.disruptor.EventSink#publishEvent(com.alipay.disruptor.EventTranslatorThreeArg, A, B, C)
  - tryPublishEvent
```
public <A,B,C> boolean tryPublishEvent(EventTranslatorThreeArg<E,A,B,C> translator,
                              A arg0,
                              B arg1,
                              C arg2)
```
    从接口复制的说明: EventSink
    
    Allows three user supplied arguments
    
    指定者:
    
    tryPublishEvent 在接口中 EventSink<E>
    
    类型参数:
    A - A user supplied argument.
    B - B user supplied argument.
    C - C user supplied argument.
    参数:
    translator - The user specified translation for the event
    arg0 - A user supplied argument.
    arg1 - A user supplied argument.
    arg2 - A user supplied argument.
    
    返回:
    true if the value was published, false if there was insufficient capacity.
    另请参阅:
    com.alipay.disruptor.EventSink#tryPublishEvent(com.alipay.disruptor.EventTranslatorThreeArg, A, B, C)
  - publishEvent
```
public void publishEvent(EventTranslatorVararg<E> translator,
                Object... args)
```
    从接口复制的说明: EventSink
    
    Allows a variable number of user supplied arguments
    
    指定者:
    
    publishEvent 在接口中 EventSink<E>
    
    参数:
    translator - The user specified translation for the event
    args - User supplied arguments.
    另请参阅:
    EventSink.publishEvent(com.alipay.disruptor.EventTranslatorVararg, Object...)
  - tryPublishEvent
```
public boolean tryPublishEvent(EventTranslatorVararg<E> translator,
                      Object... args)
```
    从接口复制的说明: EventSink
    
    Allows a variable number of user supplied arguments
    
    指定者:
    
    tryPublishEvent 在接口中 EventSink<E>
    
    参数:
    translator - The user specified translation for the event
    args - User supplied arguments.
    
    返回:
    true if the value was published, false if there was insufficient capacity.
    另请参阅:
    EventSink.tryPublishEvent(com.alipay.disruptor.EventTranslatorVararg, Object...)
  - publishEvents
```
public void publishEvents(EventTranslator<E>[] translators)
```
    从接口复制的说明: EventSink
    
    Publishes multiple events to the ring buffer. It handles claiming the next sequence, getting the current (uninitialised) event from the ring buffer and publishing the claimed sequence after translation.
    With this call the data that is to be inserted into the ring buffer will be a field (either explicitly or captured anonymously), therefore this call will require an instance of the translator for each value that is to be inserted into the ring buffer.
    
    指定者:
    
    publishEvents 在接口中 EventSink<E>
    
    参数:
    translators - The user specified translation for each event
    另请参阅:
    EventSink.publishEvents(com.alipay.disruptor.EventTranslator[])
  - publishEvents
```
public void publishEvents(EventTranslator<E>[] translators,
                 int batchStartsAt,
                 int batchSize)
```
    从接口复制的说明: EventSink
    
    Publishes multiple events to the ring buffer. It handles claiming the next sequence, getting the current (uninitialised) event from the ring buffer and publishing the claimed sequence after translation.
    With this call the data that is to be inserted into the ring buffer will be a field (either explicitly or captured anonymously), therefore this call will require an instance of the translator for each value that is to be inserted into the ring buffer.
    
    指定者:
    
    publishEvents 在接口中 EventSink<E>
    
    参数:
    translators - The user specified translation for each event
    batchStartsAt - The first element of the array which is within the batch.
    batchSize - The actual size of the batch
    另请参阅:
    EventSink.publishEvents(com.alipay.disruptor.EventTranslator[], int, int)
  - tryPublishEvents
```
public boolean tryPublishEvents(EventTranslator<E>[] translators)
```
    从接口复制的说明: EventSink
    
    Attempts to publish multiple events to the ring buffer. It handles claiming the next sequence, getting the current (uninitialised) event from the ring buffer and publishing the claimed sequence after translation. Will return false if specified capacity was not available.
    
    指定者:
    
    tryPublishEvents 在接口中 EventSink<E>
    
    参数:
    translators - The user specified translation for the event
    
    返回:
    true if the value was published, false if there was insufficient capacity.
    另请参阅:
    EventSink.tryPublishEvents(com.alipay.disruptor.EventTranslator[])
  - tryPublishEvents
```
public boolean tryPublishEvents(EventTranslator<E>[] translators,
                       int batchStartsAt,
                       int batchSize)
```
    从接口复制的说明: EventSink
    
    Attempts to publish multiple events to the ring buffer. It handles claiming the next sequence, getting the current (uninitialised) event from the ring buffer and publishing the claimed sequence after translation. Will return false if specified capacity was not available.
    
    指定者:
    
    tryPublishEvents 在接口中 EventSink<E>
    
    参数:
    translators - The user specified translation for the event
    batchStartsAt - The first element of the array which is within the batch.
    batchSize - The actual size of the batch
    
    返回:
    true if all the values were published, false if there was insufficient capacity.
    另请参阅:
    EventSink.tryPublishEvents(com.alipay.disruptor.EventTranslator[], int, int)
  - publishEvents
```
public <A> void publishEvents(EventTranslatorOneArg<E,A> translator,
                     A[] arg0)
```
    从接口复制的说明: EventSink
    
    Allows one user supplied argument per event.
    
    指定者:
    
    publishEvents 在接口中 EventSink<E>
    
    类型参数:
    A - A user supplied argument.
    参数:
    translator - The user specified translation for the event
    arg0 - A user supplied argument.
    另请参阅:
    com.alipay.disruptor.EventSink#publishEvents(com.alipay.disruptor.EventTranslatorOneArg, A[])
  - publishEvents
```
public <A> void publishEvents(EventTranslatorOneArg<E,A> translator,
                     int batchStartsAt,
                     int batchSize,
                     A[] arg0)
```
    从接口复制的说明: EventSink
    
    Allows one user supplied argument per event.
    
    指定者:
    
    publishEvents 在接口中 EventSink<E>
    
    类型参数:
    A - A user supplied argument.
    参数:
    translator - The user specified translation for each event
    batchStartsAt - The first element of the array which is within the batch.
    batchSize - The actual size of the batch
    arg0 - An array of user supplied arguments, one element per event.
    另请参阅:
    com.alipay.disruptor.EventSink#publishEvents(com.alipay.disruptor.EventTranslatorOneArg, int, int, A[])
  - tryPublishEvents
```
public <A> boolean tryPublishEvents(EventTranslatorOneArg<E,A> translator,
                           A[] arg0)
```
    从接口复制的说明: EventSink
    
    Allows one user supplied argument.
    
    指定者:
    
    tryPublishEvents 在接口中 EventSink<E>
    
    类型参数:
    A - A user supplied argument.
    参数:
    translator - The user specified translation for each event
    arg0 - An array of user supplied arguments, one element per event.
    
    返回:
    true if the value was published, false if there was insufficient capacity.
    另请参阅:
    com.alipay.disruptor.EventSink#tryPublishEvents(com.alipay.disruptor.EventTranslatorOneArg, A[])
  - tryPublishEvents
```
public <A> boolean tryPublishEvents(EventTranslatorOneArg<E,A> translator,
                           int batchStartsAt,
                           int batchSize,
                           A[] arg0)
```
    从接口复制的说明: EventSink
    
    Allows one user supplied argument.
    
    指定者:
    
    tryPublishEvents 在接口中 EventSink<E>
    
    类型参数:
    A - A user supplied argument.
    参数:
    translator - The user specified translation for each event
    batchStartsAt - The first element of the array which is within the batch.
    batchSize - The actual size of the batch
    arg0 - An array of user supplied arguments, one element per event.
    
    返回:
    true if the value was published, false if there was insufficient capacity.
    另请参阅:
    com.alipay.disruptor.EventSink#tryPublishEvents(com.alipay.disruptor.EventTranslatorOneArg, int, int, A[])
  - publishEvents
```
public <A,B> void publishEvents(EventTranslatorTwoArg<E,A,B> translator,
                       A[] arg0,
                       B[] arg1)
```
    从接口复制的说明: EventSink
    
    Allows two user supplied arguments per event.
    
    指定者:
    
    publishEvents 在接口中 EventSink<E>
    
    类型参数:
    A - A user supplied argument.
    B - B user supplied argument.
    参数:
    translator - The user specified translation for the event
    arg0 - An array of user supplied arguments, one element per event.
    arg1 - An array of user supplied arguments, one element per event.
    另请参阅:
    com.alipay.disruptor.EventSink#publishEvents(com.alipay.disruptor.EventTranslatorTwoArg, A[], B[])
  - publishEvents
```
public <A,B> void publishEvents(EventTranslatorTwoArg<E,A,B> translator,
                       int batchStartsAt,
                       int batchSize,
                       A[] arg0,
                       B[] arg1)
```
    从接口复制的说明: EventSink
    
    Allows two user supplied arguments per event.
    
    指定者:
    
    publishEvents 在接口中 EventSink<E>
    
    类型参数:
    A - An array of user supplied arguments, one element per event.
    B - An array of user supplied arguments, one element per event.
    参数:
    translator - The user specified translation for the event
    batchStartsAt - The first element of the array which is within the batch.
    batchSize - The actual size of the batch.
    arg0 - An array of user supplied arguments, one element per event.
    arg1 - An array of user supplied arguments, one element per event.
    另请参阅:
    com.alipay.disruptor.EventSink#publishEvents(com.alipay.disruptor.EventTranslatorTwoArg, int, int, A[], B[])
  - tryPublishEvents
```
public <A,B> boolean tryPublishEvents(EventTranslatorTwoArg<E,A,B> translator,
                             A[] arg0,
                             B[] arg1)
```
    从接口复制的说明: EventSink
    
    Allows two user supplied arguments per event.
    
    指定者:
    
    tryPublishEvents 在接口中 EventSink<E>
    
    类型参数:
    A - An array of user supplied arguments, one element per event.
    B - An array of user supplied arguments, one element per event.
    参数:
    translator - The user specified translation for the event
    arg0 - An array of user supplied arguments, one element per event.
    arg1 - An array of user supplied arguments, one element per event.
    
    返回:
    true if the value was published, false if there was insufficient capacity.
    另请参阅:
    com.alipay.disruptor.EventSink#tryPublishEvents(com.alipay.disruptor.EventTranslatorTwoArg, A[], B[])
  - tryPublishEvents
```
public <A,B> boolean tryPublishEvents(EventTranslatorTwoArg<E,A,B> translator,
                             int batchStartsAt,
                             int batchSize,
                             A[] arg0,
                             B[] arg1)
```
    从接口复制的说明: EventSink
    
    Allows two user supplied arguments per event.
    
    指定者:
    
    tryPublishEvents 在接口中 EventSink<E>
    
    类型参数:
    A - An array of user supplied arguments, one element per event.
    B - An array of user supplied arguments, one element per event.
    参数:
    translator - The user specified translation for the event
    batchStartsAt - The first element of the array which is within the batch.
    batchSize - The actual size of the batch.
    arg0 - An array of user supplied arguments, one element per event.
    arg1 - An array of user supplied arguments, one element per event.
    
    返回:
    true if the value was published, false if there was insufficient capacity.
    另请参阅:
    com.alipay.disruptor.EventSink#tryPublishEvents(com.alipay.disruptor.EventTranslatorTwoArg, int, int, A[], B[])
  - publishEvents
```
public <A,B,C> void publishEvents(EventTranslatorThreeArg<E,A,B,C> translator,
                         A[] arg0,
                         B[] arg1,
                         C[] arg2)
```
    从接口复制的说明: EventSink
    
    Allows three user supplied arguments per event.
    
    指定者:
    
    publishEvents 在接口中 EventSink<E>
    
    类型参数:
    A - An array of user supplied arguments, one element per event.
    B - An array of user supplied arguments, one element per event.
    C - An array of user supplied arguments, one element per event.
    参数:
    translator - The user specified translation for the event
    arg0 - An array of user supplied arguments, one element per event.
    arg1 - An array of user supplied arguments, one element per event.
    arg2 - An array of user supplied arguments, one element per event.
    另请参阅:
    com.alipay.disruptor.EventSink#publishEvents(com.alipay.disruptor.EventTranslatorThreeArg, A[], B[], C[])
  - publishEvents
```
public <A,B,C> void publishEvents(EventTranslatorThreeArg<E,A,B,C> translator,
                         int batchStartsAt,
                         int batchSize,
                         A[] arg0,
                         B[] arg1,
                         C[] arg2)
```
    从接口复制的说明: EventSink
    
    Allows three user supplied arguments per event.
    
    指定者:
    
    publishEvents 在接口中 EventSink<E>
    
    类型参数:
    A - An array of user supplied arguments, one element per event.
    B - An array of user supplied arguments, one element per event.
    C - An array of user supplied arguments, one element per event.
    参数:
    translator - The user specified translation for the event
    batchStartsAt - The first element of the array which is within the batch.
    batchSize - The number of elements in the batch.
    arg0 - An array of user supplied arguments, one element per event.
    arg1 - An array of user supplied arguments, one element per event.
    arg2 - An array of user supplied arguments, one element per event.
    另请参阅:
    com.alipay.disruptor.EventSink#publishEvents(com.alipay.disruptor.EventTranslatorThreeArg, int, int, A[], B[], C[])
  - tryPublishEvents
```
public <A,B,C> boolean tryPublishEvents(EventTranslatorThreeArg<E,A,B,C> translator,
                               A[] arg0,
                               B[] arg1,
                               C[] arg2)
```
    从接口复制的说明: EventSink
    
    Allows three user supplied arguments per event.
    
    指定者:
    
    tryPublishEvents 在接口中 EventSink<E>
    
    类型参数:
    A - An array of user supplied arguments, one element per event.
    B - An array of user supplied arguments, one element per event.
    C - An array of user supplied arguments, one element per event.
    参数:
    translator - The user specified translation for the event
    arg0 - An array of user supplied arguments, one element per event.
    arg1 - An array of user supplied arguments, one element per event.
    arg2 - An array of user supplied arguments, one element per event.
    
    返回:
    true if the value was published, false if there was insufficient capacity.
    另请参阅:
    com.alipay.disruptor.EventSink#tryPublishEvents(com.alipay.disruptor.EventTranslatorThreeArg, A[], B[], C[])
  - tryPublishEvents
```
public <A,B,C> boolean tryPublishEvents(EventTranslatorThreeArg<E,A,B,C> translator,
                               int batchStartsAt,
                               int batchSize,
                               A[] arg0,
                               B[] arg1,
                               C[] arg2)
```
    从接口复制的说明: EventSink
    
    Allows three user supplied arguments per event.
    
    指定者:
    
    tryPublishEvents 在接口中 EventSink<E>
    
    类型参数:
    A - An array of user supplied arguments, one element per event.
    B - An array of user supplied arguments, one element per event.
    C - An array of user supplied arguments, one element per event.
    参数:
    translator - The user specified translation for the event
    batchStartsAt - The first element of the array which is within the batch.
    batchSize - The actual size of the batch.
    arg0 - An array of user supplied arguments, one element per event.
    arg1 - An array of user supplied arguments, one element per event.
    arg2 - An array of user supplied arguments, one element per event.
    
    返回:
    true if the value was published, false if there was insufficient capacity.
    另请参阅:
    com.alipay.disruptor.EventSink#tryPublishEvents(com.alipay.disruptor.EventTranslatorThreeArg, int, int, A[], B[], C[])
  - publishEvents
```
public void publishEvents(EventTranslatorVararg<E> translator,
                 Object[]... args)
```
    从接口复制的说明: EventSink
    
    Allows a variable number of user supplied arguments per event.
    
    指定者:
    
    publishEvents 在接口中 EventSink<E>
    
    参数:
    translator - The user specified translation for the event
    args - User supplied arguments, one Object[] per event.
    另请参阅:
    EventSink.publishEvents(com.alipay.disruptor.EventTranslatorVararg, Object[][])
  - publishEvents
```
public void publishEvents(EventTranslatorVararg<E> translator,
                 int batchStartsAt,
                 int batchSize,
                 Object[]... args)
```
    从接口复制的说明: EventSink
    
    Allows a variable number of user supplied arguments per event.
    
    指定者:
    
    publishEvents 在接口中 EventSink<E>
    
    参数:
    translator - The user specified translation for the event
    batchStartsAt - The first element of the array which is within the batch.
    batchSize - The actual size of the batch
    args - User supplied arguments, one Object[] per event.
    另请参阅:
    EventSink.publishEvents(com.alipay.disruptor.EventTranslatorVararg, int, int, Object[][])
  - tryPublishEvents
```
public boolean tryPublishEvents(EventTranslatorVararg<E> translator,
                       Object[]... args)
```
    从接口复制的说明: EventSink
    
    Allows a variable number of user supplied arguments per event.
    
    指定者:
    
    tryPublishEvents 在接口中 EventSink<E>
    
    参数:
    translator - The user specified translation for the event
    args - User supplied arguments, one Object[] per event.
    
    返回:
    true if the value was published, false if there was insufficient capacity.
    另请参阅:
    EventSink.tryPublishEvents(com.alipay.disruptor.EventTranslatorVararg, Object[][])
  - tryPublishEvents
```
public boolean tryPublishEvents(EventTranslatorVararg<E> translator,
                       int batchStartsAt,
                       int batchSize,
                       Object[]... args)
```
    从接口复制的说明: EventSink
    
    Allows a variable number of user supplied arguments per event.
    
    指定者:
    
    tryPublishEvents 在接口中 EventSink<E>
    
    参数:
    translator - The user specified translation for the event
    batchStartsAt - The first element of the array which is within the batch.
    batchSize - The actual size of the batch.
    args - User supplied arguments, one Object[] per event.
    
    返回:
    true if the value was published, false if there was insufficient capacity.
    另请参阅:
    EventSink.tryPublishEvents(com.alipay.disruptor.EventTranslatorVararg, int, int, Object[][])
  - publish
```
public void publish(long sequence)
```
    Publish the specified sequence. This action marks this particular message as being available to be read.
    
    指定者:
    
    publish 在接口中 Sequenced
    
    参数:
    sequence - the sequence to publish.
  - publish
```
public void publish(long lo,
           long hi)
```
    Publish the specified sequences. This action marks these particular messages as being available to be read.
    
    指定者:
    
    publish 在接口中 Sequenced
    
    参数:
    lo - the lowest sequence number to be published
    hi - the highest sequence number to be published
    另请参阅:
    Sequenced.next(int)
  - remainingCapacity
```
public long remainingCapacity()
```
    Get the remaining capacity for this ringBuffer.
    
    指定者:
    
    remainingCapacity 在接口中 Sequenced
    
    返回:
    The number of slots remaining.
  - toString
```
public String toString()
```
    覆盖:
    
    toString 在类中 Object
  - elementAt
```
protected final E elementAt(long sequence)
```

类 RingBuffer<E>

字段概要

方法概要

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

字段详细资料

INITIAL_CURSOR_VALUE

p1

p2

p3

p4

p5

p6

p7

bufferSize

sequencer

方法详细资料

createMultiProducer

createMultiProducer

createSingleProducer

createSingleProducer

create

get

next

next

tryNext

tryNext

resetTo

claimAndGetPreallocated

isPublished

addGatingSequences

getMinimumGatingSequence

removeGatingSequence

newBarrier

newPoller

getCursor

getBufferSize

hasAvailableCapacity

publishEvent

tryPublishEvent

publishEvent

tryPublishEvent

publishEvent

tryPublishEvent

publishEvent

tryPublishEvent

publishEvent

tryPublishEvent

publishEvents

publishEvents

tryPublishEvents

tryPublishEvents

publishEvents

publishEvents

tryPublishEvents

tryPublishEvents

publishEvents

publishEvents

tryPublishEvents

tryPublishEvents

publishEvents

publishEvents

tryPublishEvents

tryPublishEvents

publishEvents

publishEvents

tryPublishEvents

tryPublishEvents

publish

publish

remainingCapacity

toString

elementAt