io.aeron.driver.status

Class StreamPositionCounter

java.lang.Object

io.aeron.driver.status.StreamPositionCounter

public class StreamPositionCounter
extends java.lang.Object

Allocates UnsafeBufferPosition counters on a stream of messages. Positions tracked in bytes include:

• PublisherLimit: Limit for flow controlling a Publication steam.
• SenderPos: Highest position on a Publication stream sent to the media.
• SenderLimit: Limit for flow controlling a Sender of a stream.
• ReceiverHwm: Highest position by the Receiver when rebuilding an Image of a stream.
• SubscriberPos: Consumption position in an Image of a stream for each Subscriber.

Field Summary

Fields

Modifier and Type	Field and Description
static int	CHANNEL_OFFSET Offset in the key meta data for the channel of the counter.
static int	MAX_CHANNEL_LENGTH The maximum length in bytes of the encoded channel identity.
static int	REGISTRATION_ID_OFFSET Offset in the key meta data for the registration id of the counter.
static int	SESSION_ID_OFFSET Offset in the key meta data for the session id of the counter.
static int	STREAM_ID_OFFSET Offset in the key meta data for the stream id of the counter.

Constructor Summary

Constructors

Constructor and Description
StreamPositionCounter()

Method Summary

Modifier and Type	Method and Description
static org.agrona.concurrent.status.UnsafeBufferPosition	allocate(java.lang.String name, int typeId, org.agrona.concurrent.status.CountersManager countersManager, long registrationId, int sessionId, int streamId, java.lang.String channel) Allocate a counter for tracking a position on a stream of messages.
static org.agrona.concurrent.status.UnsafeBufferPosition	allocate(java.lang.String name, int typeId, org.agrona.concurrent.status.CountersManager countersManager, long registrationId, int sessionId, int streamId, java.lang.String channel, java.lang.String suffix) Allocate a counter for tracking a position on a stream of messages.
static java.lang.String	labelName(int typeId) Return the label name for a counter type identifier.

Methods inherited from class java.lang.Object

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

Field Detail

REGISTRATION_ID_OFFSET

public static final int REGISTRATION_ID_OFFSET

Offset in the key meta data for the registration id of the counter.

See Also:

Constant Field Values

SESSION_ID_OFFSET

public static final int SESSION_ID_OFFSET

Offset in the key meta data for the session id of the counter.

See Also:

Constant Field Values

STREAM_ID_OFFSET

public static final int STREAM_ID_OFFSET

Offset in the key meta data for the stream id of the counter.

See Also:

Constant Field Values

CHANNEL_OFFSET

public static final int CHANNEL_OFFSET

Offset in the key meta data for the channel of the counter.

See Also:

Constant Field Values

MAX_CHANNEL_LENGTH

public static final int MAX_CHANNEL_LENGTH

The maximum length in bytes of the encoded channel identity.

See Also:

Constant Field Values

Constructor Detail

StreamPositionCounter

public StreamPositionCounter()

Method Detail

allocate

public static org.agrona.concurrent.status.UnsafeBufferPosition allocate(java.lang.String name,
                                                                         int typeId,
                                                                         org.agrona.concurrent.status.CountersManager countersManager,
                                                                         long registrationId,
                                                                         int sessionId,
                                                                         int streamId,
                                                                         java.lang.String channel)

Allocate a counter for tracking a position on a stream of messages.

Parameters:

name - of the counter for the label.

typeId - of the counter for classification.

countersManager - from which to allocated the underlying storage.

registrationId - to be associated with the counter.

sessionId - for the stream of messages.

streamId - for the stream of messages.

channel - for the stream of messages.

Returns:

a new UnsafeBufferPosition for tracking the stream.

allocate

public static org.agrona.concurrent.status.UnsafeBufferPosition allocate(java.lang.String name,
                                                                         int typeId,
                                                                         org.agrona.concurrent.status.CountersManager countersManager,
                                                                         long registrationId,
                                                                         int sessionId,
                                                                         int streamId,
                                                                         java.lang.String channel,
                                                                         java.lang.String suffix)

Allocate a counter for tracking a position on a stream of messages.

Parameters:

name - of the counter for the label.

typeId - of the counter for classification.

countersManager - from which to allocated the underlying storage.

registrationId - to be associated with the counter.

sessionId - for the stream of messages.

streamId - for the stream of messages.

channel - for the stream of messages.

suffix - for the label.

Returns:

a new UnsafeBufferPosition for tracking the stream.

labelName

public static java.lang.String labelName(int typeId)

Return the label name for a counter type identifier.

Parameters:

typeId - of the counter.

Returns:

the label name as a String.