io.opentelemetry.correlationcontext

Class EntryKey

java.lang.Object

io.opentelemetry.correlationcontext.EntryKey

@Immutable
public abstract class EntryKey
extends Object

A key to a value stored in a CorrelationContext.

Each EntryKey has a String name. Names have a maximum length of MAX_LENGTH and contain only printable ASCII characters.

EntryKeys are designed to be used as constants. Declaring each key as a constant prevents key names from being validated multiple times.

Since:

0.1.0

Field Summary

Fields

Modifier and Type	Field and Description
static int	MAX_LENGTH The maximum length for an entry key name.

Method Summary

Modifier and Type	Method and Description
static EntryKey	create(String name) Constructs an EntryKey with the given name.
abstract String	getName() Returns the name of the key.

Methods inherited from class java.lang.Object

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

Field Detail

MAX_LENGTH

public static final int MAX_LENGTH

The maximum length for an entry key name. The value is 255.

Since:

0.1.0

See Also:

Constant Field Values

Method Detail

create

public static EntryKey create(String name)

Constructs an EntryKey with the given name.

The name must meet the following requirements:

1. It cannot be longer than MAX_LENGTH.
2. It can only contain printable ASCII characters.

Parameters:

name - the name of the key.

Returns:

an EntryKey with the given name.

Throws:

IllegalArgumentException - if the name is not valid.

Since:

0.1.0

getName

public abstract String getName()

Returns the name of the key.

Returns:

the name of the key.

Since:

0.1.0