Interface definition for message handlers. The interface defines the callback function that should execute when a message is received. More...

#include <message_handler.h>

Inheritance diagram for industrial::message_handler::MessageHandler:

[legend]

List of all members.

Public Member Functions
bool	callback (industrial::simple_message::SimpleMessage &in)
	Callback function that should be executed when a message arrives DO NOT OVERRIDE THIS FUNCTION. It performs message validation before the internal callback (which should be overridden) is called. If one is required the callback sends a message reply.
int	getMsgType ()
	Gets message type that callback expects.
	MessageHandler ()
	Constructor.
	~MessageHandler ()
	Destructor.
Protected Member Functions
industrial::smpl_msg_connection::SmplMsgConnection *	getConnection ()
	Gets connectoin for message replies.
bool	init (int msg_type, industrial::smpl_msg_connection::SmplMsgConnection *connection)
	Class initializer.
Private Member Functions
virtual bool	internalCB (industrial::simple_message::SimpleMessage &in)=0
	Virtual callback function.
void	setConnection (industrial::smpl_msg_connection::SmplMsgConnection *connection)
	Sets connection for message replies.
void	setMsgType (int msg_type)
	Sets message type that callback expects.
bool	validateMsg (industrial::simple_message::SimpleMessage &in)
	Validates incoming message for processing by internal callback.
Private Attributes
industrial::smpl_msg_connection::SmplMsgConnection *	connection_
	Reference to reply connection (called if incoming message requires a reply)
int	msg_type_
	Message type expected by callback.

Detailed Description

Interface definition for message handlers. The interface defines the callback function that should execute when a message is received.

Defines the interface used for function callbacks when a message is received. When used in conjunction with a message_manager (link) generic message handling can be achieved.

THIS CLASS IS NOT THREAD-SAFE

Definition at line 61 of file message_handler.h.

Constructor & Destructor Documentation

industrial::message_handler::MessageHandler::MessageHandler ( void )

Constructor.

Definition at line 47 of file message_handler.cpp.

industrial::message_handler::MessageHandler::~MessageHandler ( void )

Destructor.

Definition at line 54 of file message_handler.cpp.

Member Function Documentation

bool industrial::message_handler::MessageHandler::callback ( industrial::simple_message::SimpleMessage & in )

Callback function that should be executed when a message arrives DO NOT OVERRIDE THIS FUNCTION. It performs message validation before the internal callback (which should be overridden) is called. If one is required the callback sends a message reply.

Parameters:

in	incoming message

Returns:: true on success, false otherwise

Definition at line 88 of file message_handler.cpp.

industrial::smpl_msg_connection::SmplMsgConnection* industrial::message_handler::MessageHandler::getConnection ( ) [inline, protected]

Gets connectoin for message replies.

Returns:: connection reference

Definition at line 105 of file message_handler.h.

int industrial::message_handler::MessageHandler::getMsgType ( ) [inline]

Gets message type that callback expects.

Returns:: message type

Definition at line 93 of file message_handler.h.

bool industrial::message_handler::MessageHandler::init	(	int	msg_type,
		industrial::smpl_msg_connection::SmplMsgConnection *	connection
	)		`[protected]`

Class initializer.

Parameters:

msg_type	type of message expected
connection	simple message connection that will be used to send replies.

Returns:: true on success, false otherwise (an invalid message type)

Reimplemented in industrial::ping_handler::PingHandler.

Definition at line 59 of file message_handler.cpp.

virtual bool industrial::message_handler::MessageHandler::internalCB ( industrial::simple_message::SimpleMessage & in ) [private, pure virtual]

Virtual callback function.

Parameters:

in	incoming message

Returns:: true on success, false otherwise

Implemented in industrial::ping_handler::PingHandler.

void industrial::message_handler::MessageHandler::setConnection ( industrial::smpl_msg_connection::SmplMsgConnection * connection ) [inline, private]

Sets connection for message replies.

Parameters:

connection connection reference

Definition at line 156 of file message_handler.h.

void industrial::message_handler::MessageHandler::setMsgType ( int msg_type ) [inline, private]

Sets message type that callback expects.

Parameters:

msg_type message type

Definition at line 167 of file message_handler.h.

bool industrial::message_handler::MessageHandler::validateMsg ( industrial::simple_message::SimpleMessage & in ) [private]

Validates incoming message for processing by internal callback.

Parameters:

in	incoming message

Returns:: true on if valid, false otherwise

Definition at line 106 of file message_handler.cpp.

Member Data Documentation

industrial::smpl_msg_connection::SmplMsgConnection* industrial::message_handler::MessageHandler::connection_ [private]

Reference to reply connection (called if incoming message requires a reply)

Definition at line 126 of file message_handler.h.

int industrial::message_handler::MessageHandler::msg_type_ [private]

Message type expected by callback.

Definition at line 131 of file message_handler.h.

The documentation for this class was generated from the following files:

Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation