A MapMessage object is used to send a set of name-value pairs. More...

#include <src/main/cms/MapMessage.h>

Inheritance diagram for cms::MapMessage:

Public Member Functions
virtual	~MapMessage () throw ()
virtual bool	isEmpty () const =0
	Returns true if there are no values stored in the MapMessage body.
virtual std::vector< std::string >	getMapNames () const =0
	Returns an Enumeration of all the names in the MapMessage object.
virtual bool	itemExists (const std::string &name) const =0
	Indicates whether an item exists in this MapMessage object.
virtual bool	getBoolean (const std::string &name) const =0
	Returns the Boolean value of the Specified name.
virtual void	setBoolean (const std::string &name, bool value)=0
	Sets a boolean value with the specified name into the Map.
virtual unsigned char	getByte (const std::string &name) const =0
	Returns the Byte value of the Specified name.
virtual void	setByte (const std::string &name, unsigned char value)=0
	Sets a Byte value with the specified name into the Map.
virtual std::vector< unsigned char >	getBytes (const std::string &name) const =0
	Returns the Bytes value of the Specified name.
virtual void	setBytes (const std::string &name, const std::vector< unsigned char > &value)=0
	Sets a Bytes value with the specified name into the Map.
virtual char	getChar (const std::string &name) const =0
	Returns the Char value of the Specified name.
virtual void	setChar (const std::string &name, char value)=0
	Sets a Char value with the specified name into the Map.
virtual double	getDouble (const std::string &name) const =0
	Returns the Double value of the Specified name.
virtual void	setDouble (const std::string &name, double value)=0
	Sets a Double value with the specified name into the Map.
virtual float	getFloat (const std::string &name) const =0
	Returns the Float value of the Specified name.
virtual void	setFloat (const std::string &name, float value)=0
	Sets a Float value with the specified name into the Map.
virtual int	getInt (const std::string &name) const =0
	Returns the Int value of the Specified name.
virtual void	setInt (const std::string &name, int value)=0
	Sets a Int value with the specified name into the Map.
virtual long long	getLong (const std::string &name) const =0
	Returns the Long value of the Specified name.
virtual void	setLong (const std::string &name, long long value)=0
	Sets a Long value with the specified name into the Map.
virtual short	getShort (const std::string &name) const =0
	Returns the Short value of the Specified name.
virtual void	setShort (const std::string &name, short value)=0
	Sets a Short value with the specified name into the Map.
virtual std::string	getString (const std::string &name) const =0
	Returns the String value of the Specified name.
virtual void	setString (const std::string &name, const std::string &value)=0
	Sets a String value with the specified name into the Map.

Detailed Description

A MapMessage object is used to send a set of name-value pairs.

The names are String objects, and the values are primitive data types in the Java programming language. The names must have a value that is not null, and not an empty string. The entries can be accessed sequentially or randomly by name. The order of the entries is undefined. MapMessage inherits from the Message interface and adds a message body that contains a Map.

When a client receives a MapMessage, it is in read-only mode. If a client attempts to write to the message at this point, a MessageNotWriteableException is thrown. To place the MapMessage back into a state where it can be read from and written to, call the clearBody method.

MapMessage objects support the following conversion table. The marked cases must be supported. The unmarked cases must throw a CMSException. The String-to-primitive conversions may throw a MessageFormatException if the primitive's valueOf() method does not accept it as a valid String representation of the primitive.

A value written as the row type can be read as the column type.

  |        | boolean byte short char int long float double String byte[]
  |----------------------------------------------------------------------
  |boolean |    X                                            X
  |byte    |          X     X         X   X                  X
  |short   |                X         X   X                  X
  |char    |                     X                           X
  |int     |                          X   X                  X
  |long    |                              X                  X
  |float   |                                    X     X      X
  |double  |                                          X      X
  |String  |    X     X     X         X   X     X     X      X
  |byte[]  |                                                        X
  |----------------------------------------------------------------------

Since:: 1.0

Constructor & Destructor Documentation

virtual cms::MapMessage::~MapMessage ( ) throw () [virtual]

Member Function Documentation

virtual bool cms::MapMessage::getBoolean ( const std::string & name ) const [pure virtual]

Returns the Boolean value of the Specified name.

Parameters:

name	Name of the value to fetch from the map

Exceptions:

CMSException	- if the operation fails due to an internal error.
MessageFormatException	- if this type conversion is invalid.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual unsigned char cms::MapMessage::getByte ( const std::string & name ) const [pure virtual]

Returns the Byte value of the Specified name.

Parameters:

name	Name of the value to fetch from the map

Exceptions:

CMSException	- if the operation fails due to an internal error.
MessageFormatException	- if this type conversion is invalid.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual std::vector<unsigned char> cms::MapMessage::getBytes ( const std::string & name ) const [pure virtual]

Returns the Bytes value of the Specified name.

Parameters:

name	Name of the value to fetch from the map

Exceptions:

CMSException	- if the operation fails due to an internal error.
MessageFormatException	- if this type conversion is invalid.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual char cms::MapMessage::getChar ( const std::string & name ) const [pure virtual]

Returns the Char value of the Specified name.

Parameters:

name	name of the value to fetch from the map

Exceptions:

CMSException	- if the operation fails due to an internal error.
MessageFormatException	- if this type conversion is invalid.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual double cms::MapMessage::getDouble ( const std::string & name ) const [pure virtual]

Returns the Double value of the Specified name.

Parameters:

name	Name of the value to fetch from the map

Exceptions:

CMSException	- if the operation fails due to an internal error.
MessageFormatException	- if this type conversion is invalid.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual float cms::MapMessage::getFloat ( const std::string & name ) const [pure virtual]

Returns the Float value of the Specified name.

Parameters:

name	Name of the value to fetch from the map

Exceptions:

CMSException	- if the operation fails due to an internal error.
MessageFormatException	- if this type conversion is invalid.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual int cms::MapMessage::getInt ( const std::string & name ) const [pure virtual]

Returns the Int value of the Specified name.

Parameters:

name	Name of the value to fetch from the map

Exceptions:

CMSException	- if the operation fails due to an internal error.
MessageFormatException	- if this type conversion is invalid.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual long long cms::MapMessage::getLong ( const std::string & name ) const [pure virtual]

Returns the Long value of the Specified name.

Parameters:

name	Name of the value to fetch from the map

Exceptions:

CMSException	- if the operation fails due to an internal error.
MessageFormatException	- if this type conversion is invalid.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual std::vector< std::string > cms::MapMessage::getMapNames ( ) const [pure virtual]

Returns an Enumeration of all the names in the MapMessage object.

Returns:: STL Vector of String values, each of which is the name of an item in the MapMessage

Exceptions:

CMSException - if the operation fails due to an internal error.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual short cms::MapMessage::getShort ( const std::string & name ) const [pure virtual]

Returns the Short value of the Specified name.

Parameters:

name	Name of the value to fetch from the map

Exceptions:

CMSException	- if the operation fails due to an internal error.
MessageFormatException	- if this type conversion is invalid.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual std::string cms::MapMessage::getString ( const std::string & name ) const [pure virtual]

Returns the String value of the Specified name.

Parameters:

name	Name of the value to fetch from the map

Exceptions:

CMSException	- if the operation fails due to an internal error.
MessageFormatException	- if this type conversion is invalid.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual bool cms::MapMessage::isEmpty ( ) const [pure virtual]

Returns true if there are no values stored in the MapMessage body.

Returns:: true if the body of the MapMessage contains no elements.

Exceptions:

CMSException if the operation fails due to an internal error.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual bool cms::MapMessage::itemExists ( const std::string & name ) const [pure virtual]

Indicates whether an item exists in this MapMessage object.

Parameters:

name	String name of the Object in question

Returns:: boolean value indicating if the name is in the map

Exceptions:

