|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--com.ibm.jms.JMSMessage | +--com.ibm.jms.JMSMapMessage
JMSMapMessage is used to send a set of name/type/value triplets. The entries can be accessed sequentially or randomly by name. The order of the entries is undefined. It adds a map message body.
The primitive types can be read or written explicitly using
methods for each type. They can also be read or written
generically as objects. For example, the call
MapMessage.setInt("foo", 6)
is equivalent to
MapMessage.setObject("foo", new Integer(6)). Both forms are
provided because the explicit form is convenient for static
programming and the object form is needed when types are not
known at compile time.
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. If clearBody() is called the message can then be both read from and written to.
Map messages support the following conversion table. The marked cases are supported and the unmarked cases throw a JMSException. The String to primitive conversions might throw a runtime exception 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 X byte[] X --------------------------------------------------------------------------
Field Summary |
Fields inherited from interface javax.jms.Message |
DEFAULT_DELIVERY_MODE, DEFAULT_PRIORITY, DEFAULT_TIME_TO_LIVE |
Method Summary | |
void |
clearBody()
Clears the message body. |
boolean |
getBoolean(java.lang.String name)
Gets the boolean value of the named key. |
byte |
getByte(java.lang.String name)
Gets the byte value of the named key. |
byte[] |
getBytes(java.lang.String name)
Gets the byte array value of the named key. |
char |
getChar(java.lang.String name)
Gets the Unicode char value of the named key. |
double |
getDouble(java.lang.String name)
Gets the double value of the named key. |
float |
getFloat(java.lang.String name)
Gets the float value of the named key. |
int |
getInt(java.lang.String name)
Gets the integer value of the named key. |
long |
getLong(java.lang.String name)
Gets the long value of the named key. |
java.util.Enumeration |
getMapNames()
Gets an Enumeration of all the MapMessage's names. |
java.lang.Object |
getObject(java.lang.String name)
Gets the Java object with the given name. |
short |
getShort(java.lang.String name)
Gets the short value of the named key. |
java.lang.String |
getString(java.lang.String name)
Gets the String value of the named key. |
boolean |
itemExists(java.lang.String name)
Checks whether an item exists in this MapMessage. |
void |
setBoolean(java.lang.String name,
boolean value)
Sets a boolean value with the given name in the map. |
void |
setByte(java.lang.String name,
byte value)
Sets a byte value with the given name in the map. |
void |
setBytes(java.lang.String name,
byte[] value)
Sets a byte array with the given name in the map. |
void |
setBytes(java.lang.String name,
byte[] value,
int offset,
int length)
Sets a portion of a byte array in the map with the given name. |
void |
setChar(java.lang.String name,
char value)
Sets a Unicode character with the given name in the map. |
void |
setDouble(java.lang.String name,
double value)
Sets a double value with the given name in the map. |
void |
setFloat(java.lang.String name,
float value)
Sets a floating point value with the given name in the map. |
void |
setInt(java.lang.String name,
int value)
Sets an integer value with the given name in the map. |
void |
setLong(java.lang.String name,
long value)
Sets a long value with the given name in the map. |
void |
setObject(java.lang.String name,
java.lang.Object value)
Sets a Java object with the given name in the map. |
void |
setShort(java.lang.String name,
short value)
Sets a short value with the given name in the map. |
void |
setString(java.lang.String name,
java.lang.String value)
Sets a String value with the given name in the map. |
java.lang.String |
toString()
Creates a String which contains a formatted version of the Message. |
Methods inherited from class java.lang.Object |
equals, getClass, hashCode, 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 |
Method Detail |
public void clearBody() throws javax.jms.JMSException
clearBody
in interface javax.jms.Message
clearBody
in class JMSMessage
javax.jms.JMSException
- if there is an internal JMS error.public boolean getBoolean(java.lang.String name) throws javax.jms.JMSException
getBoolean
in interface javax.jms.MapMessage
name
- the name of the key
javax.jms.JMSException
- if JMS fails to read the message due to an internal error.
javax.jms.MessageFormatException
- if this type conversion is not valid.public byte getByte(java.lang.String name) throws javax.jms.JMSException
getByte
in interface javax.jms.MapMessage
name
- the name of the key
javax.jms.JMSException
- if JMS fails to read the message due to an internal error.
javax.jms.MessageFormatException
- if this type conversion is not valid.public byte[] getBytes(java.lang.String name) throws javax.jms.JMSException
getBytes
in interface javax.jms.MapMessage
name
- the name of the key
javax.jms.JMSException
- if JMS fails to read the message due to an internal error.
javax.jms.MessageFormatException
- if this type conversion is not valid.public char getChar(java.lang.String name) throws javax.jms.JMSException
getChar
in interface javax.jms.MapMessage
name
- the name of the boolean key
javax.jms.JMSException
- if JMS fails to read the message due to an internal error.
javax.jms.MessageFormatException
- if this type conversion is not valid.public double getDouble(java.lang.String name) throws javax.jms.JMSException
getDouble
in interface javax.jms.MapMessage
name
- the name of the key
javax.jms.JMSException
- if JMS fails to read the message due to an internal error.
javax.jms.MessageFormatException
- if this type conversion is not valid.public float getFloat(java.lang.String name) throws javax.jms.JMSException
getFloat
in interface javax.jms.MapMessage
name
- the name of the key
javax.jms.JMSException
- if JMS fails to read the message due to an internal error.
javax.jms.MessageFormatException
- if this type conversion is not valid.public int getInt(java.lang.String name) throws javax.jms.JMSException
getInt
in interface javax.jms.MapMessage
name
- the name of the key
javax.jms.JMSException
- if JMS fails to read the message due to an internal error.
javax.jms.MessageFormatException
- if this type conversion is not valid.public long getLong(java.lang.String name) throws javax.jms.JMSException
getLong
in interface javax.jms.MapMessage
name
- the name of the key
javax.jms.JMSException
- if JMS fails to read the message due to an internal error.
javax.jms.MessageFormatException
- if this type conversion is not valid.public java.util.Enumeration getMapNames() throws javax.jms.JMSException
getMapNames
in interface javax.jms.MapMessage
javax.jms.JMSException
- if JMS fails to read message due to an internal error.public java.lang.Object getObject(java.lang.String name) throws javax.jms.JMSException
This method can be used to return, as a class instance, an object that had been stored in the Map with the equivalent setObject() method call, or its equivalent primitive setter method.
getObject
in interface javax.jms.MapMessage
name
- the name of the Java object
javax.jms.JMSException
- if JMS fails to read message due to an internal error.public short getShort(java.lang.String name) throws javax.jms.JMSException
getShort
in interface javax.jms.MapMessage
name
- the name of the key
javax.jms.JMSException
- if JMS fails to read the message due to an internal error.
javax.jms.MessageFormatException
- if this type conversion is not valid.public java.lang.String getString(java.lang.String name) throws javax.jms.JMSException
getString
in interface javax.jms.MapMessage
name
- the name of the key
javax.jms.JMSException
- if JMS fails to read the message due to an internal error.
javax.jms.MessageFormatException
- if this type conversion is not valid.public boolean itemExists(java.lang.String name) throws javax.jms.JMSException
itemExists
in interface javax.jms.MapMessage
name
- the name of the item to test
javax.jms.JMSException
- if a JMS error occurs.public void setBoolean(java.lang.String name, boolean value) throws javax.jms.JMSException
setBoolean
in interface javax.jms.MapMessage
name
- the name of the booleanvalue
- the boolean value to set in the map.
javax.jms.JMSException
- if JMS fails to write the message due to an internal error.
javax.jms.MessageNotWriteableException
- if the message in read-only mode.public void setByte(java.lang.String name, byte value) throws javax.jms.JMSException
setByte
in interface javax.jms.MapMessage
name
- the name of the bytevalue
- the byte value to set in the map.
javax.jms.JMSException
- if JMS fails to write the message due to an internal error.
javax.jms.MessageNotWriteableException
- if the message in read-only mode.public void setBytes(java.lang.String name, byte[] value) throws javax.jms.JMSException
setBytes
in interface javax.jms.MapMessage
name
- the name of the arrayvalue
- the byte array to set in the map.
javax.jms.JMSException
- if JMS fails to write the message due to an internal error.
javax.jms.MessageNotWriteableException
- if the message in read-only mode.public void setBytes(java.lang.String name, byte[] value, int offset, int length) throws javax.jms.JMSException
setBytes
in interface javax.jms.MapMessage
name
- the name of the byte arrayvalue
- the byte array to set in the Map.offset
- the initial offset within the byte array.length
- the number of bytes to use.
javax.jms.JMSException
- if JMS fails to write the message due to an internal error.
javax.jms.MessageNotWriteableException
- if the message in read-only mode.public void setChar(java.lang.String name, char value) throws javax.jms.JMSException
setChar
in interface javax.jms.MapMessage
name
- the name of the charactervalue
- the value to set in the Map.
javax.jms.JMSException
- if JMS fails to write the message due to an internal error.
javax.jms.MessageNotWriteableException
- if the message in read-only mode.public void setDouble(java.lang.String name, double value) throws javax.jms.JMSException
setDouble
in interface javax.jms.MapMessage
name
- the name of the doublevalue
- the value to set in the Map.
javax.jms.JMSException
- if JMS fails to write the message due to an internal error.
javax.jms.MessageNotWriteableException
- if the message is in read-only mode.public void setFloat(java.lang.String name, float value) throws javax.jms.JMSException
setFloat
in interface javax.jms.MapMessage
name
- the name of the floatvalue
- the value to set in the map.
javax.jms.JMSException
- if JMS fails to write the message due to an internal error.
javax.jms.MessageNotWriteableException
- if the message in read-only mode.public void setInt(java.lang.String name, int value) throws javax.jms.JMSException
setInt
in interface javax.jms.MapMessage
name
- the name of the integervalue
- the value to set in the Map.
javax.jms.JMSException
- if JMS fails to write the message due to
an internal error.
javax.jms.MessageNotWriteableException
- if the message in read-only mode.public void setLong(java.lang.String name, long value) throws javax.jms.JMSException
setLong
in interface javax.jms.MapMessage
name
- the name of the longvalue
- the value to set in the Map.
javax.jms.JMSException
- if JMS fails to write the message due to an internal error.
javax.jms.MessageNotWriteableException
- if the message in read-only mode.public void setObject(java.lang.String name, java.lang.Object value) throws javax.jms.JMSException
This method only works for the 'objectified' primitive object types (Integer, Double, Long ...), String, and byte arrays.
setObject
in interface javax.jms.MapMessage
name
- the name of the objectvalue
- the value to set in the Map.
javax.jms.JMSException
- if JMS fails to write the message due to an internal error.
javax.jms.MessageNotWriteableException
- if the message in read-only mode.public void setShort(java.lang.String name, short value) throws javax.jms.JMSException
setShort
in interface javax.jms.MapMessage
name
- the name of the shortvalue
- the short value to set in the map.
javax.jms.JMSException
- if JMS fails to write the message due to an internal error.
javax.jms.MessageNotWriteableException
- if the message in read-only mode.public void setString(java.lang.String name, java.lang.String value) throws javax.jms.JMSException
setString
in interface javax.jms.MapMessage
name
- the name of the Stringvalue
- the String value to set in the Map.
javax.jms.JMSException
- if JMS fails to write the message due to an internal error.
javax.jms.MessageNotWriteableException
- if the message in read-only mode.public java.lang.String toString()
toString
in class JMSMessage
|
(c) Copyright IBM Corp. 2005. All Rights Reserved. | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |