Sequenced (tracer-core 2.1.4 API)

所有已知子接口:

EventSequencer<T>, Sequencer

所有已知实现类:

AbstractSequencer, MultiProducerSequencer, RingBuffer, SingleProducerSequencer
```
public interface Sequenced
```

方法概要

方法
限定符和类型	方法和说明
`int`	`getBufferSize()` The capacity of the data structure to hold entries.
`boolean`	`hasAvailableCapacity(int requiredCapacity)` Has the buffer got capacity to allocate another sequence.
`long`	`next()` Claim the next event in sequence for publishing.
`long`	`next(int n)` Claim the next n events in sequence for publishing.
`void`	`publish(long sequence)` Publishes a sequence.
`void`	`publish(long lo, long hi)` Batch publish sequences.
`long`	`remainingCapacity()` Get the remaining capacity for this sequencer.
`long`	`tryNext()` Attempt to claim the next event in sequence for publishing.
`long`	`tryNext(int n)` Attempt to claim the next n events in sequence for publishing.

- 方法详细资料
  - getBufferSize
```
int getBufferSize()
```
    The capacity of the data structure to hold entries.
    
    返回:
    the size of the RingBuffer.
  - hasAvailableCapacity
```
boolean hasAvailableCapacity(int requiredCapacity)
```
    Has the buffer got capacity to allocate another sequence. This is a concurrent method so the response should only be taken as an indication of available capacity.
    
    参数:
    requiredCapacity - in the buffer
    
    返回:
    true if the buffer has the capacity to allocate the next sequence otherwise false.
  - remainingCapacity
```
long remainingCapacity()
```
    Get the remaining capacity for this sequencer.
    
    返回:
    The number of slots remaining.
  - next
```
long next()
```
    Claim the next event in sequence for publishing.
    
    返回:
    the claimed sequence value
  - next
```
long next(int n)
```
    Claim the next n events in sequence for publishing. This is for batch event producing. Using batch producing requires a little care and some math.
```
 int n = 10;
 long hi = sequencer.next(n);
 long lo = hi - (n - 1);
 for (long sequence = lo; sequence <= hi; sequence++) {
     // Do work.
 }
 sequencer.publish(lo, hi);
 
```
    参数:
    n - the number of sequences to claim
    
    返回:
    the highest claimed sequence value
  - tryNext
```
long tryNext()
             throws InsufficientCapacityException
```
    Attempt to claim the next event in sequence for publishing. Will return the number of the slot if there is at least requiredCapacity slots available.
    
    返回:
    the claimed sequence value
    
    抛出:
    
    InsufficientCapacityException - InsufficientCapacityException
  - tryNext
```
long tryNext(int n)
             throws InsufficientCapacityException
```
    Attempt to claim the next n events in sequence for publishing. Will return the highest numbered slot if there is at least requiredCapacity slots available. Have a look at next() for a description on how to use this method.
    
    参数:
    n - the number of sequences to claim
    
    返回:
    the claimed sequence value
    
    抛出:
    
    InsufficientCapacityException - InsufficientCapacityException
  - publish
```
void publish(long sequence)
```
    Publishes a sequence. Call when the event has been filled.
    
    参数:
    sequence - sequence
  - publish
```
void publish(long lo,
           long hi)
```
    Batch publish sequences. Called when all of the events have been filled.
    
    参数:
    lo - first sequence number to publish
    hi - last sequence number to publish

接口 Sequenced

方法概要

方法详细资料

getBufferSize

hasAvailableCapacity

remainingCapacity

next

next

tryNext

tryNext

publish

publish