io.mats3.impl.jms

Class JmsMatsMessage<Z>

java.lang.Object

io.mats3.impl.jms.JmsMatsMessage<Z>

All Implemented Interfaces:

MatsOutgoingMessage, MatsOutgoingMessage.MatsEditableOutgoingMessage, MatsOutgoingMessage.MatsSentOutgoingMessage

public class JmsMatsMessage<Z>
extends java.lang.Object
implements MatsOutgoingMessage.MatsEditableOutgoingMessage, MatsOutgoingMessage.MatsSentOutgoingMessage

Holds the entire contents of a "Mats Message" - so that it can be sent later.

Nested Class Summary

Nested classes/interfaces inherited from interface io.mats3.api.intercept.MatsOutgoingMessage

MatsOutgoingMessage.DispatchType, MatsOutgoingMessage.MatsEditableOutgoingMessage, MatsOutgoingMessage.MatsSentOutgoingMessage, MatsOutgoingMessage.MessageType

Method Summary

Modifier and Type	Method and Description
void	addBytes(java.lang.String key, byte[] payload) Add byte[] sideload to outgoing message.
void	addString(java.lang.String key, java.lang.String payload) Add String sideload to outgoing message.
boolean	equals(java.lang.Object obj)
byte[]	getBytes(java.lang.String key)
java.util.Set<java.lang.String>	getBytesKeys()
java.lang.Object	getData()
int	getDataSerializedSize()
MatsOutgoingMessage.DispatchType	getDispatchType()
long	getEnvelopeCompressionNanos()
long	getEnvelopeProduceNanos()
long	getEnvelopeSerializationNanos()
int	getEnvelopeSerializedSize()
int	getEnvelopeWireSize()
java.lang.String	getFlowId()
java.lang.String	getFrom() Note: For messages out of an initiator, this method and MatsOutgoingMessage.getInitiatorId() returns the same value, i.e.
java.util.Optional<java.lang.Object>	getInitialTargetState()
java.lang.String	getInitiatingAppName()
java.lang.String	getInitiatingAppVersion()
java.lang.String	getInitiatorId() Note: For messages out of an initiator, this method and MatsOutgoingMessage.getFrom() returns the same value, i.e.
java.lang.String	getMatsMessageId()
MatsTrace<Z>	getMatsTrace()
long	getMessageSystemProduceAndSendNanos()
int	getMessageSystemTotalWireSize()
MatsOutgoingMessage.MessageType	getMessageType()
java.util.Optional<java.lang.String>	getReplyTo()
java.util.Optional<java.lang.Object>	getSameStackHeightState()
java.lang.String	getString(java.lang.String key)
java.util.Set<java.lang.String>	getStringKeys()
java.lang.String	getSystemMessageId()
long	getTimeToLive()
java.lang.String	getTo()
java.lang.String	getTraceId()
<T> T	getTraceProperty(java.lang.String propertyName, java.lang.Class<T> type)
java.util.Set<java.lang.String>	getTracePropertyKeys()
java.lang.String	getWhat()
int	hashCode()
boolean	isInteractive()
boolean	isNoAudit()
boolean	isNonPersistent()
java.util.Optional<java.lang.Boolean>	isReplyToSubscription()
boolean	isToSubscription()
static <Z> JmsMatsMessage<Z>	produceMessage(MatsOutgoingMessage.DispatchType dispatchType, long nanosAtStart_ProducingOutgoingMessage, MatsSerializer<Z> matsSerializer, MatsTrace<Z> outgoingMatsTrace, java.lang.Object outgoingMessage, java.lang.Object initialTargetState, java.lang.Object sameStackHeightState, java.util.HashMap<java.lang.String,java.lang.Object> props, java.util.HashMap<java.lang.String,byte[]> bytes, java.util.HashMap<java.lang.String,java.lang.String> strings) NOTE: The Maps are copied/cloned out, so invoker can do whatever he feels like with them afterwards.
void	setSameStackHeightExtraState(java.lang.String key, java.lang.Object object) An interceptor might need to add state to an outgoing message which will be present on incoming message of the next stage of a multi-stage endpoint - i.e.
void	setTraceProperty(java.lang.String propertyName, java.lang.Object object) Set trace property.

