Processes raw messages and provides message verification capabilities. More...

#include <B2BITS_FIXMsgProcessor.h>

Public Types
enum	Option { PROHIBIT_TAGS_WITHOUT_VALUE, VERIFY_DATA_TAGS_SEQUENCE, VERIFY_TAGS_VALUES, PROHIBIT_UNKNOWN_TAGS, PROHIBIT_DUPLICATED_TAGS, VERIFY_REPERATING_GROUP_BOUNDS, CHECK_REQUIRED_TAGS, CHECK_REQUIRED_GROUP_FIELDS, ALLOW_ZERO_NUMINGROUP, IGNORE_UNKNOWN_FIELDS }
	List of options available to control message parsing flow. More...

enum	OptionState { ON, OFF }
	Option state. More...

Public Member Functions
virtual void	check (const FIXMessage &fixMessage) const =0
	Checks that the message contains all required and conditionally required fields. More...

virtual void	checkFields (const FIXMessage &fixMessage) const =0
	Checks that the message contains valid values of fields. More...

virtual FIXMessage *	clone (const FIXMessage &fixMessage) const =0
	Duplicates the given message. More...

virtual TagValue *	clone (const TagValue &instance) const =0
	Duplicates the given TagValue instance. More...

virtual Parser::LiteFixMessage *	newLiteMessage () const =0
	Creates a new empty LiteFixMessage instance. More...

virtual OptionState	optionState (Option option) const =0
	Returns the state of particular option. More...

virtual FIXMessage *	parse (char const rawMessage, std::size_t rawMessageSize, SecurityAttributes pSA=NULL, bool verifyBodyLength=false, bool verifyCheckSum=false, FIXVersion preferredVersion=NA) const =0
	Parses the input std::string and creates corresponding structured message. More...

virtual FIXMessage *	parse (ProtocolID protocolID, const char rawMessage, std::size_t rawMessageSize, SecurityAttributes pSA=NULL, bool verifyBodyLength=false, bool verifyCheckSum=false, FIXVersion preferredVersion=NA) const =0
	Parses the input std::string and creates corresponding structured message. More...

FIXMessage *	parse (const std::string &rawMessage, SecurityAttributes *pSA=NULL, bool verifyBodyLength=false, bool verifyCheckSum=false, FIXVersion preferredVersion=NA) const
	Parses the input std::string and creates corresponding structured message. More...

FIXMessage *	parse (ProtocolID protocolID, const std::string &rawMessage, SecurityAttributes *pSA=NULL, bool verifyBodyLength=false, bool verifyCheckSum=false, FIXVersion preferredVersion=NA) const
	Parses the input std::string and creates corresponding structured message. More...

virtual void	switchOption (Option option, OptionState state)=0
	Changes state of particular parsing option. More...

Static Public Member Functions
static FIXMsgProcessor *	singleton ()
	Returns the instance of the class. More...

Protected Member Functions
	FIXMsgProcessor ()
	Constructor. More...

virtual	~FIXMsgProcessor ()
	Destructor. More...

Detailed Description

Processes raw messages and provides message verification capabilities.

Member Enumeration Documentation

enum Engine::FIXMsgProcessor::Option

List of options available to control message parsing flow.

Enumerator
PROHIBIT_TAGS_WITHOUT_VALUE	Message is treated as invalid if tag without value appeared.
VERIFY_DATA_TAGS_SEQUENCE	Controls order and length of raw data fields pair verification.
VERIFY_TAGS_VALUES	Enables/disables the verification of tag values (like date-time).
PROHIBIT_UNKNOWN_TAGS	Controls collecting of unknown tags while message parsing.
PROHIBIT_DUPLICATED_TAGS	Message is treated as invalid if any tag appears more than once.
VERIFY_REPERATING_GROUP_BOUNDS	Message is treated as invalid if the quantity of repeating group entries is less than specified in the leading field. Message with exceeding quantity of repeating group entries is allways treated as invalid.
CHECK_REQUIRED_TAGS	Verifies the presence of required and conditionally required tags of the message.
CHECK_REQUIRED_GROUP_FIELDS	Verifies the presence of required fields in repeating groups .
ALLOW_ZERO_NUMINGROUP	When true, parser will ignore group tags with 0 values. Exception fired otherwise.
IGNORE_UNKNOWN_FIELDS	When true, parser will ignore unknown fields.

enum Engine::FIXMsgProcessor::OptionState

Option state.

Enumerator
ON	Turns option on.
OFF	Turns option off.

Constructor & Destructor Documentation

Engine::FIXMsgProcessor::FIXMsgProcessor ( )

inlineprotected

Constructor.

virtual Engine::FIXMsgProcessor::~FIXMsgProcessor ( )

protectedvirtual

Destructor.

Member Function Documentation

virtual void Engine::FIXMsgProcessor::check ( const FIXMessage & fixMessage ) const

pure virtual

Checks that the message contains all required and conditionally required fields.

Parameters

fixMessage FIXMessage to check.

Exceptions

Utils::Exception if any required and conditionally required field is absent.

virtual void Engine::FIXMsgProcessor::checkFields ( const FIXMessage & fixMessage ) const

pure virtual

Checks that the message contains valid values of fields.

Parameters

fixMessage FIXMessage to check.

Exceptions

Utils::Exception if any field contains invalid value

virtual FIXMessage* Engine::FIXMsgProcessor::clone ( const FIXMessage & fixMessage ) const

