Provides handlers for the message flow of the FIX engine.

Namespace:  Teraspaces.QWFIX
Assembly:  Teraspaces.QWFIX.Core (in Teraspaces.QWFIX.Core.dll) Version: 2.5.0.0

Syntax

            
 C#  Visual Basic  Visual C++  J# 
public interface IFIXEngineMessageHandler
Public Interface IFIXEngineMessageHandler
public interface class IFIXEngineMessageHandler
public interface IFIXEngineMessageHandler

Members

      
 All Members  Methods  
 Public

 Protected
 Instance

 Static 
 Declared

 Inherited
 XNA Framework Only 

 .NET Compact Framework Only 

 MemberDescription
OnMessageReceived(FIXMessage, FIXEngineMessageHandlerStatus)
Called when a new message is received.
OnMessageSent(FIXMessage, FIXEngineMessageHandlerStatus)
Called when a message is sent.

Remarks

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

Note:
OnMessageSent(FIXMessage, FIXEngineMessageHandlerStatus) 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.
Note:
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.
Note:
During FIX recovery process, the EngineRole 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.SessionPersistence.Session.Engine.EngineRole".

See Also