Java Message Service, 2nd Edition

Appendix A. The Java Message Service API

This appendix is a quick reference guide to the Java Message Service API. It is organized into five sections: (next), Common Facilities, Common API, Point-to-Point API, and Publish-and-Subscribe API. Each section provides a summary of its interfaces and is organized alphabetically. The XA-compliant interfaces are not included in this section because they are essentially the same as their non-XA interfaces. In addition, the Application Server API (ConnectionConsumer, ServerSession, and ServerSessionPool) is not covered in this book because this API is not supported by most vendors.

Message Interfaces

This section covers the message interface and the six message types.

BytesMessage

This Message type carries an array of primitive bytes as its payload. It’s useful for exchanging data in an application’s native format, providing for a high degree of interoperability with other messaging servers. It is also useful where JMS is used purely as a transport between two systems, and the message payload is opaque to the JMS client:

public interface BytesMessage extends Message { public long getBodyLength() throws JMSException public byte readByte() throws JMSException; public void writeByte(byte value) throws JMSException; public int readUnsignedByte() throws JMSException; public int readBytes(byte[] value) throws JMSException; public void writeBytes(byte[] value) throws JMSException; public int readBytes(byte[] value, int length) throws JMSException; public ...