org.axonframework.tracing

Class NoOpSpanFactory.NoOpSpan

java.lang.Object

org.axonframework.tracing.NoOpSpanFactory.NoOpSpan

All Implemented Interfaces:

Span

Enclosing class:

NoOpSpanFactory

public static class NoOpSpanFactory.NoOpSpan
extends Object
implements Span

Constructor Summary

Constructors

Constructor and Description
NoOpSpan()

Method Summary

Modifier and Type	Method and Description
void	end() Ends the span.
SpanScope	makeCurrent() Sets the Span as the current for the current thread.
Span	recordException(Throwable t) Records an exception to the span.
Span	start() Starts the Span.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.axonframework.tracing.Span

run, runCallable, runConsumer, runSupplier, wrapCallable, wrapConsumer, wrapRunnable, wrapSupplier

Constructor Detail

NoOpSpan

public NoOpSpan()

Method Detail

start

public Span start()

Description copied from interface: Span

Starts the Span. However, does not set this span as the span of the current thread. See Span.makeCurrent() in order to do so.

Specified by:

start in interface Span

Returns:

The span for fluent interfacing.

makeCurrent

public SpanScope makeCurrent()

Description copied from interface: Span

Sets the Span as the current for the current thread. The returned SpanScope must be closed before ending the Span, on the same thread, or through a try-with-resources statement in the same thread as this method was called.

You can make a span current on as many threads as you like, but you have to close every SpanScope, or context will leak into the current thread. Note that if this is neglected, the Span.end() method should warn the user in order to report this back to the framework.

Specified by:

makeCurrent in interface Span

Returns:

The scope of the span that must be closed be

end

public void end()

Description copied from interface: Span

Ends the span. All scopes should have been closed at this point. In addition, a span can only be ended once.

If scopes are still open when this method is called, either an exception should be thrown or an error log should be produced to warn the user of the leak. This information can then be reported back to the developers of the framework for a fix.

Specified by:

end in interface Span

recordException

public Span recordException(Throwable t)

Description copied from interface: Span

Records an exception to the span. This will be reported to the APM tooling, which can show more information about the error in the trace. This method does not end the span.

Specified by:

recordException in interface Span

Parameters:

t - The exception to record

Returns:

The span for fluent interfacing.