Methods inherited from class java.lang.Object

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

Method Detail

produceMessage

public static <Z> JmsMatsMessage<Z> produceMessage(MatsOutgoingMessage.DispatchType dispatchType,
                                                   long nanosAtStart_ProducingOutgoingMessage,
                                                   MatsSerializer<Z> matsSerializer,
                                                   MatsTrace<Z> outgoingMatsTrace,
                                                   java.lang.Object outgoingMessage,
                                                   java.lang.Object initialTargetState,
                                                   java.lang.Object sameStackHeightState,
                                                   java.util.HashMap<java.lang.String,java.lang.Object> props,
                                                   java.util.HashMap<java.lang.String,byte[]> bytes,
                                                   java.util.HashMap<java.lang.String,java.lang.String> strings)

NOTE: The Maps are copied/cloned out, so invoker can do whatever he feels like with them afterwards.

getWhat

public java.lang.String getWhat()

getMatsTrace

public MatsTrace<Z> getMatsTrace()

getTraceId

public java.lang.String getTraceId()

Specified by:

getTraceId in interface MatsOutgoingMessage

getFlowId

public java.lang.String getFlowId()

Specified by:

getFlowId in interface MatsOutgoingMessage

isNonPersistent

public boolean isNonPersistent()

Specified by:

isNonPersistent in interface MatsOutgoingMessage

getTimeToLive

public long getTimeToLive()

Specified by:

getTimeToLive in interface MatsOutgoingMessage

isInteractive

public boolean isInteractive()

Specified by:

isInteractive in interface MatsOutgoingMessage

isNoAudit

public boolean isNoAudit()

Specified by:

isNoAudit in interface MatsOutgoingMessage

getInitiatingAppName

public java.lang.String getInitiatingAppName()

Specified by:

getInitiatingAppName in interface MatsOutgoingMessage

getInitiatingAppVersion

public java.lang.String getInitiatingAppVersion()

Specified by:

getInitiatingAppVersion in interface MatsOutgoingMessage

getInitiatorId

public java.lang.String getInitiatorId()

Description copied from interface: MatsOutgoingMessage

Note: For messages out of an initiator, this method and MatsOutgoingMessage.getFrom() returns the same value, i.e. it is "initiated from", and "from", the same source.

Specified by:

getInitiatorId in interface MatsOutgoingMessage

Returns:

the value supplied to MatsInitiator.MatsInitiate.from(String) at the time of the Mats flow initiation.

getMatsMessageId

public java.lang.String getMatsMessageId()

Specified by:

getMatsMessageId in interface MatsOutgoingMessage

getMessageType

public MatsOutgoingMessage.MessageType getMessageType()

Specified by:

getMessageType in interface MatsOutgoingMessage

getDispatchType

public MatsOutgoingMessage.DispatchType getDispatchType()

Specified by:

getDispatchType in interface MatsOutgoingMessage

getTracePropertyKeys

public java.util.Set<java.lang.String> getTracePropertyKeys()

Specified by:

getTracePropertyKeys in interface MatsOutgoingMessage

getTraceProperty

public <T> T getTraceProperty(java.lang.String propertyName,
                              java.lang.Class<T> type)

Specified by:

getTraceProperty in interface MatsOutgoingMessage

getBytesKeys

public java.util.Set<java.lang.String> getBytesKeys()

Specified by:

getBytesKeys in interface MatsOutgoingMessage

getBytes

public byte[] getBytes(java.lang.String key)

Specified by:

getBytes in interface MatsOutgoingMessage

getStringKeys

public java.util.Set<java.lang.String> getStringKeys()

Specified by:

getStringKeys in interface MatsOutgoingMessage

getString

public java.lang.String getString(java.lang.String key)

Specified by:

getString in interface MatsOutgoingMessage

getFrom

public java.lang.String getFrom()

