javax.management
Class NotificationBroadcasterSupport
- NotificationBroadcaster, NotificationEmitter
Provides an implementation of the
NotificationEmitter
interface, which beans may utilise by extension. By default,
a synchronous dispatch system is provided, whereby the
handleNotification(NotificationListener,Notification,Object) is called once per listener by
{*@link #sendNotification(Notification)} before returning.
Thus, unless the listener is remote, it will have received
the notification before the method returns.
This may be changed by overriding the
handleNotification
method, or by providing an
java.util.concurrent.Executor to
use. With the latter, the dispatch of a notification to a particular
listener will form one task performed by the executor.
Any exceptions thrown by the dispatch process will be caught, allowing
other listeners to still receive the notification. However, any
Errors that are thrown will be propogated to the caller of
sendNotification(Notification).
clone, equals, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait |
NotificationBroadcasterSupport
public NotificationBroadcasterSupport(Executor executor)
executor - the executor to use for each call to
handleNotification().
NotificationBroadcasterSupport
public NotificationBroadcasterSupport(Executor executor,
javax.management.MBeanNotificationInfo... info)executor - the executor to use for each call to
handleNotification().info - an array of MBeanNotificationInfo objects
describing the notifications delivered by this
broadcaster. This may be null, which
is taken as being equivalent to an empty array.
NotificationBroadcasterSupport
public NotificationBroadcasterSupport(javax.management.MBeanNotificationInfo... info)
Constructs a
NotificationBroadcasterSupport using
the default synchronous dispatch model, where a single
thread sends the notification to all listeners. The specified
MBeanNotificationInfo array is used to provide
information about the notifications on calls to
getNotificationInfo(), where a clone will be
returned if the array is non-empty. This is equivalent to
calling
NotificationBroadcasterSupport(null, info).
info - an array of MBeanNotificationInfo objects
describing the notifications delivered by this
broadcaster. This may be null, which
is taken as being equivalent to an empty array.
addNotificationListener
public void addNotificationListener(NotificationListener listener,
NotificationFilter filter,
Object passback)
throws IllegalArgumentException Registers the specified listener as a new recipient of
notifications from this bean. If non-null, the filter
argument will be used to select which notifications are
delivered. The supplied object will also be passed to
the recipient with each notification. This should not
be modified by the broadcaster, but instead should be
passed unmodified to the listener.
- addNotificationListener in interface NotificationBroadcaster
listener - the new listener, who will receive
notifications from this broadcasting bean.filter - a filter to determine which notifications are
delivered to the listener, or null
if no filtering is required.passback - an object to be passed to the listener with
each notification.
handleNotification
protected void handleNotification(NotificationListener listener,
Notification notif,
Object passback) This method is called on a per-listener basis, either
from this thread or the supplied executor, and may be
overridden by subclasses which wish to change how
notifications are delivered. The default
implementation simply calls
listener.handleNotification(notif, passback).
listener - the listener to send the notification to.notif - the notification to dispatch.passback - the passback object of the listener.
NotificationBroadcasterSupport.java -- Supporting implementation.
Copyright (C) 2007 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version.