io.spine.server.trace

Interface TracerFactory

All Superinterfaces:

java.lang.AutoCloseable

@SPI
public interface TracerFactory
extends java.lang.AutoCloseable

A factory of Tracers of signal messages.

Each tracer is created for a single signal and should not be reused.

Implementations may choose to perform I/O operations (i.e. send traces via network) on close(). It is expected in general that each call to TracerFactory.trace(io.spine.server.ContextSpec, io.spine.core.Signal<?, ?, ?>) results in some tracing data produced, however, implementations may ignore some signals.

Method Summary

Modifier and Type	Method and Description
Tracer	trace(ContextSpec context, io.spine.core.Signal<?,?,?> signalMessage) Creates a new instance of Tracer for the given signal.

Methods inherited from interface java.lang.AutoCloseable

close

Method Detail

trace

Tracer trace(ContextSpec context,
             io.spine.core.Signal<?,?,?> signalMessage)

Creates a new instance of Tracer for the given signal.

The tracer will be closed externally once it is no longer needed.

Parameters:

context - specification of the Bounded Context for signal of which the tracer is created

signalMessage - the message to trace

Returns:

new Tracer