io.aeron.logbuffer

Class ExclusiveBufferClaim

java.lang.Object

io.aeron.logbuffer.ExclusiveBufferClaim

public class ExclusiveBufferClaim
extends java.lang.Object

Represents a claimed range in a buffer to be used for recording a message without copy semantics for later commit. ExclusiveBufferClaims offer additional functionality over standard BufferClaims in that the header can be manipulated for setting flags and type. This allows the user to implement things such as their own fragmentation policy. The claimed space is in buffer() between offset() and offset() + length(). When the buffer is filled with message data, use commit() to make it available to subscribers. If the claimed space is no longer required it can be aborted by calling abort(). Data Frame

See Also:

ExclusivePublication.tryClaim(int, ExclusiveBufferClaim)

Constructor Summary

Constructors

Constructor and Description
ExclusiveBufferClaim()

Method Summary

Modifier and Type	Method and Description
void	abort() Abort a claim of the message space to the log buffer so that the log can progress by ignoring this claim.
org.agrona.MutableDirectBuffer	buffer() The referenced buffer to be used.
void	commit() Commit the message to the log buffer so that is it available to subscribers.
byte	flags() Get the value of the flags field.
ExclusiveBufferClaim	flags(byte flags) Set the value of the header flags field.
int	headerType() Get the value of the header type field.
ExclusiveBufferClaim	headerType(int type) Set the value of the header type field.
int	length() The length of the claimed range in the buffer.
int	offset() The offset in the buffer at which the claimed range begins.
long	reservedValue() Get the value stored in the reserve space at the end of a data frame header.
ExclusiveBufferClaim	reservedValue(long value) Write the provided value into the reserved space at the end of the data frame header.
void	wrap(org.agrona.concurrent.AtomicBuffer buffer, int offset, int length) Wrap a region of an underlying log buffer so can can represent a claimed space for use by a publisher.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExclusiveBufferClaim

public ExclusiveBufferClaim()

Method Detail

wrap

public void wrap(org.agrona.concurrent.AtomicBuffer buffer,
                 int offset,
                 int length)

Wrap a region of an underlying log buffer so can can represent a claimed space for use by a publisher.

Parameters:

buffer - to be wrapped.

offset - at which the claimed region begins including space for the header.

length - length of the underlying claimed region including space for the header.

buffer

public org.agrona.MutableDirectBuffer buffer()

The referenced buffer to be used.

Returns:

the referenced buffer to be used..

offset

public int offset()

The offset in the buffer at which the claimed range begins.

Returns:

offset in the buffer at which the range begins.

length

public int length()

The length of the claimed range in the buffer.

Returns:

length of the range in the buffer.

flags

public byte flags()

Get the value of the flags field.

Returns:

the value of the header flags field.

See Also:

DataHeaderFlyweight

flags

public ExclusiveBufferClaim flags(byte flags)

Set the value of the header flags field.

Parameters:

flags - value to be set in the header.

Returns:

this for a fluent API.

See Also:

DataHeaderFlyweight

headerType

public int headerType()

Get the value of the header type field. The lower 16 bits are valid.

Returns:

the value of the header type field.

See Also:

DataHeaderFlyweight

headerType

public ExclusiveBufferClaim headerType(int type)

Set the value of the header type field. The lower 16 bits are valid.

Parameters:

type - value to be set in the header.

Returns:

this for a fluent API.

See Also:

DataHeaderFlyweight

reservedValue

public long reservedValue()

Get the value stored in the reserve space at the end of a data frame header. Note: The value is in ByteOrder.LITTLE_ENDIAN format.

Returns:

the value stored in the reserve space at the end of a data frame header.

See Also:

DataHeaderFlyweight

reservedValue

public ExclusiveBufferClaim reservedValue(long value)

Write the provided value into the reserved space at the end of the data frame header. Note: The value will be written in ByteOrder.LITTLE_ENDIAN format.

Parameters:

value - to be stored in the reserve space at the end of a data frame header.

Returns:

this for fluent API semantics.

See Also:

DataHeaderFlyweight

commit

public void commit()

Commit the message to the log buffer so that is it available to subscribers.

abort

public void abort()

Abort a claim of the message space to the log buffer so that the log can progress by ignoring this claim.