rocks.inspectit.agent.java.sdk.opentracing.internal.impl

Class SpanBuilderImpl

java.lang.Object

rocks.inspectit.agent.java.sdk.opentracing.internal.impl.SpanBuilderImpl

All Implemented Interfaces:

io.opentracing.SpanContext, io.opentracing.Tracer.SpanBuilder

public class SpanBuilderImpl
extends java.lang.Object
implements io.opentracing.Tracer.SpanBuilder

Builder for the span. Note that builder is delegating the calls to the span that's created immediately on the builder initialization. This way we save the copying of the data to the span later on.

Limitations: This span implementation is saving only one (first) referenced context as the parent. For any additional referenced contexts only the baggage propagation will be done.

Constructor Summary

Constructors

Constructor and Description
SpanBuilderImpl(TracerImpl tracer, java.lang.String operationName) Creates new span builder.

Method Summary

Modifier and Type	Method and Description
SpanBuilderImpl	addReference(java.lang.String referenceType, io.opentracing.SpanContext referencedContext)
SpanBuilderImpl	asChildOf(io.opentracing.Span parent)
SpanBuilderImpl	asChildOf(io.opentracing.SpanContext parent)
java.lang.Iterable<java.util.Map.Entry<java.lang.String,java.lang.String>>	baggageItems()
SpanImpl	build() Builds (resolves the context) the span but does not start it.
SpanBuilderImpl	doNotReport() Explicitly states that the span created should not be reported.
SpanImpl	start()
SpanBuilderImpl	withStartTimestamp(long microseconds)
SpanBuilderImpl	withTag(java.lang.String key, boolean value)
SpanBuilderImpl	withTag(java.lang.String key, java.lang.Number value)
SpanBuilderImpl	withTag(java.lang.String key, java.lang.String value)

Methods inherited from class java.lang.Object

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

Constructor Detail

SpanBuilderImpl

public SpanBuilderImpl(TracerImpl tracer,
                       java.lang.String operationName)

Creates new span builder.

Parameters:

tracer - TracerImpl

operationName - Operation name.

Method Detail

baggageItems

public java.lang.Iterable<java.util.Map.Entry<java.lang.String,java.lang.String>> baggageItems()

Specified by:

baggageItems in interface io.opentracing.SpanContext

asChildOf

public SpanBuilderImpl asChildOf(io.opentracing.SpanContext parent)

Specified by:

asChildOf in interface io.opentracing.Tracer.SpanBuilder

asChildOf

public SpanBuilderImpl asChildOf(io.opentracing.Span parent)

Specified by:

asChildOf in interface io.opentracing.Tracer.SpanBuilder

addReference

public SpanBuilderImpl addReference(java.lang.String referenceType,
                                    io.opentracing.SpanContext referencedContext)

If the parent is not set this method will set the passed context as the main referenced context. All the baggage from the context will be passed no matter if the parent is already set or not.

Specified by:

addReference in interface io.opentracing.Tracer.SpanBuilder

withTag

public SpanBuilderImpl withTag(java.lang.String key,
                               java.lang.String value)

Specified by:

withTag in interface io.opentracing.Tracer.SpanBuilder

withTag

public SpanBuilderImpl withTag(java.lang.String key,
                               boolean value)

Specified by:

withTag in interface io.opentracing.Tracer.SpanBuilder

withTag

public SpanBuilderImpl withTag(java.lang.String key,
                               java.lang.Number value)

Specified by:

withTag in interface io.opentracing.Tracer.SpanBuilder

withStartTimestamp

public SpanBuilderImpl withStartTimestamp(long microseconds)

Specified by:

withStartTimestamp in interface io.opentracing.Tracer.SpanBuilder

doNotReport

public SpanBuilderImpl doNotReport()

Explicitly states that the span created should not be reported.

Returns:

SpanBuilderImpl for connecting.

start

public SpanImpl start()

Specified by:

start in interface io.opentracing.Tracer.SpanBuilder

build

public SpanImpl build()

Builds (resolves the context) the span but does not start it. The method returns the built span.

Returns:

the span which has been built