Description copied from interface: MatsOutgoingMessage

Note: For messages out of an initiator, this method and MatsOutgoingMessage.getInitiatorId() returns the same value, i.e. it is "initiated from", and "from", the same source.

Specified by:

getFrom in interface MatsOutgoingMessage

Returns:

which stage the message is from, or for initiations, the same value as MatsOutgoingMessage.getInitiatorId().

getTo

public java.lang.String getTo()

Specified by:

getTo in interface MatsOutgoingMessage

isToSubscription

public boolean isToSubscription()

Specified by:

isToSubscription in interface MatsOutgoingMessage

getReplyTo

public java.util.Optional<java.lang.String> getReplyTo()

Specified by:

getReplyTo in interface MatsOutgoingMessage

isReplyToSubscription

public java.util.Optional<java.lang.Boolean> isReplyToSubscription()

Specified by:

isReplyToSubscription in interface MatsOutgoingMessage

getSameStackHeightState

public java.util.Optional<java.lang.Object> getSameStackHeightState()

Specified by:

getSameStackHeightState in interface MatsOutgoingMessage

Returns:

the "same stackheight" outgoing state; If this is a Request, it is the state that will be present upon the subsequent Reply. If this is a Next, it is the state present on the nest stage. If it is a Goto, it will be the "intialState" if set - and thus same as MatsOutgoingMessage.getInitialTargetState().

getData

public java.lang.Object getData()

Specified by:

getData in interface MatsOutgoingMessage

Returns:

the outgoing data (DTO)

getInitialTargetState

public java.util.Optional<java.lang.Object> getInitialTargetState()

Specified by:

getInitialTargetState in interface MatsOutgoingMessage

Returns:

for initiations and Goto, it is possible to send along an initial incoming target state - this returns that.

setTraceProperty

public void setTraceProperty(java.lang.String propertyName,
                             java.lang.Object object)

Description copied from interface: MatsOutgoingMessage.MatsEditableOutgoingMessage

Set trace property.

Specified by:

setTraceProperty in interface MatsOutgoingMessage.MatsEditableOutgoingMessage

setSameStackHeightExtraState

public void setSameStackHeightExtraState(java.lang.String key,
                                         java.lang.Object object)

Description copied from interface: MatsOutgoingMessage.MatsEditableOutgoingMessage

An interceptor might need to add state to an outgoing message which will be present on incoming message of the next stage of a multi-stage endpoint - i.e. "extra state" in addition to the State class that the user has specified for the Endpoint.

Only relevant for MatsOutgoingMessage.MessageType.REQUEST, MatsOutgoingMessage.MessageType.NEXT and MatsOutgoingMessage.MessageType.GOTO - will throw IllegalStateException otherwise.

REQUEST: If extra-state is added to an outgoing REQUEST-message from ServiceA.stage1, it will be present again on the subsequent REPLY-message to ServiceA.stage2 (and any subsequent stages).

NEXT: If extra-state is added to an outgoing NEXT-message from ServiceA.stage1, it will be present again on the subsequent incoming message to ServiceA.stage2 (and any subsequent stages).

To add info to the receiving stage of a REQUEST, you may employ MatsOutgoingMessage.MatsEditableOutgoingMessage.addBytes(String, byte[]) and MatsOutgoingMessage.MatsEditableOutgoingMessage.addString(String, String). Given that such extra-state would need support from the receiving endpoint too to make much sense (i.e. an installed interceptor reading and understanding the incoming extra state, typically the same interceptor installed there as the one adding the state), it could just pick up the side load and transfer it over to the extra state if that was desired. Therefore, even though it could be possible to add extra-state to the targeted/receiving endpoint, I've decided against it so far.

The extra-state is available on the stage interception at MatsStageInterceptor.StageCommonContext.getIncomingSameStackHeightExtraState(String, Class).

Specified by:

setSameStackHeightExtraState in interface MatsOutgoingMessage.MatsEditableOutgoingMessage

addBytes

public void addBytes(java.lang.String key,
                     byte[] payload)

