NotificationBroadcasterSupport (Java Platform SE 8 )

java.lang.Object
- javax.management.NotificationBroadcasterSupport

All Implemented Interfaces:

NotificationBroadcaster ， NotificationEmitter

已知直接子类：

JMXConnectorServer ， Monitor ， RelationService ， Timer
```
public class NotificationBroadcasterSupport
extends Object
implements NotificationEmitter
```
提供NotificationEmitter 接口的实现。这可以用作发送通知的MBean的超类。

默认情况下，通知调度模型是同步的。也就是说，当线程调用sendNotification时，在该线程中调用每个侦听器的NotificationListener.handleNotification方法。您可以覆盖此默认通过重写handleNotification ，或通过传递一个Executor给构造一个子类。

如果过滤器或侦听器的方法调用抛出异常 ，则该异常不会阻止其他侦听器被调用。然而，如果或过滤器的方法调用Executor.execute或handleNotification （无时Excecutor被指定）抛出Error ，则该Error被传播到的呼叫者sendNotification 。

使用JMX Remote API添加的远程侦听器（见JMXConnector）通常不会同步调用。也就是说，当sendNotification返回时，不能保证任何远程侦听器尚未收到通知。

从以下版本开始：

1.5

构造方法摘要

构造方法
Constructor and Description
`NotificationBroadcasterSupport()` 构造一个NotificationBroadcasterSupport，其中每个侦听器被发送通知的线程调用。
`NotificationBroadcasterSupport(Executor executor)` 构造一个NotificationBroadcasterSupport，其中使用给定的`Executor`调用每个侦听器。
`NotificationBroadcasterSupport(Executor executor, MBeanNotificationInfo... info)` 构造一个NotificationBroadcasterSupport，其中包含有关可能发送的通知的信息，以及使用给定的`Executor`调用每个监听器的信息。
`NotificationBroadcasterSupport(MBeanNotificationInfo... info)` 构建一个NotificationBroadcasterSupport，其中包含可能发送的通知的信息。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`addNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback)` 添加一个监听器。
`MBeanNotificationInfo[]`	`getNotificationInfo()` 返回一个数组，指示MBean可能发送的每个通知，通知的Java类的名称和通知类型。
`protected void`	`handleNotification(NotificationListener listener, Notification notif, Object handback)` 为每个侦听器调用此方法 `sendNotification`才能将通知发送给该侦听器。
`void`	`removeNotificationListener(NotificationListener listener)` 从这个MBean中删除一个监听器。
`void`	`removeNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback)` 从这个MBean中删除一个监听器。
`void`	`sendNotification(Notification notification)` 发送通知。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造方法详细信息
  - NotificationBroadcasterSupport
```
public NotificationBroadcasterSupport()
```
    构造一个NotificationBroadcasterSupport，其中每个侦听器被发送通知的线程调用。该构造函数相当于NotificationBroadcasterSupport(null, null) 。
  - NotificationBroadcasterSupport
```
public NotificationBroadcasterSupport(Executor executor)
```
    构造一个NotificationBroadcasterSupport，其中使用给定的Executor调用每个侦听器。当调用sendNotification时，如果添加了一个null NotificationFilter ，或者如果isNotificationEnabled为正在发送的通知返回true，则选择一个侦听器。 NotificationFilter.isNotificationEnabled的调用发生在调用sendNotification的线程中。然后，对于每个所选择的监听器， executor.execute被调用，调用一个命令handleNotification方法。该构造函数相当于NotificationBroadcasterSupport(executor, null) 。
    
    参数
    
    executor - 方法sendNotification使用的执行器发送每个通知。如果为null，调用sendNotification的线程将自动调用handleNotification方法。
    
    从以下版本开始：
    
    1.6
  - NotificationBroadcasterSupport
```
public NotificationBroadcasterSupport(MBeanNotificationInfo... info)
```
    构建一个NotificationBroadcasterSupport，其中包含可能发送的通知的信息。发送通知的线程调用每个侦听器。该构造函数相当于NotificationBroadcasterSupport(null, info) 。
    
    如果info数组不为空，则通过构造克隆仿佛info.clone() ，并且每次调用getNotificationInfo()返回一个新的克隆。
    
    参数
    
    info - 一个数组，指示MBean可能发送的每个通知，通知的Java类的名称和通知类型。可以为空，这相当于一个空数组。
    
    从以下版本开始：
    
    1.6
  - NotificationBroadcasterSupport
