Setting the Exception Listener

Figure 16-59 Use Case Diagram: Setting the Exception Listener

Text description of the illustration adq16jsia.gif

To refer to the table of all basic operations having to do with the Operational Interface see: "Use Case Model: Operational Interface -- Basic Operations"

Purpose

Specify an Exception Listener for the connection.

Usage Notes

If a serious problem is detected for the connection, the connection's ExceptionListener, if one has been registered, will be informed. This is done by calling the listener's onException() method, passing it a JMSException describing the problem. This allows a JMS client to be asynchronously notified of a problem. Some connections only consume messages, so they have no other way to learn the connection has failed.

Syntax

See Chapter 3, "AQ Programmatic Environments" for a list of available functions in each programmatic environment. Use the following syntax references for each programmatic environment:

• See Java (JDBC): Oracle9i Supplied Java Packages Reference, oracle.jms AQjmsConnection.setExceptionListener

Examples

//register an exception listener
Connection jms_connection;
jms_connection.setExceptionListener(
    new ExceptionListener() {
        public void onException (JMSException jmsException) {
            System.out.println("JMS-EXCEPTION: " + jmsException.toString());
        }
    };
  );