io.opentracing.v_030

Interface ActiveSpan.Continuation

All Known Subinterfaces:

NoopActiveSpanSource.NoopContinuation

Enclosing interface:

ActiveSpan

public static interface ActiveSpan.Continuation

A ActiveSpan.Continuation can be used once to activate a Span along with any non-OpenTracing execution context (e.g., MDC), then deactivate when processing activity moves on to another Span. (In practice, this active period typically extends for the length of a deferred async closure invocation.)

Most users do not directly interact with ActiveSpan.Continuation, activate() or ActiveSpan.deactivate(), but rather use ActiveSpanSource-aware Runnables/Callables/Executors. Those higher-level primitives do not need to be defined within the OpenTracing core API, and so they are not.

See Also:

ActiveSpanSource.makeActive(Span)

Method Summary

Modifier and Type	Method and Description
ActiveSpan	activate() Make the Span (and other execution context) encapsulated by this ActiveSpan.Continuation active and return it.

Method Detail

activate

ActiveSpan activate()

Make the Span (and other execution context) encapsulated by this ActiveSpan.Continuation active and return it.

NOTE: It is an error to call activate() more than once on a single Continuation instance.

Returns:

a handle to the newly-activated ActiveSpan

See Also:

ActiveSpanSource.makeActive(Span)