O'Reilly - Java Message Service

MessageFormatException
Java Message Service
Thrown when a JMS client attempts to use a data type not supported by a message,
or attempts to read data in a message as the wrong type. Also thrown when type
errors are made with message property values. Note that this exception should not be
thrown when attempting to read improperly formatted String data as numeric values.
java.lang.NumberFormatException should be used in this case.
MessageNotReadableException
Thrown when a JMS client tries to read a write-only message.
MessageNotWriteableException
Thrown when a JMS client tries to write to a read-only message.
ResourceAllocationException
Thrown when a provider is unable to allocate the resources required by a method.
This exception should be thrown when a call to createTopicConnection( ) fails
because the JMS provider has insufficient resources.
TransactionInProgressException
Thrown when an operation is invalid because a transaction is in progress. For
instance, it should be thrown if you call Session.commit( ) when a session is part of
a distributed transaction.
TransactionRolledBackException
Thrown when calling Session.commit( ) results in a transaction rollback.
A.1.9 MapMessage
This Message type carries a set of name-value pairs as its payload. The payload is similar to
a java.util.Properties object, except the values must be Java primitives or their
wrappers. The MapMessage is useful for delivering keyed data:
public interface MapMessage extends Message {
public boolean getBoolean(String name) throws JMSException;
public void setBoolean(String name, boolean value)
throws JMSException;
public byte getByte(String name) throws JMSException;
public void setByte(String name, byte value) throws JMSException;
public byte[] getBytes(String name) throws JMSException;
public void setBytes(String name, byte[] value)
throws JMSException;
public void setBytes(String name, byte[] value,
int offset, int length)
throws JMSException;
public short getShort(String name) throws JMSException;
public void setShort(String name, short value) throws JMSException;
public char getChar(String name) throws JMSException;
public void setChar(String name, char value) throws JMSException;
public int getInt(String name) throws JMSException;
145