Sun Java logo     Copyright      Index      Next     

Sun logo
Sun Java System Message Queue 3.5 SP1 Java Client Developer's Guide 


List of Figures

List of Tables

List of Procedures

List of Code Examples

Audience for This Guide
Organization of This Guide
Text Conventions
Directory Variable Conventions
Other Documentation Resources
The Message Queue Documentation Set
Example Client Applications
The Java Message Service (JMS) Specification
The Java XML Messaging (JAXM) Specification
Books on JMS Programming

Chapter 1   Overview
What Is Sun Java System Message Queue?
Product Editions
Platform Edition
Enterprise Edition
Message Queue Service Architecture
The JMS Programming Model
JMS Programming Interface
Message Producer
Message Consumer
Message Listener
Administered Objects
JMS Client Setup Operations
To Set Up a Client to Produce Messages
To Set Up a Client to Consume Messages
JMS Client Design Issues
Programming Domains
JMS Provider Independence
Client Identifiers
Reliable Messaging
Persistent Storage
Performance Trade-offs
Message Consumption: Synchronous and Asynchronous
Message Selection
Message Order and Priority
JMS/J2EE Programming: Message-Driven Beans
Message-Driven Beans
J2EE Application Server Support

Chapter 2   Quick Start Tutorial
Setting Up Your Environment
Starting and Testing the Message Server
To Start a Broker
To Test a Broker
Developing a Simple Client Application
Compiling and Running a Client Application
To Compile and Run the HelloWorldMessage Application
Example Application Code

Chapter 3   Using Administered Objects
JNDI Lookup of Administered Objects
Looking Up ConnectionFactory Objects
To Perform a JNDI Lookup of a ConnectionFactory Object
Looking Up Destination Objects
To Perform a JNDI Lookup of a Destination Object
Instantiating Administered Objects
Instantiating ConnectionFactory Objects
To Directly Instantiate and Configure a ConnectionFactory Object
Instantiating Destination Objects
To Directly Instantiate and Configure a Destination Object
Starting Client Applications With Overrides

Chapter 4   Configuring the Message Queue Client Runtime
Message Production and Consumption
Message Production
Message Consumption
Client Runtime Configurable Properties
Connection Handling
Specifying a Message Server Address
Connecting to a Message Server
Automatic Reconnect to a Message Server (Enterprise Edition)
Auto-reconnect Behavior
Message Queue 3.0 Connection Handling
Client Identification
Message Header Overrides
Reliability And Flow Control
Queue Browser Behavior and Server Session
JMS-Defined Properties Support
Managing Reliability and Performance
Delivery Mode
Client Acknowledgement Mode
Message Flow Metering
Message Flow Limits

Chapter 5   Message Queue Client Programming Techniques
Custom Client Acknowledgement
Message-Based Monitoring API
Format of Metrics Messages
Broker Metrics
JVM Metrics
Destination-List Metrics
Destination Metrics
Configuring Metrics Message Production on the Broker
Using the Message-Based Monitoring API
Metrics Monitoring Client Code Examples
A Broker Metrics Example
A Destination List Metrics Example
A Destination Metrics Example
Client Connection Failover (Auto-reconnect)
Enabling Auto-reconnect
Auto-reconnect Behaviors
Auto-reconnect Limitations
Auto-reconnect Configuration Examples
Single-Broker Auto-reconnect
Parallel Broker Auto-reconnect
Clustered-Broker Auto-reconnect
Other Programming Topics
Managing Memory and Message Size
Using Secure HTTP Connections (HTTPS)
In Case of Server or Broker Failure
Repairing an HTTPS Tunnel Servlet Connection
Managing Client Threads
Synchronous Consumption in Distributed Applications
Client Application Deployment Considerations

Chapter 6   Working With SOAP Messages
What is SOAP?
SOAP and the JAVA for XML Messaging API
The Transport Layer
The SOAP Layer
The Provider Layer
The Profiles Layer
The SOAP Message
SOAP Packaging Models
SOAP Messaging in JAVA
The SOAP Message Object
Inherited Methods
Destination, Message Factory, and Connection Objects
Message Factory
Using JAXM Administered Objects
SOAP Messaging Models and Examples
SOAP Messaging Programming Models
Point-to-Point Connections
Provider Connections
Working with Attachments
To Create and Add an Attachment
Exception and Fault Handling
Writing a SOAP Client
Writing a SOAP Service
Disassembling Messages
Handling Attachments
Replying to Messages
Handling SOAP Faults
Integrating SOAP and Message Queue
Example 1: Deferring SOAP Processing
To Transform the SOAP Message into a JMS Message and Send the JMS Message
To Receive the JMS Message, Transform it into a SOAP Message, and Process It
Example 2: Publishing SOAP Messages
Code Samples

Appendix A   Administered Object Attributes
ConnectionFactory Administered Object
Destination Administered Objects
Endpoint Administered Objects

Appendix B   Client Error Codes

Copyright      Index      Next     

Copyright 2004 Sun Microsystems, Inc. All rights reserved.