1 /* 2 * @(#)NotificationEmitter.java 1.13 03/12/19 3 * 4 * Copyright 2004 Sun Microsystems, Inc. All rights reserved. 5 * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. 6 */ 7 8 package javax.management; 9 10 /** 11 * <p>Interface implemented by an MBean that emits Notifications. It 12 * allows a listener to be registered with the MBean as a notification 13 * listener.</p> 14 * 15 * <p>This interface should be used by new code in preference to the 16 * {@link NotificationBroadcaster} interface.</p> 17 * 18 * @since 1.5 19 * @since.unbundled JMX 1.2 20 */ 21 public interface NotificationEmitter extends NotificationBroadcaster { 22 /** 23 * <p>Removes a listener from this MBean. The MBean must have a 24 * listener that exactly matches the given <code>listener</code>, 25 * <code>filter</code>, and <code>handback</code> parameters. If 26 * there is more than one such listener, only one is removed.</p> 27 * 28 * <p>The <code>filter</code> and <code>handback</code> parameters 29 * may be null if and only if they are null in a listener to be 30 * removed.</p> 31 * 32 * @param listener A listener that was previously added to this 33 * MBean. 34 * @param filter The filter that was specified when the listener 35 * was added. 36 * @param handback The handback that was specified when the listener was 37 * added. 38 * 39 * @exception ListenerNotFoundException The listener is not 40 * registered with the MBean, or it is not registered with the 41 * given filter and handback. 42 */ 43 public void removeNotificationListener(NotificationListener listener, 44 NotificationFilter filter, 45 Object handback) 46 throws ListenerNotFoundException; 47 } 48