io.opencensus.tags

Class TagsComponent

java.lang.Object

io.opencensus.tags.TagsComponent

public abstract class TagsComponent
extends Object

Class that holds the implementation for Tagger and TagPropagationComponent.

All objects returned by methods on TagsComponent are cacheable.

Constructor Summary

Constructors

Constructor and Description
TagsComponent()

Method Summary

Modifier and Type	Method and Description
abstract TaggingState	getState() Returns the current TaggingState.
abstract Tagger	getTagger() Returns the Tagger for this implementation.
abstract TagPropagationComponent	getTagPropagationComponent() Returns the TagPropagationComponent for this implementation.
abstract void	setState(TaggingState state) Deprecated. This method is deprecated because other libraries could cache the result of getState(), use a stale value, and behave incorrectly. It is only safe to call early in initialization. This method throws IllegalStateException after getState() has been called, in order to limit changes to the result of getState().

Methods inherited from class java.lang.Object

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

Constructor Detail

TagsComponent

public TagsComponent()

Method Detail

getTagger

public abstract Tagger getTagger()

Returns the Tagger for this implementation.

getTagPropagationComponent

public abstract TagPropagationComponent getTagPropagationComponent()

Returns the TagPropagationComponent for this implementation.

getState

public abstract TaggingState getState()

Returns the current TaggingState.

When no implementation is available, getState always returns TaggingState.DISABLED.

Once getState() is called, subsequent calls to setState(TaggingState) will throw an IllegalStateException.

Returns:

the current TaggingState.

setState

@Deprecated
public abstract void setState(TaggingState state)

Deprecated. This method is deprecated because other libraries could cache the result of getState(), use a stale value, and behave incorrectly. It is only safe to call early in initialization. This method throws IllegalStateException after getState() has been called, in order to limit changes to the result of getState().

Sets the current TaggingState.

When no implementation is available, setState does not change the state.

Parameters:

state - the new TaggingState.

Throws:

IllegalStateException - if getState() was previously called.