Sun GlassFish(tm) Message Queue v4.4

## Package com.sun.messaging.jms.notification

Provides a notification API for the MQ client runtime to inform an application about a MQ connection state changes.

See:
Description

Interface Summary
EventListener: An event listener object is used to receive asynchronously delivered MQ events.

Class Summary
ConnectionClosedEvent: MQ Connection closed Event.
ConnectionClosingEvent: MQ Connection closing Event.
ConnectionEvent: MQ Connection Event.
ConnectionReconnectedEvent: MQ Connection Reconnected Event is generated and delivered to the event listener if the MQ client runtime reconnected to a broker and an event listener is set to the MQ connection.
ConnectionReconnectFailedEvent: MQ Connection Reconnect Failed Event is generated and delivered to the event listener if a MQ reconnect failed and an event listener is set to the MQ connection.
Event: MQ Event.

## Package com.sun.messaging.jms.notification Description

Provides a notification API for the MQ client runtime to inform an application about a MQ connection state changes.

The current notification types defined for the MQ 4.0 release are as follows:

- Connection closing event. A connection closing event is generated and delivered to the event listener if the broker is about to close a MQ connection (such as admin requested shutdown) and an event listener is set to the MQ connection.
- Connection closed event. A connection closed event is generated and delivered to the event listener if the broker closed a MQ connection (such as admin requested shutdown, restart, out of memory, etc.) and an event listener is set to the MQ connection.
- Connection reconnected event. A connection reconnected event is generated and delivered to the event listener if the MQ client runtime reconnected to a broker and an event listener is set to the MQ connection.
- Connection reconnect failed event. A connection reconnect failed event is generated and delivered to the event listener if a reconnect attempt to a broker failed and an event listener is set to the MQ connection. (MQ client runtime will retry base on the reconnect contract).

A MQ application sets a connection event listener in order to be notified for the MQ events. The API to set the notification listener is defined in the `com.sun.messaging.jms.Connection` class.

See Also:
  `com.sun.messaging.jms`

Sun GlassFish(tm) Message Queue v4.4

Copyright 2009 Sun Microsystems, Inc. 4150 Network Circle,
Santa Clara, California, 95054, U.S.A. All Rights Reserved.