pure virtual

Duplicates the given message.

Parameters

fixMessage message to duplicate

Returns: duplicated FIXMessage

virtual TagValue* Engine::FIXMsgProcessor::clone ( const TagValue & instance ) const

pure virtual

Duplicates the given TagValue instance.

Parameters

instance TagValue instance to duplicate

Returns: copy of the passed TagValue instance

virtual Parser::LiteFixMessage* Engine::FIXMsgProcessor::newLiteMessage ( ) const

pure virtual

Creates a new empty LiteFixMessage instance.

See Also: FIXMessage::release()

Returns: pointer to the instance

Referenced by fix_algo::newMessage(), and fix_algo::toLiteMessage().

virtual OptionState Engine::FIXMsgProcessor::optionState ( Option option ) const

pure virtual

Returns the state of particular option.

Parameters

option Option to ckeck

Returns: the state of particular option.

virtual FIXMessage* Engine::FIXMsgProcessor::parse	(	char const *	rawMessage,
		std::size_t	rawMessageSize,
		SecurityAttributes *	pSA = `NULL`,
		bool	verifyBodyLength = `false`,
		bool	verifyCheckSum = `false`,
		FIXVersion	preferredVersion = `NA`
	)		const

pure virtual

Parses the input std::string and creates corresponding structured message.

Parameters

rawMessage	message to parse.
rawMessageSize	Size of the message to parse.
pSA	pointer to SecurityAttributes class to decrypt input message. This parameter may be NULL if input message wasn't encrypted.
verifyBodyLength	if true then conformance of the input message length to the 'BodyLength' field (tag 9) value will be checked.
verifyCheckSum	if true then conformance of the input message checksum to the 'CheckSum' field (tag 10) value will be checked.
preferredVersion	forces to use specified FIX version instead of using 'BeginString' field (tag 8) value.

Warning: the user is responsible for the deletion.

Returns: Instance of FIXMessage class.

virtual FIXMessage* Engine::FIXMsgProcessor::parse	(	ProtocolID	protocolID,
		const char *	rawMessage,
		std::size_t	rawMessageSize,
		SecurityAttributes *	pSA = `NULL`,
		bool	verifyBodyLength = `false`,
		bool	verifyCheckSum = `false`,
		FIXVersion	preferredVersion = `NA`
	)		const

pure virtual

Parses the input std::string and creates corresponding structured message.

Parameters

protocolID	Unique FIX protocol identifier of the passed message.
rawMessage	Message to parse.
rawMessageSize	Message size.
pSA	pointer to SecurityAttributes class to decrypt input message. This parameter may be NULL if input message wasn't encrypted.
verifyBodyLength	if true then conformance of the input message length to the 'BodyLength' field (tag 9) value will be checked.
verifyCheckSum	if true then conformance of the input message checksum to the 'CheckSum' field (tag 10) value will be checked.
preferredVersion	forces to use specified FIX version instead of using 'BeginString' field (tag 8) value.

Warning: the user is responsible for the deletion.

Returns: Instance of FIXMessage class.

FIXMessage* Engine::FIXMsgProcessor::parse	(	const std::string &	rawMessage,
		SecurityAttributes *	pSA = `NULL`,
		bool	verifyBodyLength = `false`,
		bool	verifyCheckSum = `false`,
		FIXVersion	preferredVersion = `NA`
	)		const

inline

Parses the input std::string and creates corresponding structured message.

Parameters

rawMessage	message to parse.
pSA	pointer to SecurityAttributes class to decrypt input message. This parameter may be NULL if input message wasn't encrypted.
verifyBodyLength	if true then conformance of the input message length to the 'BodyLength' field (tag 9) value will be checked.
verifyCheckSum	if true then conformance of the input message checksum to the 'CheckSum' field (tag 10) value will be checked.
preferredVersion	forces to use specified FIX version instead of using 'BeginString' field (tag 8) value.

Warning: the user is responsible for the deletion.

Returns: Instance of FIXMessage class.

FIXMessage* Engine::FIXMsgProcessor::parse	(	ProtocolID	protocolID,
		const std::string &	rawMessage,
		SecurityAttributes *	pSA = `NULL`,
		bool	verifyBodyLength = `false`,
		bool	verifyCheckSum = `false`,
		FIXVersion	preferredVersion = `NA`
	)		const

inline

Parses the input std::string and creates corresponding structured message.

Parameters

protocolID	Unique FIX protocol identifier of the passed message.
rawMessage	message to parse.
pSA	pointer to SecurityAttributes class to decrypt input message. This parameter may be NULL if input message wasn't encrypted.
verifyBodyLength	if true then conformance of the input message length to the 'BodyLength' field (tag 9) value will be checked.
verifyCheckSum	if true then conformance of the input message checksum to the 'CheckSum' field (tag 10) value will be checked.
preferredVersion	forces to use specified FIX version instead of using 'BeginString' field (tag 8) value.

Warning: the user is responsible for the deletion.

Returns: Instance of FIXMessage class.

static FIXMsgProcessor* Engine::FIXMsgProcessor::singleton ( )

static

Returns the instance of the class.

Referenced by fix_algo::newMessage(), and fix_algo::toLiteMessage().

virtual void Engine::FIXMsgProcessor::switchOption	(	Option	option,
		OptionState	state
	)

pure virtual

Changes state of particular parsing option.

Parameters

option	Option to change
state	New state

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation