com.j_spaces.jms

Class GSMapMessageImpl

java.lang.Object

com.j_spaces.core.client.MetaDataEntry

com.j_spaces.jms.GSMessageImpl

com.j_spaces.jms.GSMapMessageImpl

All Implemented Interfaces:

IReplicatable, Externalizable, Serializable, javax.jms.MapMessage, javax.jms.Message, Entry

public class GSMapMessageImpl
extends GSMessageImpl
implements javax.jms.MapMessage

A MapMassage implementation for the GigaSpaces JMS API wrapping.

Version:

4.0 Copyright: Copyright (c) 2004 Company: GigaSpaces Technologies,Ltd.

Author:

Gershon Diner

See Also:

Serialized Form

Field Summary

Fields inherited from class com.j_spaces.jms.GSMessageImpl

Body, BODY_STR_NAME, BYTES, DestinationName, indexedFields, JMS_CORRELATION_ID, JMS_DELIVERY_MODE, JMS_DESTINATION, JMS_EXPIRATION, JMS_GSCONNECTION_KEY_NAME, JMS_GSCONVERTER, JMS_GSPRODUCER_KEY_PROP_NAME, JMS_GSTTL_KEY_PROP_NAME, JMS_MESSAGE_ID, JMS_PRIORITY, JMS_REDELIVERED, JMS_REPLY_TO, JMS_TIMESTAMP, JMS_TYPE, JMSCorrelationID, JMSDeliveryMode, JMSDestination, JMSExpiration, JMSMessageID, JMSPriority, JMSRedelivered, JMSReplyTo, JMSTimestamp, JMSType, JMSX_GROUPID, JMSX_GROUPSEQ, JMSX_USERID, MAP, OBJECT, Properties, PROPERTIES_STR_NAME, session, SIMPLE, STREAM, TEXT

Fields inherited from interface javax.jms.Message

DEFAULT_DELIVERY_MODE, DEFAULT_PRIORITY, DEFAULT_TIME_TO_LIVE

Constructor Summary

Constructors

Constructor and Description
GSMapMessageImpl() Instantiates a new MapMessage.
GSMapMessageImpl(GSSessionImpl session) Instantiates a new MapMessage.
GSMapMessageImpl(GSSessionImpl session, HashMap<String,Object> map) Instantiates a new MapMessage.

Method Summary

Modifier and Type	Method and Description
void	clearBody() API method.
protected Object	cloneBody() Returns a clone of the body.
boolean	getBoolean(String name)
byte	getByte(String name)
byte[]	getBytes(String name)
char	getChar(String name)
double	getDouble(String name)
float	getFloat(String name)
int	getInt(String name)
long	getLong(String name)
HashMap<String,Object>	getMap() Returns the object's map.
Enumeration	getMapNames() Return an Enumeration of all the Map message's names.
Object	getObject(String name) Return the Java object value with the given name
short	getShort(String name)
String	getString(String name)
boolean	itemExists(String name) Check if an item exists in this MapMessage
void	setBoolean(String name, boolean value) Set a boolean value with the given name, into the Map
void	setByte(String name, byte value) Set a byte value with the given name, into the Map
void	setBytes(String name, byte[] value) Set a byte array value with the given name, into the Map
void	setBytes(String name, byte[] value, int offset, int length) Set a portion of the byte array value with the given name, into the Map
void	setChar(String name, char value) Set a Unicode character value with the given name, into the Map
void	setDouble(String name, double value) Set a double value with the given name, into the Map
void	setFloat(String name, float value) Set a float value with the given name, into the Map
void	setInt(String name, int value) Set an integer value with the given name, into the Map
void	setLong(String name, long value) Set a long value with the given name, into the Map
void	setMap(HashMap<String,Object> map) Sets the object's map.
void	setObject(String name, Object value) Set a Java object value with the given name, into the Map
void	setShort(String name, short value) Set a short value with the given name, into the Map
void	setString(String name, String value) Set a String value with the given name, into the Map

Methods inherited from class com.j_spaces.jms.GSMessageImpl

