Package brave.propagation

Class TraceContextOrSamplingFlags

java.lang.Object

brave.propagation.TraceContextOrSamplingFlags

public final class TraceContextOrSamplingFlags
extends Object

Union type that contains only one of trace context, trace ID context or sampling flags. This type is designed for use with Tracer.nextSpan(TraceContextOrSamplingFlags).

Users should not create instances of this, rather use TraceContext.Extractor provided by a Propagation implementation such as Propagation.B3_STRING.

Those implementing Propagation should use the following advice:

   
If you have the trace and span ID, use create(TraceContext)
   
If you have only a trace ID, use create(TraceIdContext)
   
Otherwise, use create(SamplingFlags)
 

If your propagation implementation adds extra data, append it via TraceContextOrSamplingFlags.Builder.addExtra(Object).

This started as a port of com.github.kristofa.brave.TraceData, which served the same purpose.

See Also:

TraceContext.Extractor

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	TraceContextOrSamplingFlags.Builder

Field Summary

Fields

Modifier and Type	Field	Description
static TraceContextOrSamplingFlags	EMPTY

Method Summary

Modifier and Type	Method	Description
TraceContext	context()
static TraceContextOrSamplingFlags	create(SamplingFlags flags)
static TraceContextOrSamplingFlags	create(TraceContext context)
static TraceContextOrSamplingFlags	create(TraceContext.Builder builder)	Deprecated. call one of the other factory methods vs allocating an exception
static TraceContextOrSamplingFlags	create(TraceIdContext traceIdContext)
boolean	equals(Object o)
List<Object>	extra()	Non-empty when context() is null: A list of additional data extracted from the carrier.
int	hashCode()
static TraceContextOrSamplingFlags.Builder	newBuilder()
Boolean	sampled()	Returns SamplingFlags.sampled(), regardless of subtype.
TraceContextOrSamplingFlags	sampled(Boolean sampled)
SamplingFlags	samplingFlags()
TraceContextOrSamplingFlags.Builder	toBuilder()
String	toString()
TraceIdContext	traceIdContext()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

EMPTY

public static final TraceContextOrSamplingFlags EMPTY

Method Detail

newBuilder

public static TraceContextOrSamplingFlags.Builder newBuilder()

sampled

@Nullable
public Boolean sampled()

Returns SamplingFlags.sampled(), regardless of subtype.

sampled

public TraceContextOrSamplingFlags sampled(@Nullable
                                           Boolean sampled)

context

@Nullable
public TraceContext context()

traceIdContext

@Nullable
public TraceIdContext traceIdContext()

samplingFlags

@Nullable
public SamplingFlags samplingFlags()

extra

public final List<Object> extra()

Non-empty when context() is null: A list of additional data extracted from the carrier.

See Also:

TraceContext.extra()

toBuilder

public final TraceContextOrSamplingFlags.Builder toBuilder()

toString

public String toString()

Overrides:

toString in class Object

create

public static TraceContextOrSamplingFlags create(TraceContext context)

create

public static TraceContextOrSamplingFlags create(TraceIdContext traceIdContext)

create

public static TraceContextOrSamplingFlags create(SamplingFlags flags)

create

@Deprecated
public static TraceContextOrSamplingFlags create(TraceContext.Builder builder)

Deprecated. call one of the other factory methods vs allocating an exception

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object