public class FilterPathTracker extends MessageListenerAdapter implements MessageCreationListener
Constructor and Description |
---|
FilterPathTracker() |
Modifier and Type | Method and Description |
---|---|
void |
dispose() |
CircuitTracker |
getCircuitTracker(Message m) |
void |
messageCreated(Message m,
java.lang.Object source)
Called once the message is created, but before the source has populated any properties.
|
void |
postCircuitInvocation(Circuit c,
Message m,
boolean result,
java.lang.Object context)
Called after a chain of Filters in the Circuit has been invoked.
|
void |
postCircuitProcessing(Message message,
int result)
Called when all processing in the Circuit-space is completed.
|
void |
postFilterInvocation(Circuit c,
MessageProcessor mp,
Message m,
int resultType,
MessageProcessor caller,
java.lang.Object context)
This method is called when a Filter's MessageProcessor has finished execution.
|
void |
preCircuitInvocation(Circuit c,
Message m,
java.lang.Object context)
Called before the first Filter in a given Circuit is invoked.
|
void |
preCircuitProcessing(Circuit c,
Message m,
java.lang.Object context)
Called when the message originator has completed initializing the Message, and we are about to
start processing in the Circuit-space.
|
void |
preFaultHandlerInvocation(Circuit c,
MessageProcessor faultHandler,
Message m,
CircuitAbortException fault)
Called before attempting to handle a previous CircuitAbortException with a specific fault-handling
MessageProcessor.
|
void |
preFilterInvocation(Circuit c,
MessageProcessor mp,
Message m,
MessageProcessor caller,
java.lang.Object context)
This method is called immediately before a Filter's MessageProcessor is invoked.
|
static void |
tracePath(CircuitCallRecord cip,
int level) |
abortedCircuitInvocation, onMessageCompletion
public void dispose()
public CircuitTracker getCircuitTracker(Message m)
public void preCircuitInvocation(Circuit c, Message m, java.lang.Object context)
MessageListener
preCircuitInvocation
in interface MessageListener
preCircuitInvocation
in class MessageListenerAdapter
c
- The Circuit
about to be called.m
- The Message
.context
- The context in which this circuit was called. In the case of the circuit being run via a reference
from a filter, it may be null, an ESPK, or a String property which resolves to this circuit. In the case of the
circuit being run from the Transport module, it will be that module itself (as per the 'source' parameter in
Message.addCreationListener(com.vordel.circuit.MessageCreationListener)
), or null if no source was specified to the creation callback.public void postCircuitInvocation(Circuit c, Message m, boolean result, java.lang.Object context)
MessageListener
postCircuitInvocation
in interface MessageListener
postCircuitInvocation
in class MessageListenerAdapter
c
- The Circuit
.m
- The Message
.result
- The status which the Circuit returned - True if the Circuit passed, False if it failed. If it
aborted, the MessageListener.abortedCircuitInvocation(com.vordel.circuit.Circuit, com.vordel.circuit.Message, com.vordel.circuit.CircuitAbortException)
method is called instead.public void preFilterInvocation(Circuit c, MessageProcessor mp, Message m, MessageProcessor caller, java.lang.Object context)
MessageListener
preFilterInvocation
in interface MessageListener
preFilterInvocation
in class MessageListenerAdapter
c
- The Circuit
context in which this processor was called.mp
- The MessageProcessor
about to be invoked.m
- The Message
before the processor works on it.caller
- The MessageProcessor
which is calling this processor. Usually this is null, as the
Circuit is the implicit caller of the processor. However, some processors are compound processors, i.e.
they are themselves made up of other processors. In these cases, it's the caller processor which invokes the 'mp'
in the context of the caller's Circuit. When this happens, the 'caller' parameter will be non-null.public void postFilterInvocation(Circuit c, MessageProcessor mp, Message m, int resultType, MessageProcessor caller, java.lang.Object context)
MessageListener
postFilterInvocation
in interface MessageListener
postFilterInvocation
in class MessageListenerAdapter
c
- The Circuit
context in which this processor was called.mp
- The MessageProcessor
which was invoked.m
- The Message
as populated after invocation.resultType
- one of
FilterInvocation.RESULT_SUCCESS
FilterInvocation.RESULT_FAILURE
FilterInvocation.RESULT_EXCEPTION
caller
- The MessageProcessor
which called this processor. Usually this is null. See
MessageListener.preFilterInvocation(com.vordel.circuit.Circuit, com.vordel.circuit.MessageProcessor, com.vordel.circuit.Message, com.vordel.circuit.MessageProcessor, java.lang.Object)
.public void preCircuitProcessing(Circuit c, Message m, java.lang.Object context)
MessageListener
preCircuitProcessing
in interface MessageListener
preCircuitProcessing
in class MessageListenerAdapter
c
- The Circuit
which is about to be invoked.m
- The Message
.context
- The Message
originator, or null.public void postCircuitProcessing(Message message, int result)
MessageListener
postCircuitProcessing
in interface MessageListener
postCircuitProcessing
in class MessageListenerAdapter
message
- The Message
.result
- The result of Circuit processing. One of:
ResponseStatusRecord.STATUS_ERROR
ResponseStatusRecord.STATUS_PASS
ResponseStatusRecord.STATUS_FAIL
public void preFaultHandlerInvocation(Circuit c, MessageProcessor faultHandler, Message m, CircuitAbortException fault)
MessageListener
preFaultHandlerInvocation
in interface MessageListener
preFaultHandlerInvocation
in class MessageListenerAdapter
c
- The Circuit
in whose context the faultHander will execute.faultHandler
- The fault handler MessageProcessor
we're about to invoke.m
- The Message
.fault
- The CircuitAbortException
which brought us here.public static void tracePath(CircuitCallRecord cip, int level)
public void messageCreated(Message m, java.lang.Object source)
MessageCreationListener
messageCreated
in interface MessageCreationListener
m
- The newly created Message
.source
- The originator of the message. Usually a transport module, it may be null.
This documentation and all its contents and graphics, copyright © 1999 - 2011 Vordel