public final class TraceContextOrSamplingFlags extends Object
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:
create(TraceContext)
create(TraceIdContext)
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.
TraceContext.Extractor
Modifier and Type | Class | Description |
---|---|---|
static class |
TraceContextOrSamplingFlags.Builder |
Modifier and Type | Field | Description |
---|---|---|
static TraceContextOrSamplingFlags |
EMPTY |
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() |
public static final TraceContextOrSamplingFlags EMPTY
public static TraceContextOrSamplingFlags.Builder newBuilder()
@Nullable public Boolean sampled()
SamplingFlags.sampled()
, regardless of subtype.public TraceContextOrSamplingFlags sampled(@Nullable Boolean sampled)
@Nullable public TraceContext context()
@Nullable public TraceIdContext traceIdContext()
@Nullable public SamplingFlags samplingFlags()
public final List<Object> extra()
context()
is null: A list of additional data extracted from the carrier.TraceContext.extra()
public final TraceContextOrSamplingFlags.Builder toBuilder()
public static TraceContextOrSamplingFlags create(TraceContext context)
public static TraceContextOrSamplingFlags create(TraceIdContext traceIdContext)
public static TraceContextOrSamplingFlags create(SamplingFlags flags)
@Deprecated public static TraceContextOrSamplingFlags create(TraceContext.Builder builder)
Copyright © 2018 OpenZipkin. All rights reserved.