com.lightstep.tracer.shared

Class PropagatorStack

java.lang.Object

com.lightstep.tracer.shared.PropagatorStack

All Implemented Interfaces:

Propagator

public final class PropagatorStack
extends Object
implements Propagator

PropagatorStack contains a list of Propagator instances, while exposing a single Propagator interface. Propagator instances are added through pushPropagator. On extract, PropagatorStack tries each Propagator, starting at the top, stopping with the first SpanContext that is successfully extracted. On inject, PropagatorStack inserts all propagation formats into the carrier.

Field Summary

Fields inherited from interface com.lightstep.tracer.shared.Propagator

BINARY, HTTP_HEADERS, TEXT_MAP

Constructor Summary

Constructors

Constructor and Description
PropagatorStack(io.opentracing.propagation.Format format) Creates a new PropagatorStack associated with the specified Format.

Method Summary

Modifier and Type	Method and Description
<C> SpanContext	extract(C carrier)
io.opentracing.propagation.Format	format()
<C> void	inject(SpanContext context, C carrier)
PropagatorStack	pushPropagator(Propagator propagator) Pushes a Propagator onto the top of the stack.

Methods inherited from class java.lang.Object

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

Constructor Detail

PropagatorStack

public PropagatorStack(io.opentracing.propagation.Format format)

Creates a new PropagatorStack associated with the specified Format. Observe that a new Format should *not* be created if the data is being propagated through http headers or a text map. Instead, use the respective builtin Format. In case of doubt, contact LightStep for advice.

Parameters:

format - Instance of Format associated with this PropagatorStack.

Method Detail

format

public io.opentracing.propagation.Format format()

pushPropagator

public PropagatorStack pushPropagator(Propagator propagator)

Pushes a Propagator onto the top of the stack.

Parameters:

propagator - Instance of Propagator used as part of extraction and injection.

extract

public <C> SpanContext extract(C carrier)

Specified by:

extract in interface Propagator

inject

public <C> void inject(SpanContext context,
                       C carrier)

Specified by:

inject in interface Propagator