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.
virtual void	checkFields (const FIXMessage &fixMessage) const =0
	Checks that the message contains valid values of fields.
virtual FIXMessage *	clone (const FIXMessage &fixMessage) const =0
	Duplicates the given message.
virtual FIXMessage *	createReject (const FIXMessage &fixMessage, bool appReject=true) const =0
	Creates corresponding reject for the source message.
virtual OptionState	optionState (Option option) const =0
	Returns the state of particular option.
virtual FIXMessage *	parse (char const rawMessage, size_t rawMessageSize, SecurityAttributes pSA=NULL, bool verifyBodyLength=false, bool verifyCheckSum=false, FIXVersion preferredVersion=NA) const =0
	Parses the input string and creates corresponding structured message.
virtual FIXMessage *	parse (ProtocolID protocolID, const char rawMessage, size_t rawMessageSize, SecurityAttributes pSA=NULL, bool verifyBodyLength=false, bool verifyCheckSum=false, FIXVersion preferredVersion=NA) const =0
	Parses the input string and creates corresponding structured message.
FIXMessage *	parse (const std::string &rawMessage, SecurityAttributes *pSA=NULL, bool verifyBodyLength=false, bool verifyCheckSum=false, FIXVersion preferredVersion=NA) const
	Parses the input string and creates corresponding structured message.
FIXMessage *	parse (ProtocolID protocolID, const std::string &rawMessage, SecurityAttributes *pSA=NULL, bool verifyBodyLength=false, bool verifyCheckSum=false, FIXVersion preferredVersion=NA) const
	Parses the input string and creates corresponding structured message.
virtual void	switchOption (Option option, OptionState state)=0
	Changes state of particular parsing option.
Static Public Member Functions
static FIXMsgProcessor *	singleton ()
	Returns the instance of the class.
Protected Member Functions
	FIXMsgProcessor ()
	Constructor.
virtual	~FIXMsgProcessor ()
	Destructor.

Detailed Description

Processes raw messages and provides message verification capabilities.

Definition at line 65 of file B2BITS_FIXMsgProcessor.h.

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.

Definition at line 69 of file B2BITS_FIXMsgProcessor.h.

enum Engine::FIXMsgProcessor::OptionState

Option state.

Enumerator:

ON	Turns option on.
OFF	Turns option off.

Definition at line 87 of file B2BITS_FIXMsgProcessor.h.

Constructor & Destructor Documentation

Engine::FIXMsgProcessor::FIXMsgProcessor ( ) [inline, protected]

Constructor.

Definition at line 253 of file B2BITS_FIXMsgProcessor.h.

virtual Engine::FIXMsgProcessor::~FIXMsgProcessor ( ) [protected, virtual]

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 FIXMessage* Engine::FIXMsgProcessor::createReject	(	const FIXMessage &	fixMessage,
		bool	appReject = `true`
	)		const `[pure virtual]`

Creates corresponding reject for the source message.

Parameters:

fixMessage	message to be rejected
appReject	when true application reject will be created, session when false

Returns:: reject FIXMessage

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.

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 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.

Returns:: Instance of FIXMessage class.

Definition at line 209 of file B2BITS_FIXMsgProcessor.h.

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 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.

Returns:: Instance of FIXMessage class.

Definition at line 179 of file B2BITS_FIXMsgProcessor.h.

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

Parses the input 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.

Returns:: Instance of FIXMessage class.

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

Parses the input 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.

Returns:: Instance of FIXMessage class.

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

Returns the instance of the class.

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

Engine::FIXMsgProcessor Class Reference

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation