io.mats3.serial.impl

Class MatsTraceFieldImpl.CallImpl<Z>

java.lang.Object

io.mats3.serial.impl.MatsTraceFieldImpl.CallImpl<Z>

All Implemented Interfaces:

MatsTrace.Call<Z>, java.lang.Cloneable

Enclosing class:

MatsTraceFieldImpl<Z>

public static class MatsTraceFieldImpl.CallImpl<Z>
extends java.lang.Object
implements MatsTrace.Call<Z>, java.lang.Cloneable

Represents an entry in the MatsTrace.

Nested Class Summary

Nested classes/interfaces inherited from interface io.mats3.serial.MatsTrace.Call

MatsTrace.Call.CallType, MatsTrace.Call.Channel, MatsTrace.Call.MessagingModel

Method Summary

Modifier and Type	Method and Description
protected MatsTraceFieldImpl.CallImpl<Z>	clone()
long	getCalledTimestamp()
java.lang.String	getCallingAppName()
java.lang.String	getCallingAppVersion()
java.lang.String	getCallingHost()
MatsTrace.Call.CallType	getCallType()
Z	getData()
java.lang.String	getDebugInfo()
java.lang.String	getFrom()
java.lang.String	getMatsMessageId()
long	getReplyFromSpanId()
java.util.List<MatsTrace.Call.Channel>	getReplyStack()
int	getReplyStackHeight()
MatsTrace.Call.Channel	getTo()
MatsTraceFieldImpl.CallImpl<Z>	setDebugInfo(java.lang.String callingAppName, java.lang.String callingAppVersion, java.lang.String callingHost, java.lang.String debugInfo) Can only be set once.
java.lang.String	toString()
java.lang.String	toStringFromMatsTrace(long startTimestamp, int maxStackSize, int maxToStageIdLength, boolean printNulLData)

Methods inherited from class java.lang.Object

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

Method Detail

setDebugInfo

public MatsTraceFieldImpl.CallImpl<Z> setDebugInfo(java.lang.String callingAppName,
                                                   java.lang.String callingAppVersion,
                                                   java.lang.String callingHost,
                                                   java.lang.String debugInfo)

Description copied from interface: MatsTrace.Call

Can only be set once.

Specified by:

setDebugInfo in interface MatsTrace.Call<Z>

getCallingAppName

public java.lang.String getCallingAppName()

Specified by:

getCallingAppName in interface MatsTrace.Call<Z>

getCallingAppVersion

public java.lang.String getCallingAppVersion()

Specified by:

getCallingAppVersion in interface MatsTrace.Call<Z>

getCallingHost

public java.lang.String getCallingHost()

Specified by:

getCallingHost in interface MatsTrace.Call<Z>

getCalledTimestamp

public long getCalledTimestamp()

Specified by:

getCalledTimestamp in interface MatsTrace.Call<Z>

getMatsMessageId

public java.lang.String getMatsMessageId()

Specified by:

getMatsMessageId in interface MatsTrace.Call<Z>

Returns:

the Mats Message Id, a guaranteed-globally-unique id for this particular message - it SHALL be constructed as follows: MatsTrace.getFlowId() + "_" + flow-unique messageId.

getDebugInfo

public java.lang.String getDebugInfo()

Specified by:

getDebugInfo in interface MatsTrace.Call<Z>

getCallType

public MatsTrace.Call.CallType getCallType()

Specified by:

getCallType in interface MatsTrace.Call<Z>

getReplyFromSpanId

public long getReplyFromSpanId()

Specified by:

getReplyFromSpanId in interface MatsTrace.Call<Z>

Returns:

when MatsTrace.Call.getCallType() is REPLY, the value of the REQUEST's SpanId is returned, otherwise an IllegalStateException is thrown.

getFrom

public java.lang.String getFrom()

Specified by:

getFrom in interface MatsTrace.Call<Z>

Returns:

the stageId that sent this call - will most probably be the string "-nulled-" for any other Call than the MatsTrace.getCurrentCall(), to conserve space in the MatsTrace. The rationale for this, is that if those Calls are available, they are there for debug purposes only, and then you can use the order of the Calls to see who is the caller: The previous Call's "to" is the "from" of this Call.

getTo

public MatsTrace.Call.Channel getTo()

Specified by:

getTo in interface MatsTrace.Call<Z>

Returns:

the endpointId/stageId this Call concerns, wrapped in a MatsTrace.Call.Channel to also specify the MatsTrace.Call.MessagingModel in use.

getData

public Z getData()

Specified by:

getData in interface MatsTrace.Call<Z>

getReplyStack

public java.util.List<MatsTrace.Call.Channel> getReplyStack()

Specified by:

getReplyStack in interface MatsTrace.Call<Z>

Returns:

a COPY of the stack.

getReplyStackHeight

public int getReplyStackHeight()

Specified by:

getReplyStackHeight in interface MatsTrace.Call<Z>

Returns:

the stack height of this Call - which is the number of elements below this call. I.e. for a REPLY to a Terminator, the stack is of size 0 (there are no more elements to REPLY to), while for the first REQUEST from an initiator, the stack is of size 1 (the endpointId for the Terminator is the one element below this Call).

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

toStringFromMatsTrace

public java.lang.String toStringFromMatsTrace(long startTimestamp,
                                              int maxStackSize,
                                              int maxToStageIdLength,
                                              boolean printNulLData)

clone

protected MatsTraceFieldImpl.CallImpl<Z> clone()

Overrides:

clone in class java.lang.Object