__getSpaceIndexedFields, acknowledge, checkBodyReadOnly, checkBodyWriteOnly, checkPropertiesReadOnly, clearProperties, cloneObject, copyTo, equals, getBooleanProperty, getByteProperty, getDestinationName, getDoubleProperty, getFloatProperty, getIntProperty, getJMSCorrelationID, getJMSCorrelationIDAsBytes, getJMSDeliveryMode, getJMSDestination, getJMSExpiration, getJMSMessageID, getJMSPriority, getJMSRedelivered, getJMSReplyTo, getJMSTimestamp, getJMSType, getLongProperty, getObjectProperty, getPropertyNames, getShortProperty, getStringProperty, hashCode, propertyExists, readExternal, setBooleanProperty, setByteProperty, setDestinationName, setDoubleProperty, setFloatProperty, setIntProperty, setJMSCorrelationID, setJMSCorrelationIDAsBytes, setJMSDeliveryMode, setJMSDestination, setJMSExpiration, setJMSMessageID, setJMSPriority, setJMSRedelivered, setJMSReplyTo, setJMSTimestamp, setJMSType, setLongProperty, setObjectProperty, setProperties, setRoutingIndexes, setShortProperty, setStringProperty, toString, writeExternal

Methods inherited from class com.j_spaces.core.client.MetaDataEntry

__getEntryInfo, __setEntryInfo, _readExternal, _writeExternal, isFifo, isNOWriteLeaseMode, isTransient, makePersistent, makeTransient, setFifo, setNOWriteLeaseMode, setTransient

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface javax.jms.Message

acknowledge, clearProperties, getBooleanProperty, getByteProperty, getDoubleProperty, getFloatProperty, getIntProperty, getJMSCorrelationID, getJMSCorrelationIDAsBytes, getJMSDeliveryMode, getJMSDestination, getJMSExpiration, getJMSMessageID, getJMSPriority, getJMSRedelivered, getJMSReplyTo, getJMSTimestamp, getJMSType, getLongProperty, getObjectProperty, getPropertyNames, getShortProperty, getStringProperty, propertyExists, setBooleanProperty, setByteProperty, setDoubleProperty, setFloatProperty, setIntProperty, setJMSCorrelationID, setJMSCorrelationIDAsBytes, setJMSDeliveryMode, setJMSDestination, setJMSExpiration, setJMSMessageID, setJMSPriority, setJMSRedelivered, setJMSReplyTo, setJMSTimestamp, setJMSType, setLongProperty, setObjectProperty, setShortProperty, setStringProperty

Constructor Detail

GSMapMessageImpl

public GSMapMessageImpl()
                 throws javax.jms.JMSException

Instantiates a new MapMessage.

Throws:

javax.jms.JMSException - if falied to create the message

GSMapMessageImpl

public GSMapMessageImpl(GSSessionImpl session,
                        HashMap<String,Object> map)
                 throws javax.jms.JMSException

Instantiates a new MapMessage. It's important to note that map should contain only values that are valid according to the JMS specification.

Parameters:

session - the session of the message

map - the map content of the message

Throws:

javax.jms.JMSException - if falied to create the message

GSMapMessageImpl

public GSMapMessageImpl(GSSessionImpl session)
                 throws javax.jms.JMSException

Instantiates a new MapMessage. It's important to note that map should contain only values that are valid according to the JMS specification.

Parameters:

session - the session of the message

Throws:

javax.jms.JMSException - if falied to create the message

Method Detail

setMap

public void setMap(HashMap<String,Object> map)

Sets the object's map. It's important to note that map should contain only values that are valid according to the JMS specification.

Parameters:

map - the map

getMap

public HashMap<String,Object> getMap()

Returns the object's map.

Returns:

the object's map

getBoolean

public final boolean getBoolean(String name)
                         throws javax.jms.JMSException,
                                javax.jms.MessageFormatException

Specified by:

getBoolean in interface javax.jms.MapMessage

Throws:

javax.jms.JMSException

javax.jms.MessageFormatException

See Also:

MapMessage.getBoolean(String)

getByte

public final byte getByte(String name)
                   throws javax.jms.JMSException,
                          javax.jms.MessageFormatException

Specified by:

getByte in interface javax.jms.MapMessage

Throws:

javax.jms.JMSException

javax.jms.MessageFormatException

See Also:

MapMessage.getByte(String)

getShort