Description copied from interface: MatsOutgoingMessage.MatsEditableOutgoingMessage

Add byte[] sideload to outgoing message.

Specified by:

addBytes in interface MatsOutgoingMessage.MatsEditableOutgoingMessage

addString

public void addString(java.lang.String key,
                      java.lang.String payload)

Description copied from interface: MatsOutgoingMessage.MatsEditableOutgoingMessage

Add String sideload to outgoing message.

Specified by:

addString in interface MatsOutgoingMessage.MatsEditableOutgoingMessage

getSystemMessageId

public java.lang.String getSystemMessageId()

Specified by:

getSystemMessageId in interface MatsOutgoingMessage.MatsSentOutgoingMessage

getEnvelopeProduceNanos

public long getEnvelopeProduceNanos()

Specified by:

getEnvelopeProduceNanos in interface MatsOutgoingMessage.MatsSentOutgoingMessage

Returns:

time taken (in nanoseconds) to create the Mats envelope, including serialization of all relevant constituents: DTO, STO and any Trace Properties. Note that this will be a slice of the user lambda timing (getUserLambdaNanos() for both init and stage), as it is done at the time of e.g. invoking processContext.request() inside the user lambda.

getEnvelopeSerializationNanos

public long getEnvelopeSerializationNanos()

Specified by:

getEnvelopeSerializationNanos in interface MatsOutgoingMessage.MatsSentOutgoingMessage

Returns:

time taken (in nanoseconds) to serialize the Mats envelope.

getEnvelopeSerializedSize

public int getEnvelopeSerializedSize()

Specified by:

getEnvelopeSerializedSize in interface MatsOutgoingMessage.MatsSentOutgoingMessage

Returns:

size (in bytes) of the serialized envelope - before compression. Do read the JavaDoc of MatsOutgoingMessage.MatsSentOutgoingMessage.getEnvelopeWireSize() too, as the same applies here: This size only refers to the Mats envelope, not the messaging system's final message size.

getEnvelopeCompressionNanos

public long getEnvelopeCompressionNanos()

Specified by:

getEnvelopeCompressionNanos in interface MatsOutgoingMessage.MatsSentOutgoingMessage

Returns:

time taken (in nanoseconds) to compress the envelope - will be 0 if no compression was applied, while it will return > 0 if compression was applied.

getEnvelopeWireSize

public int getEnvelopeWireSize()

Specified by:

getEnvelopeWireSize in interface MatsOutgoingMessage.MatsSentOutgoingMessage

Returns:

size (in bytes) of the envelope after compression, which will be put inside the messaging system's message envelope. If compression was not applied, returns the same value as MatsOutgoingMessage.MatsSentOutgoingMessage.getEnvelopeSerializedSize(). Note that the returned size is only the (compressed) Mats envelope, and does not include the size of the messaging system's message/envelope and any meta-data that Mats adds to this. This means that the message size on the wire will be larger.

getMessageSystemProduceAndSendNanos

public long getMessageSystemProduceAndSendNanos()

Specified by:

getMessageSystemProduceAndSendNanos in interface MatsOutgoingMessage.MatsSentOutgoingMessage

Returns:

time taken (in nanoseconds) to produce, and then send (transfer) the message to the message broker.

getDataSerializedSize

public int getDataSerializedSize()

Specified by:

getDataSerializedSize in interface MatsOutgoingMessage.MatsSentOutgoingMessage

Returns:

the number of units (bytes or characters) that the outgoing data (DTO) serialized to.

getMessageSystemTotalWireSize

public int getMessageSystemTotalWireSize()

Specified by:

getMessageSystemTotalWireSize in interface MatsOutgoingMessage.MatsSentOutgoingMessage

Returns:

the number of bytes sent on the wire (best approximation), as far as Mats knows. Any overhead from the message system is unknown. Includes the envelope (which includes the TraceProperties), as well as the sideloads (bytes and strings). Implementation might add some more size for metadata. Notice that the strings are just "length()'ed", so any "exotic" characters are still just counted as 1 byte.

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object