Package io.opentelemetry.context

Class ArrayBasedContext

java.lang.Object

io.opentelemetry.context.ArrayBasedContext

All Implemented Interfaces:

Context

final class ArrayBasedContext
extends java.lang.Object
implements Context

Field Summary

Fields

Modifier and Type	Field	Description
private java.lang.Object[]	entries
private static Context	ROOT

Constructor Summary

Constructors

Modifier	Constructor	Description
private	ArrayBasedContext(java.lang.Object[] entries)

Method Summary

Modifier and Type	Method	Description
<V> V	get(ContextKey<V> key)	Returns the value stored in this Context for the given ContextKey, or null if there is no value for the key in this context.
(package private) static Context	root()	Returns the root Context which all other Context are derived from.
java.lang.String	toString()
<V> Context	with(ContextKey<V> key, V value)	Returns a new context with the given key value set.

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.opentelemetry.context.Context

makeCurrent, with, wrap, wrap, wrap, wrap, wrap, wrapConsumer, wrapConsumer, wrapFunction, wrapFunction, wrapSupplier

Field Detail

ROOT

private static final Context ROOT

entries

private final java.lang.Object[] entries

Constructor Detail

ArrayBasedContext

private ArrayBasedContext(java.lang.Object[] entries)

Method Detail

root

static Context root()

Description copied from interface: Context

Returns the root Context which all other Context are derived from.

It should generally not be required to use the root Context directly - instead, use Context.current() to operate on the current Context. Only use this method if you are absolutely sure you need to disregard the current Context - this almost always is only a workaround hiding an underlying context propagation issue.

get

@Nullable
public <V> V get(ContextKey<V> key)

Description copied from interface: Context

Returns the value stored in this Context for the given ContextKey, or null if there is no value for the key in this context.

Specified by:

get in interface Context

with

public <V> Context with(ContextKey<V> key,
                        V value)

Description copied from interface: Context

Returns a new context with the given key value set.

 Context withCredential = Context.current().with(CRED_KEY, cred);
 withCredential.wrap(new Runnable() {
   public void run() {
      readUserRecords(userId, CRED_KEY.get());
   }
 }).run();
 

Note that multiple calls to Context.with(ContextKey, Object) can be chained together.

 context.with(K1, V1).with(K2, V2);
 

Nonetheless, Context should not be treated like a general purpose map with a large number of keys and values — combine multiple related items together into a single key instead of separating them. But if the items are unrelated, have separate keys for them.

Specified by:

with in interface Context

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object