public final short getShort(String name)
                     throws javax.jms.JMSException,
                            javax.jms.MessageFormatException

Specified by:

getShort in interface javax.jms.MapMessage

Throws:

javax.jms.JMSException

javax.jms.MessageFormatException

See Also:

MapMessage.getShort(String)

getChar

public final char getChar(String name)
                   throws javax.jms.JMSException,
                          javax.jms.MessageFormatException

Specified by:

getChar in interface javax.jms.MapMessage

Throws:

javax.jms.JMSException

javax.jms.MessageFormatException

See Also:

MapMessage.getChar(String)

getInt

public final int getInt(String name)
                 throws javax.jms.JMSException,
                        javax.jms.MessageFormatException

Specified by:

getInt in interface javax.jms.MapMessage

Throws:

javax.jms.JMSException

javax.jms.MessageFormatException

See Also:

MapMessage.getInt(String)

getLong

public final long getLong(String name)
                   throws javax.jms.JMSException,
                          javax.jms.MessageFormatException

Specified by:

getLong in interface javax.jms.MapMessage

Throws:

javax.jms.JMSException

javax.jms.MessageFormatException

See Also:

MapMessage.getLong(String)

getFloat

public final float getFloat(String name)
                     throws javax.jms.JMSException,
                            javax.jms.MessageFormatException

Specified by:

getFloat in interface javax.jms.MapMessage

Throws:

javax.jms.JMSException

javax.jms.MessageFormatException

See Also:

MapMessage.getFloat(String)

getDouble

public final double getDouble(String name)
                       throws javax.jms.JMSException,
                              javax.jms.MessageFormatException

Specified by:

getDouble in interface javax.jms.MapMessage

Throws:

javax.jms.JMSException

javax.jms.MessageFormatException

See Also:

MapMessage.getDouble(String)

getString

public final String getString(String name)
                       throws javax.jms.JMSException,
                              javax.jms.MessageFormatException

Specified by:

getString in interface javax.jms.MapMessage

Throws:

javax.jms.JMSException

javax.jms.MessageFormatException

See Also:

MapMessage.getString(String)

getBytes

public final byte[] getBytes(String name)
                      throws javax.jms.JMSException,
                             javax.jms.MessageFormatException

Specified by:

getBytes in interface javax.jms.MapMessage

Throws:

javax.jms.JMSException

javax.jms.MessageFormatException

See Also:

MapMessage.getBytes(String)

getObject

public final Object getObject(String name)
                       throws javax.jms.JMSException

Return the Java object value with the given name

Note that this method can be used to return in objectified format, an object that had been stored in the Map with the equivalent setObject method call, or it's equivalent primitive set method.

Specified by:

getObject in interface javax.jms.MapMessage

Parameters:

name - the name of the Java object

Returns:

a copy of the Java object value with the given name, in objectified format (e.g. if it set as an int, then an Integer is returned). Note that byte values are returned as byte[], not Byte[]. If there is no item by this name, a null value is returned.

Throws:

javax.jms.JMSException - if JMS fails to read the message due to some internal JMS error

getMapNames

public Enumeration getMapNames()
                        throws javax.jms.JMSException

Return an Enumeration of all the Map message's names.

Specified by:

getMapNames in interface javax.jms.MapMessage

Returns:

an enumeration of all the names in this Map message.

Throws:

javax.jms.JMSException

See Also:

MapMessage.getMapNames()

setBoolean

public final void setBoolean(String name,
                             boolean value)
                      throws javax.jms.JMSException

Set a boolean value with the given name, into the Map

Specified by:

setBoolean in interface javax.jms.MapMessage

Parameters:

name - the name of the boolean

value - the boolean value to set in the Map

Throws:

javax.jms.JMSException - if the message is in read-only mode

setByte

public final void setByte(String name,
                          byte value)
                   throws javax.jms.JMSException

Set a byte value with the given name, into the Map

Specified by:

setByte in interface javax.jms.MapMessage

Parameters:

name - the name of the byte

value - the byte value to set in the Map

Throws:

javax.jms.JMSException - if the message is in read-only mode

setShort

public final void setShort(String name,
                           short value)
                    throws javax.jms.JMSException

Set a short value with the given name, into the Map

Specified by:

setShort in interface javax.jms.MapMessage