```
public NotificationBroadcasterSupport(Executor executor,
                                      MBeanNotificationInfo... info)
```
    构造一个NotificationBroadcasterSupport，其中包含有关可能发送的通知的信息，以及使用给定的Executor调用每个监听器的信息。
    
    当sendNotification被调用时，选择了一个监听器，如果它是用空加NotificationFilter ，或isNotificationEnabled的通知返回true发送。 NotificationFilter.isNotificationEnabled的调用发生在调用sendNotification的线程中。然后，对于每个所选择的监听器， executor.execute被调用，调用一个命令handleNotification方法。
    
    如果info数组不为空， info函数克隆，就像通过info.clone() ，并且每次调用getNotificationInfo()返回一个新的克隆。
    
    参数
    
    executor - 方法sendNotification使用的执行器发送每个通知。如果为null，调用sendNotification的线程将自动调用handleNotification方法。
    
    info - 一个数组，指示MBean可能发送的每个通知，通知的Java类的名称和通知类型。可以为空，这相当于一个空数组。
    
    从以下版本开始：
    
    1.6
- 方法详细信息
  - addNotificationListener
```
public void addNotificationListener(NotificationListener listener,
                                    NotificationFilter filter,
                                    Object handback)
```
    添加一个监听器。
    
    Specified by:
    
    addNotificationListener在接口 NotificationBroadcaster
    
    参数
    
    listener - 接收通知的侦听器。
    
    filter - 过滤器对象。如果过滤器为空，则在处理通知之前不会执行过滤。
    
    handback - 发出通知时要发送回侦听器的不透明对象。该通知广播对象无法使用此对象。通知发送者应该重新发送更改。
    
    异常
    
    IllegalArgumentException - 如果监听器为空，则抛出。
    
    另请参见：
    
    removeNotificationListener(javax.management.NotificationListener)
  - removeNotificationListener
```
public void removeNotificationListener(NotificationListener listener)
                                throws ListenerNotFoundException
```
    说明从界面： NotificationBroadcaster复制
    
    从这个MBean中删除一个监听器。如果侦听器已经注册了不同的回传对象或通知过滤器，则与侦听器对应的所有条目都将被删除。
    
    Specified by:
    
    removeNotificationListener中的 NotificationBroadcaster
    
    参数
    
    listener - 以前添加到此MBean的侦听器。
    
    异常
    
    ListenerNotFoundException - 监听器未注册到MBean。
    
    另请参见：
    
    NotificationBroadcaster.addNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object) ， NotificationEmitter.removeNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)
  - removeNotificationListener
```
public void removeNotificationListener(NotificationListener listener,
                                       NotificationFilter filter,
                                       Object handback)
                                throws ListenerNotFoundException
```
    描述从接口： NotificationEmitter复制
    
    从这个MBean中删除一个监听器。该MBean必须有一个与给定匹配的侦听listener ， filter和handback参数。如果有多个这样的听众，只有一个被删除。
    
    filter和handback参数可以为null，当且仅当它们在要删除的侦听器中为空时。
    
    Specified by:
    
    removeNotificationListener在接口 NotificationEmitter
    
    参数
    
    listener - 以前添加到此MBean的侦听器。
    
    filter - 添加侦听器时指定的过滤器。
    
    handback - 添加侦听器时指定的回传。
    
    异常
    
    ListenerNotFoundException - 监听器没有向MBean注册，或者没有向给定的过滤器和回传注册。
  - getNotificationInfo
```
public MBeanNotificationInfo[] getNotificationInfo()
```
    说明从接口： NotificationBroadcaster复制
    
    返回一个数组，指示MBean可能发送的每个通知，通知的Java类的名称和通知类型。
    
    MBean发送不在此阵列中描述的通知并不是非法的。但是，MBean服务器的某些客户端可能依赖于正确运行的阵列。
    
    Specified by:
    
    getNotificationInfo在接口 NotificationBroadcaster
    
    结果
    
    可能通知的数组。
  - sendNotification
```
public void sendNotification(Notification notification)
```
    发送通知。如果在Executor中指定了一个Executor，则每个选定的侦听器将为其提供一个任务，以将该通知传递给该侦听器。
    
    参数
    
    notification - 发送通知。
  - handleNotification
```
protected void handleNotification(NotificationListener listener,
                                  Notification notif,
                                  Object handback)
```
    为每个侦听器调用此方法sendNotification才能将该通知发送给该侦听器。在子类中可以覆盖它，以更改通知传递的行为，例如在单独的线程中传递通知。
    
    此方法的默认实现方式相当于
```
  listener.handleNotification(notif, handback); 
```
    参数
    
    listener - 正在传递通知的收听者。
    
    notif - 正在传递给收听者的通知。
    
    handback - the handback object that was supplied when the listener was added.

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class NotificationBroadcasterSupport

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

NotificationBroadcasterSupport

NotificationBroadcasterSupport

NotificationBroadcasterSupport

NotificationBroadcasterSupport

方法详细信息

addNotificationListener

removeNotificationListener

removeNotificationListener

getNotificationInfo

sendNotification

handleNotification