io.opencensus.tags

Class TagValue

java.lang.Object

io.opencensus.tags.TagValue

@Immutable
public abstract class TagValue
extends Object

A validated tag value.

Validation ensures that the String has a maximum length of MAX_LENGTH and contains only printable ASCII characters.

Since:

0.8

Field Summary

Fields

Modifier and Type	Field and Description
static int	MAX_LENGTH The maximum length for a tag value.

Method Summary

Modifier and Type	Method and Description
abstract String	asString() Returns the tag value as a String.
static TagValue	create(String value) Constructs a TagValue from the given string.

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 a tag value. The value is 255.

Since:

0.8

See Also:

Constant Field Values

Method Detail

create

public static TagValue create(String value)

Constructs a TagValue from the given string. The string must meet the following requirements:

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

Parameters:

value - the tag value.

Throws:

IllegalArgumentException - if the String is not valid.

Since:

0.8

asString

public abstract String asString()

Returns the tag value as a String.

Returns:

the tag value as a String.

Since:

0.8