Package io.opentelemetry.api.incubator.logs

Interface AnyValue<T>

Type Parameters:

T - the type. See getValue() for description of types.

public interface AnyValue<T>

AnyValue mirrors the proto AnyValue message type, and is used to model any type.

It can be used to represent:

• Primitive values via of(long), of(String), of(boolean), of(double).
• String-keyed maps (i.e. associative arrays, dictionaries) via of(KeyAnyValue...), of(Map). Note, because map values are type AnyValue, maps can be nested within other maps.
• Arrays (heterogeneous or homogenous) via of(AnyValue[]). Note, because array values are type AnyValue, arrays can contain primitives, complex types like maps or arrays, or any combination.
• Raw bytes via of(byte[])

Method Summary

Modifier and Type	Method	Description
String	asString()	Return a string encoding of this AnyValue.
AnyValueType	getType()	Returns the type of this AnyValue.
T	getValue()	Returns the value for this AnyValue.
static AnyValue<Boolean>	of(boolean value)	Returns an AnyValue for the boolean value.
static AnyValue<ByteBuffer>	of(byte[] value)	Returns an AnyValue for the byte[] value.
static AnyValue<Double>	of(double value)	Returns an AnyValue for the double value.
static AnyValue<Long>	of(long value)	Returns an AnyValue for the long value.
static AnyValue<List<AnyValue<?>>>	of(AnyValue<?>... value)	Returns an AnyValue for the array of AnyValue values.
static AnyValue<List<KeyAnyValue>>	of(KeyAnyValue... value)	Returns an AnyValue for the array of KeyAnyValue values.
static AnyValue<String>	of(String value)	Returns an AnyValue for the String value.
static AnyValue<List<AnyValue<?>>>	of(List<AnyValue<?>> value)	Returns an AnyValue for the list of AnyValue values.
static AnyValue<List<KeyAnyValue>>	of(Map<String,AnyValue<?>> value)	Returns an AnyValue for the Map of key, AnyValue.

Method Details

of

static AnyValue<String> of(String value)

Returns an AnyValue for the String value.

of

static AnyValue<Boolean> of(boolean value)

Returns an AnyValue for the boolean value.

of

static AnyValue<Long> of(long value)

Returns an AnyValue for the long value.

of

static AnyValue<Double> of(double value)

Returns an AnyValue for the double value.

of

static AnyValue<ByteBuffer> of(byte[] value)

Returns an AnyValue for the byte[] value.

of

static AnyValue<List<AnyValue<?>>> of(AnyValue<?>... value)

Returns an AnyValue for the array of AnyValue values.

of

static AnyValue<List<AnyValue<?>>> of(List<AnyValue<?>> value)

Returns an AnyValue for the list of AnyValue values.

of

static AnyValue<List<KeyAnyValue>> of(KeyAnyValue... value)

Returns an AnyValue for the array of KeyAnyValue values. KeyAnyValue.getKey() values should not repeat - duplicates may be dropped.

of

static AnyValue<List<KeyAnyValue>> of(Map<String,AnyValue<?>> value)

Returns an AnyValue for the Map of key, AnyValue.

getType

AnyValueType getType()

Returns the type of this AnyValue. Useful for building switch statements.

getValue

T getValue()

Returns the value for this AnyValue.

The return type varies by getType() as described below:

• AnyValueType.STRING returns String
• AnyValueType.BOOLEAN returns boolean
• AnyValueType.LONG returns long
• AnyValueType.DOUBLE returns double
• AnyValueType.ARRAY returns List of AnyValue
• AnyValueType.KEY_VALUE_LIST returns List of KeyAnyValue
• AnyValueType.BYTES returns read only ByteBuffer. See ByteBuffer.asReadOnlyBuffer().

asString

String asString()

Return a string encoding of this AnyValue. This is intended to be a fallback serialized representation in case there is no suitable encoding that can utilize getType() / getValue() to serialize specific types.