Copyright      Index      Next
Sun Java System Message Queue 3 2005Q4 Developer's Guide for Java Clients

Contents

List of Figures

List of Tables

List of Code Examples

Preface

Who Should Use This Book

Before You Read This Book

How This Book Is Organized

Conventions Used in this Book

Text Conventions

Directory Variable Conventions

Related Documentation

The Message Queue Documentation Set

JavaDoc

Example Client Applications

The Java Message Service (JMS) Specification

The SOAP with Attachments API for Java (SAAJ) Specification

Books on JMS Programming

Related Third-Party Web Site References

Sun Welcomes Your Comments

Chapter 1   Overview

Setting Up Your Environment

Starting and Testing a Message Broker

To Start a Broker

To Test a Broker

Developing a Client Application

To Produce Messages

To Consume Messages

Compiling and Running a Client Application

To Compile and Run the HelloWorldMessage Application

Deploying a Client Application

Example Application Code

Chapter 2   Using the Java API

Messaging Domains

Working With Connections

Obtaining a Connection Factory

Looking Up a Connection Factory With JNDI

To Look Up a Connection Factory With JNDI

Overriding Configuration Settings

Instantiating a Connection Factory

To Instantiate and Configure a Connection Factory

Using Connections

Working With Destinations

Looking Up a Destination With JNDI

To Look Up a Destination With JNDI

Instantiating a Destination

Temporary Destinations

Working With Sessions

Acknowledgment Modes

Transacted Sessions

Working With Messages

Message Structure

Message Header

Message Properties

Message Body

Composing Messages

Composing Text Messages

Composing Stream Messages

Composing Map Messages

Composing Object Messages

Composing Bytes Messages

Sending Messages

Receiving Messages

Creating Message Consumers

Receiving Messages Synchronously

Receiving Messages Asynchronously

To Set Up a Message Queue Java Client to Receive Messages Asynchronously

Acknowledging Messages

Browsing Messages

Closing a Consumer

Processing Messages

Retrieving Message Header Fields

Retrieving Message Properties

Processing the Message Body

Chapter 3   Message Queue Clients: Design and Features

Client Design Considerations

Developing Portable Clients

Choosing Messaging Domains

Connections and Sessions

Producers and Consumers

Assigning Client Identifiers

Message Order and Priority

Using Selectors Efficiently

Balancing Reliability and Performance

Managing Client Threads

JMS Threading Restrictions

Thread Allocation for Connections

Managing Memory and Resources

Managing Memory

Managing Message Size

Message Compression

Advantages and Limitations of Compression

Compression Examples

Managing the Dead Message Queue

Managing Physical Destination Limits

Programming Issues for Message Consumers

Using the Client Runtime Ping Feature

Preventing Message Loss for Synchronous Consumers

Synchronous Consumption in Distributed Applications

Factors Affecting Performance

Delivery Mode (Persistent/Nonpersistent)

Use of Transactions

Acknowledgment Mode

Durable vs. Nondurable Subscriptions

Use of Selectors (Message Filtering)

Message Size

Message Body Type

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

Custom Client Acknowledgment

Using Client Acknowledge Mode

Using No Acknowledge Mode

Communicating with C Clients

Chapter 4   Using the Metrics Monitoring API

Monitoring Overview

Administrative Tasks

Implementation Summary

Creating a Metrics-Monitoring Client

Format of Metrics Messages

Broker Metrics

JVM Metrics

Destination-List Metrics

Destination Metrics

Metrics Monitoring Client Code Examples

A Broker Metrics Example

A Destination List Metrics Example

A Destination Metrics Example

Chapter 5   Working with SOAP Messages

What is SOAP?

SOAP with Attachments API for Java

The Transport Layer

The SOAP Layer

The Language Implementation Layer

The Profiles Layer

Interoperability

The SOAP Message

SOAP Packaging Models

SOAP Messaging in JAVA

The SOAP Message Object

Inherited Methods

Namespaces

Destination, Message Factory, and Connection Objects

Endpoint

Message Factory

Connection

Using SOAP Administered Objects

SOAP Messaging Models and Examples

SOAP Messaging Programming Models

Point-to-Point 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   Warning Messages and Client Error Codes

Index

Copyright      Index      Next

---

Part No: 819-2573-10.   Copyright 2005 Sun Microsystems, Inc. All rights reserved.