Parameters:

name - the name of the short

value - the short value to set in the Map

Throws:

javax.jms.JMSException - if the message is in read-only mode

setChar

public final void setChar(String name,
                          char value)
                   throws javax.jms.JMSException

Set a Unicode character value with the given name, into the Map

Specified by:

setChar in interface javax.jms.MapMessage

Parameters:

name - the name of the Unicode character

value - the Unicode character value to set in the Map

Throws:

javax.jms.JMSException - if the message is in read-only mode

setInt

public final void setInt(String name,
                         int value)
                  throws javax.jms.JMSException

Set an integer value with the given name, into the Map

Specified by:

setInt in interface javax.jms.MapMessage

Parameters:

name - the name of the integer

value - the integer value to set in the Map

Throws:

javax.jms.JMSException - if the message is in read-only mode

setLong

public final void setLong(String name,
                          long value)
                   throws javax.jms.JMSException

Set a long value with the given name, into the Map

Specified by:

setLong in interface javax.jms.MapMessage

Parameters:

name - the name of the long

value - the long value to set in the Map

Throws:

javax.jms.JMSException - if the message is in read-only mode

setFloat

public final void setFloat(String name,
                           float value)
                    throws javax.jms.JMSException

Set a float value with the given name, into the Map

Specified by:

setFloat in interface javax.jms.MapMessage

Parameters:

name - the name of the float

value - the float value to set in the Map

Throws:

javax.jms.JMSException - if the message is in read-only mode

setDouble

public final void setDouble(String name,
                            double value)
                     throws javax.jms.JMSException

Set a double value with the given name, into the Map

Specified by:

setDouble in interface javax.jms.MapMessage

Parameters:

name - the name of the double

value - the double value to set in the Map

Throws:

javax.jms.JMSException - if the message is in read-only mode

setString

public final void setString(String name,
                            String value)
                     throws javax.jms.JMSException

Set a String value with the given name, into the Map

Specified by:

setString in interface javax.jms.MapMessage

Parameters:

name - the name of the String

value - the String value to set in the Map

Throws:

javax.jms.JMSException - if the message is in read-only mode

setBytes

public final void setBytes(String name,
                           byte[] value)
                    throws javax.jms.JMSException

Set a byte array value with the given name, into the Map

Specified by:

setBytes in interface javax.jms.MapMessage

Parameters:

name - the name of the byte array

value - the byte array value to set in the Map. The array is copied so the value for name will not be altered by future modifications.

Throws:

javax.jms.JMSException - if the message is in read-only mode

setBytes

public final void setBytes(String name,
                           byte[] value,
                           int offset,
                           int length)
                    throws javax.jms.JMSException

Set a portion of the byte array value with the given name, into the Map

Specified by:

setBytes in interface javax.jms.MapMessage

Parameters:

name - the name of the byte array

value - the byte array value to set in the Map.

offset - the initial offset within the byte array.

length - the number of bytes to use.

Throws:

javax.jms.JMSException - if the message is in read-only mode

setObject

public final void setObject(String name,
                            Object value)
                     throws javax.jms.JMSException

Set a Java object value with the given name, into the Map

Note that this method only works for the objectified primitive object types (Integer, Double, Long ...), String's and byte arrays.

Specified by:

setObject in interface javax.jms.MapMessage

Parameters:

name - the name of the Java object

value - the Java object value to set in the Map

Throws:

javax.jms.MessageFormatException - if object is invalid

javax.jms.JMSException - if message in read-only mode.

itemExists

public boolean itemExists(String name)
                   throws javax.jms.JMSException

Check if an item exists in this MapMessage

Specified by:

itemExists in interface javax.jms.MapMessage

Parameters:

name - the name of the item to test

Returns:

true if the item exists

Throws:

javax.jms.JMSException

clearBody

public void clearBody()
               throws javax.jms.JMSException

API method.

Specified by:

clearBody in interface javax.jms.Message

Overrides:

clearBody in class GSMessageImpl

Throws:

javax.jms.JMSException - Actually never thrown.

See Also:

Message.clearBody()

cloneBody

protected Object cloneBody()

Returns a clone of the body.

Overrides:

cloneBody in class GSMessageImpl

Returns:

a clone of the body.