O'Reilly - Java Message Service

A.1.15 Session
Java Message Service
The Session is the base interface for the TopicSession and the QueueSession. It defines
several general-purpose methods used by JMS clients for managing a JMS Session.
Among these methods are the six createMessage( ) methods (one for each type of Message
object), setMessageListener( ), close( ), and transaction methods.
A Session is a single-threaded context for producing and consuming messages. It creates
message consumers, producers, and messages for a specific JMS provider. The Session
manages the scope of transactions across send and receive operations, tracks message
acknowledgment for consumers, and serializes delivery of messages to MessageListener
objects:
public interface Session extends java.lang.Runnable {
public static final int AUTO_ACKNOWLEDGE = 1;
public static final int CLIENT_ACKNOWLEDGE = 2;
public static final int DUPS_OK_ACKNOWLEDGE = 3;
}
public BytesMessage createBytesMessage( ) throws JMSException;
public MapMessage createMapMessage( ) throws JMSException;
public Message createMessage( ) throws JMSException;
public ObjectMessage createObjectMessage( ) throws JMSException;
public ObjectMessage createObjectMessage(Serializable object)
throws JMSException;
public StreamMessage createStreamMessage( ) throws JMSException;
public TextMessage createTextMessage( ) throws JMSException;
public TextMessage createTextMessage(java.lang.String text)
throws JMSException;
public boolean getTransacted( ) throws JMSException;
public void commit( ) throws JMSException;
public void rollback( ) throws JMSException;
public void close( ) throws JMSException;
public void recover( ) throws JMSException;
public MessageListener getMessageListener( ) throws JMSException;
public void setMessageListener(MessageListener listener)
throws JMSException;
public void run( );
A.1.16 StreamMessage
This Message type carries a stream of primitive Java types (int, double, char, etc.) as its
payload. It provides a set of convenience methods for mapping a formatted stream of bytes
to Java primitives. It provides an easy programming model for exchanging primitive
application data in a fixed order:
public interface StreamMessage extends Message {
public boolean readBoolean( ) throws JMSException;
public void writeBoolean(boolean value) throws JMSException;
public byte readByte( ) throws JMSException;
public int readBytes(byte[] value) throws JMSException;
public void writeByte(byte value) throws JMSException;
public void writeBytes(byte[] value) throws JMSException;
public void writeBytes(byte[] value, int offset, int length)
throws JMSException;
public short readShort( ) throws JMSException;
public void writeShort(short value) throws JMSException;
public char readChar( ) throws JMSException;
public void writeChar(char value) throws JMSException;
public int readInt( ) throws JMSException;
149