01: /* JFox, the OpenSource J2EE Application Server
02: *
03: * Copyright (C) 2002 huihoo.com
04: * Distributable under GNU LGPL license
05: * See the GNU Lesser General Public License for more details.
06: */
07:
08: package javax.management;
09:
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 JMX 1.2
19: *
20: * @author <a href="mailto:young_yy@hotmail.com">Young Yang</a>
21: */
22:
23: public interface NotificationEmitter extends NotificationBroadcaster {
24: /**
25: * <p>Removes a listener from this MBean. The MBean must have a
26: * listener that exactly matches the given <code>listener</code>,
27: * <code>filter</code>, and <code>handback</code> parameters. If
28: * there is more than one such listener, only one is removed.</p>
29: *
30: * <p>The <code>filter</code> and <code>handback</code> parameters
31: * may be null if and only if they are null in a listener to be
32: * removed.</p>
33: *
34: * @param listener A listener that was previously added to this
35: * MBean.
36: * @param filter The filter that was specified when the listener
37: * was added.
38: * @param handback The handback that was specified when the listener was
39: * added.
40: *
41: * @exception ListenerNotFoundException The listener is not
42: * registered with the MBean, or it is not registered with the
43: * given filter and handback.
44: */
45: public void removeNotificationListener(
46: NotificationListener listener, NotificationFilter filter,
47: Object handback) throws ListenerNotFoundException;
48:
49: }
|