OpenTelemetry Java 1.49.0 · io.opentelemetry.context.propagation.NoopTextMapPropagator

Modifier and Type	Field and Description
private static final NoopTextMapPropagator	INSTANCE

Access	Constructor and Description
pack-priv	NoopTextMapPropagator()

Method Summary

Modifier and Type	Method and Description
public <C> Context	extract(Context the `Context` used to store the extracted value. context, C holds propagation fields. For example, an outgoing message or http request. carrier, TextMapGetter<C> invoked for each propagation key to get data from the carrier. getter) Implements io.opentelemetry.context.propagation.TextMapPropagator.extract. Extracts data from upstream.
public Collection<String>	fields() Implements io.opentelemetry.context.propagation.TextMapPropagator.fields. The propagation fields defined.
pack-priv static TextMapPropagator	getInstance()
public <C> void	inject(Context the `Context` containing the value to be injected. context, C holds propagation fields. For example, an outgoing message or http request. carrier, TextMapSetter<C> invoked for each propagation key to add or remove. setter) Implements io.opentelemetry.context.propagation.TextMapPropagator.inject. Injects data for downstream consumers, for example as HTTP headers.
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll wait wait wait

INSTANCE	back to summary
private static final NoopTextMapPropagator INSTANCE

NoopTextMapPropagator	back to summary
pack-priv NoopTextMapPropagator()

Method Detail

extract back to summary

extract	back to summary
public <C> Context extract(Context context, C carrier, TextMapGetter<C> getter) Implements io.opentelemetry.context.propagation.TextMapPropagator.extract. Doc from io.opentelemetry.context.propagation.TextMapPropagator.extract. Extracts data from upstream. For example, from incoming http headers. The returned Context should contain the extracted data, if any, merged with the data from the passed-in Context. If the incoming information could not be parsed, implementations MUST return the original Context, unaltered. Parameters <C> the type of carrier of the propagation fields, such as an http request. context:Context the `Context` used to store the extracted value. carrier:C holds propagation fields. For example, an outgoing message or http request. getter:TextMapGetter<C> invoked for each propagation key to get data from the carrier. Returns:Context the `Context` containing the extracted data. Annotations @Override

public <C> Context extract(Context context, C carrier, TextMapGetter<C> getter)

Implements io.opentelemetry.context.propagation.TextMapPropagator.extract.

Doc from io.opentelemetry.context.propagation.TextMapPropagator.extract.

Extracts data from upstream. For example, from incoming http headers. The returned Context should contain the extracted data, if any, merged with the data from the passed-in Context.

If the incoming information could not be parsed, implementations MUST return the original Context, unaltered.

Parameters

<C>: the type of carrier of the propagation fields, such as an http request.
context:Context: the Context used to store the extracted value.
carrier:C: holds propagation fields. For example, an outgoing message or http request.
getter:TextMapGetter<C>: invoked for each propagation key to get data from the carrier.

Returns:Context

the Context containing the extracted data.

Annotations

@Override

fields back to summary

fields	back to summary
public Collection<String> fields() Implements io.opentelemetry.context.propagation.TextMapPropagator.fields. Doc from io.opentelemetry.context.propagation.TextMapPropagator.fields. The propagation fields defined. If your carrier is reused, you should delete the fields here before calling `inject(Context, Object, TextMapSetter)` )}. For example, if the carrier is a single-use or immutable request object, you don't need to clear fields as they couldn't have been set before. If it is a mutable, retryable object, successive calls should clear these fields first. Some use cases for this are: Allow pre-allocation of fields, especially in systems like gRPC Metadata Allow a single-pass over an iterator Returns:Collection<String> the fields that will be used by this formatter. Annotations @Override

public Collection<String> fields()

Implements io.opentelemetry.context.propagation.TextMapPropagator.fields.

Doc from io.opentelemetry.context.propagation.TextMapPropagator.fields.

The propagation fields defined. If your carrier is reused, you should delete the fields here before calling inject(Context, Object, TextMapSetter) )}.

For example, if the carrier is a single-use or immutable request object, you don't need to clear fields as they couldn't have been set before. If it is a mutable, retryable object, successive calls should clear these fields first.

Some use cases for this are:

Allow pre-allocation of fields, especially in systems like gRPC Metadata
Allow a single-pass over an iterator

Returns:Collection<String>

the fields that will be used by this formatter.

Annotations

@Override

getInstance	back to summary
pack-priv static TextMapPropagator getInstance()

inject back to summary

inject	back to summary
public <C> void inject(Context context, C carrier, TextMapSetter<C> setter) Implements io.opentelemetry.context.propagation.TextMapPropagator.inject. Doc from io.opentelemetry.context.propagation.TextMapPropagator.inject. Injects data for downstream consumers, for example as HTTP headers. The carrier may be null to facilitate calling this method with a lambda for the `TextMapSetter`, in which case that null will be passed to the `TextMapSetter` implementation. Parameters <C> carrier of propagation fields, such as an http request context:Context the `Context` containing the value to be injected. carrier:C holds propagation fields. For example, an outgoing message or http request. setter:TextMapSetter<C> invoked for each propagation key to add or remove. Annotations @Override

public <C> void inject(Context context, C carrier, TextMapSetter<C> setter)

Implements io.opentelemetry.context.propagation.TextMapPropagator.inject.

Doc from io.opentelemetry.context.propagation.TextMapPropagator.inject.

Injects data for downstream consumers, for example as HTTP headers. The carrier may be null to facilitate calling this method with a lambda for the TextMapSetter, in which case that null will be passed to the TextMapSetter implementation.

Parameters

<C>: carrier of propagation fields, such as an http request
context:Context: the Context containing the value to be injected.
carrier:C: holds propagation fields. For example, an outgoing message or http request.
setter:TextMapSetter<C>: invoked for each propagation key to add or remove.

Annotations

@Override

toString back to summary

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Doc from java.lang.Object.toString. Returns a string representation of the object. Satisfying this method's contract implies a non-`null` result must be returned. Returns:String a string representation of the object Annotations @Override

public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object. Satisfying this method's contract implies a non-null result must be returned.

Returns:String

a string representation of the object

Annotations

@Override

pack-priv final Class NoopTextMapPropagator

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail