1 /*** 2 * Redistribution and use of this software and associated documentation 3 * ("Software"), with or without modification, are permitted provided 4 * that the following conditions are met: 5 * 6 * 1. Redistributions of source code must retain copyright 7 * statements and notices. Redistributions must also contain a 8 * copy of this document. 9 * 10 * 2. Redistributions in binary form must reproduce the 11 * above copyright notice, this list of conditions and the 12 * following disclaimer in the documentation and/or other 13 * materials provided with the distribution. 14 * 15 * 3. The name "Exolab" must not be used to endorse or promote 16 * products derived from this Software without prior written 17 * permission of Exoffice Technologies. For written permission, 18 * please contact info@exolab.org. 19 * 20 * 4. Products derived from this Software may not be called "Exolab" 21 * nor may "Exolab" appear in their names without prior written 22 * permission of Exoffice Technologies. Exolab is a registered 23 * trademark of Exoffice Technologies. 24 * 25 * 5. Due credit should be given to the Exolab Project 26 * (http://www.exolab.org/). 27 * 28 * THIS SOFTWARE IS PROVIDED BY EXOFFICE TECHNOLOGIES AND CONTRIBUTORS 29 * ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT 30 * NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND 31 * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL 32 * EXOFFICE TECHNOLOGIES OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, 33 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 34 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 35 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 36 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 37 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 38 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 39 * OF THE POSSIBILITY OF SUCH DAMAGE. 40 * 41 * Copyright 1999 (C) Exoffice Technologies Inc. All Rights Reserved. 42 * 43 * $Id: DestinationEventListener.java,v 1.3 2005/08/30 07:26:49 tanderson Exp $ 44 * 45 * Date Author Changes 46 * 05/17/2001 jima Created 47 */ 48 package org.exolab.jms.messagemgr; 49 50 import javax.jms.JMSException; 51 52 import org.exolab.jms.client.JmsDestination; 53 54 55 /*** 56 * A DestinatonEventListener will be notified of events generated by the {@link 57 * DestinationManager}. 58 * 59 * @author <a href="mailto:jima@comware.com.au">Jim Alateras</a> 60 * @author <a href="mailto:tma@netspace.net.au">Tim Anderson</a> 61 * @version $Revision: 1.3 $ $Date: 2005/08/30 07:26:49 $ 62 */ 63 public interface DestinationEventListener { 64 65 /*** 66 * Invoked when a destination is created. 67 * 68 * @param destination the destination that was added 69 * @throws JMSException for any error 70 */ 71 void destinationAdded(JmsDestination destination) throws JMSException; 72 73 /*** 74 * Invoked when a destination is removed. 75 * 76 * @param destination the destination that was removed 77 * @throws JMSException for any error 78 */ 79 void destinationRemoved(JmsDestination destination) throws JMSException; 80 81 /*** 82 * Invoked when a message cache is created. 83 * 84 * @param destination the destination that messages are being cached for 85 * @param cache the corresponding cache 86 */ 87 void cacheAdded(JmsDestination destination, DestinationCache cache); 88 89 /*** 90 * Invoked when a message cache is removed. 91 * 92 * @param destination the destination that messages are no longer being 93 * cached for 94 * @param cache the corresponding cache 95 */ 96 void cacheRemoved(JmsDestination destination, DestinationCache cache); 97 } 98