com.teraspaces.qwfix
Interface FIXEngineMessageHandler

public interface FIXEngineMessageHandler

The Interface FIXEngineMessageHandler provides handlers for the message flow of the FIX engine.

The FIX engine is following a proactor model. Application should register an implementation of FIXEngineMessageHandler for each FIX session. Whenever a new message is received by a session, the onMessageReceived method of the handler registered on that session will be called.

Method onMessageSent will not be called during normal operation (status = NORMAL), because the application is already aware of the message it is sending anyway. It will only be called during hot standby backup, or recovery, or remote cache process.

Messages may be rejected before it reaches the handler. In that case, the application will have no chance to "see" the message anyway. This is a behavior by design.

During FIX recovery process, the FIXEngineRole may need to be examined in the handler as well, in order to distinguish among "primary recovery", "hot standby recovery" or "remote sync recovery". It's the application's responsibility to examine it and take appropriate action. The EngineRole can be retrieved by calling "message.getSessionPersistence().getSession().getEngine().getEngineRole()".

See Also:

FIXEngineRole, FIXEngineMessageHandlerStatus

Method Summary

void	onMessageReceived(FIXMessage message, FIXEngineMessageHandlerStatus status) Called when a new message is received.
void	onMessageSent(FIXMessage message, FIXEngineMessageHandlerStatus status) Called when a message is sent.

Method Detail

onMessageSent

void onMessageSent(FIXMessage message,
                   FIXEngineMessageHandlerStatus status)

Called when a message is sent. Note: This method will not be called during normal operations. It will only be called during recovery or backup operations.

Parameters:

message - The FIX message

status - The handler status

onMessageReceived

void onMessageReceived(FIXMessage message,
                       FIXEngineMessageHandlerStatus status)

Called when a new message is received.

Parameters:

message - The FIX message

status - The handler status