CMSException - if the operation fails due to an internal error.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual void cms::MapMessage::setBoolean	(	const std::string &	name,
		bool	value
	)		`[pure virtual]`

Sets a boolean value with the specified name into the Map.

Parameters:

name	the name of the boolean
value	the boolean value to set in the Map

Exceptions:

CMSException	- if the operation fails due to an internal error.
MessageNotWritableException	- if the Message is in Read-only Mode.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual void cms::MapMessage::setByte	(	const std::string &	name,
		unsigned char	value
	)		`[pure virtual]`

Sets a Byte value with the specified name into the Map.

Parameters:

name	the name of the Byte
value	the Byte value to set in the Map

Exceptions:

CMSException	- if the operation fails due to an internal error.
MessageNotWriteableException	- if the Message is in Read-only Mode.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual void cms::MapMessage::setBytes	(	const std::string &	name,
		const std::vector< unsigned char > &	value
	)		`[pure virtual]`

Sets a Bytes value with the specified name into the Map.

Parameters:

name	The name of the Bytes
value	The Bytes value to set in the Map

Exceptions:

CMSException	- if the operation fails due to an internal error.
MessageNotWriteableException	- if the Message is in Read-only Mode.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual void cms::MapMessage::setChar	(	const std::string &	name,
		char	value
	)		`[pure virtual]`

Sets a Char value with the specified name into the Map.

Parameters:

name	the name of the Char
value	the Char value to set in the Map

Exceptions:

CMSException	- if the operation fails due to an internal error.
MessageNotWriteableException	- if the Message is in Read-only Mode.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual void cms::MapMessage::setDouble	(	const std::string &	name,
		double	value
	)		`[pure virtual]`

Sets a Double value with the specified name into the Map.

Parameters:

name	The name of the Double
value	The Double value to set in the Map

Exceptions:

CMSException	- if the operation fails due to an internal error.
MessageNotWriteableException	- if the Message is in Read-only Mode.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual void cms::MapMessage::setFloat	(	const std::string &	name,
		float	value
	)		`[pure virtual]`

Sets a Float value with the specified name into the Map.

Parameters:

name	The name of the Float
value	The Float value to set in the Map

Exceptions:

CMSException	- if the operation fails due to an internal error.
MessageNotWriteableException	- if the Message is in Read-only Mode.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual void cms::MapMessage::setInt	(	const std::string &	name,
		int	value
	)		`[pure virtual]`

Sets a Int value with the specified name into the Map.

Parameters:

name	The name of the Int
value	The Int value to set in the Map

Exceptions:

CMSException	- if the operation fails due to an internal error.
MessageNotWriteableException	- if the Message is in Read-only Mode.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual void cms::MapMessage::setLong	(	const std::string &	name,
		long long	value
	)		`[pure virtual]`

Sets a Long value with the specified name into the Map.

Parameters:

name	The name of the Long
value	The Long value to set in the Map

Exceptions:

CMSException	- if the operation fails due to an internal error.
MessageNotWriteableException	- if the Message is in Read-only Mode.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual void cms::MapMessage::setShort	(	const std::string &	name,
		short	value
	)		`[pure virtual]`

Sets a Short value with the specified name into the Map.

Parameters:

name	The name of the Short
value	The Short value to set in the Map

Exceptions:

CMSException	- if the operation fails due to an internal error.
MessageNotWriteableException	- if the Message is in Read-only Mode.

Implemented in activemq::commands::ActiveMQMapMessage.

virtual void cms::MapMessage::setString	(	const std::string &	name,
		const std::string &	value
	)		`[pure virtual]`

Sets a String value with the specified name into the Map.

Parameters:

name	The name of the String
value	The String value to set in the Map

Exceptions:

CMSException	- if the operation fails due to an internal error.
MessageNotWriteableException	- if the Message is in Read-only Mode.

Implemented in activemq::commands::ActiveMQMapMessage.

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

src/main/cms/MapMessage.h

cms::MapMessage Class Reference

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation