|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
A MapMessage is used to send a set of name-value pairs where names are
Strings and values are Java primitive types. The entries can be accessed
sequentially or randomly by name. The order of the entries is undefined.
It inherits from Message
and adds a map message body.
The primitive types can be read or written explicitly using methods
for each type. They may also be read or written generically as objects.
For instance, a call to 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 now be both read from and written to.
Map messages support the following conversion table. The marked cases
must be supported. The unmarked cases must throw a JMSException. The
String to primitive conversions may throw a runtime exception if the
primitives 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 |----------------------------------------------------------------------
Attempting to read a null value as a Java primitive type must be treated
as calling the primitive's corresponding valueOf(String)
conversion method with a null value. Since char does not support a
String conversion, attempting to read a null value as a char must
throw NullPointerException.
Session.createMapMessage()
,
BytesMessage
,
Message
,
ObjectMessage
,
StreamMessage
,
TextMessage
Fields inherited from interface javax.jms.Message |
DEFAULT_DELIVERY_MODE,
DEFAULT_PRIORITY,
DEFAULT_TIME_TO_LIVE |
Method Summary | |
boolean |
getBoolean(java.lang.String name)
Return the boolean value with the given name. |
byte |
getByte(java.lang.String name)
Return the byte value with the given name. |
byte[] |
getBytes(java.lang.String name)
Return the byte array value with the given name. |
char |
getChar(java.lang.String name)
Return the Unicode character value with the given name. |
double |
getDouble(java.lang.String name)
Return the double value with the given name. |
float |
getFloat(java.lang.String name)
Return the float value with the given name. |
int |
getInt(java.lang.String name)
Return the integer value with the given name. |
long |
getLong(java.lang.String name)
Return the long value with the given name. |
java.util.Enumeration |
getMapNames()
Return an Enumeration of all the Map message's names. |
java.lang.Object |
getObject(java.lang.String name)
Return the Java object value with the given name. |
short |
getShort(java.lang.String name)
Return the short value with the given name. |
java.lang.String |
getString(java.lang.String name)
Return the String value with the given name. |
boolean |
itemExists(java.lang.String name)
Check if an item exists in this MapMessage. |
void |
setBoolean(java.lang.String name,
boolean value)
Set a boolean value with the given name, into the Map. |
void |
setByte(java.lang.String name,
byte value)
Set a byte value with the given name, into the Map. |
void |
setBytes(java.lang.String name,
byte[] value)
Set a byte array value with the given name, into the Map. |
void |
setBytes(java.lang.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(java.lang.String name,
char value)
Set a Unicode character value with the given name, into the Map. |
void |
setDouble(java.lang.String name,
double value)
Set a double value with the given name, into the Map. |
void |
setFloat(java.lang.String name,
float value)
Set a float value with the given name, into the Map. |
void |
setInt(java.lang.String name,
int value)
Set an integer value with the given name, into the Map. |
void |
setLong(java.lang.String name,
long value)
Set a long value with the given name, into the Map. |
void |
setObject(java.lang.String name,
java.lang.Object value)
Set a Java object value with the given name, into the Map. |
void |
setShort(java.lang.String name,
short value)
Set a short value with the given name, into the Map. |
void |
setString(java.lang.String name,
java.lang.String value)
Set a String value with the given name, into the Map. |
Method Detail |
public boolean getBoolean(java.lang.String name) throws JMSException
name
- the name of the booleanpublic byte getByte(java.lang.String name) throws JMSException
name
- the name of the bytepublic short getShort(java.lang.String name) throws JMSException
name
- the name of the shortpublic char getChar(java.lang.String name) throws JMSException
name
- the name of the Unicode characterpublic int getInt(java.lang.String name) throws JMSException
name
- the name of the integerpublic long getLong(java.lang.String name) throws JMSException
name
- the name of the longpublic float getFloat(java.lang.String name) throws JMSException
name
- the name of the floatpublic double getDouble(java.lang.String name) throws JMSException
name
- the name of the doublepublic java.lang.String getString(java.lang.String name) throws JMSException
name
- the name of the Stringpublic byte[] getBytes(java.lang.String name) throws JMSException
name
- the name of the byte arraypublic java.lang.Object getObject(java.lang.String name) throws JMSException
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
name
- the name of the Java object
public java.util.Enumeration getMapNames() throws JMSException
public void setBoolean(java.lang.String name, boolean value) throws JMSException
name
- the name of the booleanvalue
- the boolean value to set in the Map.public void setByte(java.lang.String name, byte value) throws JMSException
name
- the name of the bytevalue
- the byte value to set in the Map.public void setShort(java.lang.String name, short value) throws JMSException
name
- the name of the shortvalue
- the short value to set in the Map.public void setChar(java.lang.String name, char value) throws JMSException
name
- the name of the Unicode charactervalue
- the Unicode character value to set in the Map.public void setInt(java.lang.String name, int value) throws JMSException
name
- the name of the integervalue
- the integer value to set in the Map.public void setLong(java.lang.String name, long value) throws JMSException
name
- the name of the longvalue
- the long value to set in the Map.public void setFloat(java.lang.String name, float value) throws JMSException
name
- the name of the floatvalue
- the float value to set in the Map.public void setDouble(java.lang.String name, double value) throws JMSException
name
- the name of the doublevalue
- the double value to set in the Map.public void setString(java.lang.String name, java.lang.String value) throws JMSException
name
- the name of the Stringvalue
- the String value to set in the Map.public void setBytes(java.lang.String name, byte[] value) throws JMSException
name
- the name of the byte arrayvalue
- 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.public void setBytes(java.lang.String name, byte[] value, int offset, int length) throws JMSException
name
- the name of the byte arrayvalue
- the byte array value to set in the Map.offset
- the initial offset within the byte array.length
- the number of bytes to use.public void setObject(java.lang.String name, java.lang.Object value) throws JMSException
Note that this method only works for the objectified primitive object types (Integer, Double, Long ...), String's and byte arrays.
name
- the name of the Java objectvalue
- the Java object value to set in the Map.public boolean itemExists(java.lang.String name) throws JMSException
name
- the name of the item to test
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |