javax.jms.ExceptionListener Maven / Gradle / Ivy
/*
* @(#)ExceptionListener.java 1.8 02/04/09
*
* Copyright 1997-2002 Sun Microsystems, Inc. All Rights Reserved.
*
* SUN PROPRIETARY/CONFIDENTIAL.
* This software is the proprietary information of Sun Microsystems, Inc.
* Use is subject to license terms.
*
*/
package javax.jms;
/** If a JMS provider detects a serious problem with a Connection
* object, it informs the Connection object's
* ExceptionListener, if one has been registered.
* It does this by calling the listener's onException method,
* passing it a JMSException argument describing the problem.
*
* An exception listener allows a client to be notified of a problem
* asynchronously. Some connections only consume messages, so they would have no
* other way to learn that their connection has failed.
*
*
A JMS provider should attempt to resolve connection problems
* itself before it notifies the client of them.
*
* @version 1.0 - 9 March 1998
* @author Mark Hapner
* @author Rich Burridge
*
* @see javax.jms.Connection#setExceptionListener(ExceptionListener)
*/
public interface ExceptionListener {
/** Notifies user of a JMS exception.
*
* @param exception the JMS exception
*/
void
onException(JMSException exception);
}