study/uTools-Manuals
1
0
Fork 0
mirror of https://github.com/fofolee/uTools-Manuals.git synced 2025-07-06 00:32:44 +08:00
Code Issues Packages Projects Releases Wiki Activity
uTools-Manuals/docs/java/javax/management/modelmbean/ModelMBeanNotificationBroadcaster.html

345 lines
21 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
compact3
</div>
<div class="subTitle">
javax.management.modelmbean
</div>
<h2 class="title" title="Interface ModelMBeanNotificationBroadcaster">Interface ModelMBeanNotificationBroadcaster</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Superinterfaces:
</dt>
<dd>
<span><a href="../../../javax/management/NotificationBroadcaster.html" title="javax.management中的接口">NotificationBroadcaster</a></span>
</dd>
</dl>
<dl>
<dt>
All Known Subinterfaces:
</dt>
<dd>
<span><a href="../../../javax/management/modelmbean/ModelMBean.html" title="javax.management.modelmbean中的接口">ModelMBean</a></span>
</dd>
</dl>
<dl>
<dt>
所有已知实现类：
</dt>
<dd>
<span><a href="../../../javax/management/modelmbean/RequiredModelMBean.html" title="javax.management.modelmbean中的类">RequiredModelMBean</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">ModelMBeanNotificationBroadcaster</span>
extends <a href="../../../javax/management/NotificationBroadcaster.html" title="interface in javax.management">NotificationBroadcaster</a></pre>
<div class="block">
<span>该接口必须由ModelMBeans实现。</span>
<span>每个JMX代理必须随附此接口的实现。</span>
<p> <span>希望可管理的Java资源使用MBeanServer的createMBean方法实例化ModelMBean。</span> <span>资源然后设置ModelMBean实例的ModelMBeanInfo（带描述符）。</span> <span>通过ModelMBeanInfo为ModelMBean公开的属性和操作可以从MBean，连接器/适配器（如其他MBean）访问。</span> <span>通过ModelMBeanInfo描述符，可以将托管应用程序中的值和方法定义并映射到ModelMBean的属性和操作。</span> <span>该映射可以在XML格式化文件的开发过程中进行定义，也可以在运行时以动态和编程方式定义。</span> </p>
<p> <span>在MBeanServer中实例化的每个ModelMBean变得可管理：通过连接到该MBeanServer的连接器/适配器，其属性和操作可以远程访问。</span> <span>除非是符合JMX的MBean，否则不能在MBeanServer中注册Java对象。</span> <span>通过实例化一个ModelMBean，资源保证MBean有效。</span> </p>
<p> <span>必须在每个公共方法上抛出MBeanException和RuntimeOperationsException。</span> <span>这允许从分布式通信（RMI，EJB等）中包装异常。</span> <span>除了在规范和javadoc中描述的场景之外，这些异常不必由实现抛出。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
1.5
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/modelmbean/ModelMBeanNotificationBroadcaster.html#addAttributeChangeNotificationListener-javax.management.NotificationListener-java.lang.String-java.lang.Object-">addAttributeChangeNotificationListener</a></span>(<a href="../../../javax/management/NotificationListener.html" title="interface in javax.management">NotificationListener</a> listener, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> attributeName, <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> handback)</code>
<div class="block">
注册一个实现NotificationListener接口的对象作为监听器。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/modelmbean/ModelMBeanNotificationBroadcaster.html#removeAttributeChangeNotificationListener-javax.management.NotificationListener-java.lang.String-">removeAttributeChangeNotificationListener</a></span>(<a href="../../../javax/management/NotificationListener.html" title="interface in javax.management">NotificationListener</a> listener, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> attributeName)</code>
<div class="block">
从RequiredModelMBean中删除attributeChangeNotifications的侦听器。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/modelmbean/ModelMBeanNotificationBroadcaster.html#sendAttributeChangeNotification-javax.management.Attribute-javax.management.Attribute-">sendAttributeChangeNotification</a></span>(<a href="../../../javax/management/Attribute.html" title="class in javax.management">Attribute</a> oldValue, <a href="../../../javax/management/Attribute.html" title="class in javax.management">Attribute</a> newValue)</code>
<div class="block">
发送一个attributeChangeNotification，其中包含该属性的旧值和新值到ModelMBean上注册的AttributeChangeNotification侦听器。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/modelmbean/ModelMBeanNotificationBroadcaster.html#sendAttributeChangeNotification-javax.management.AttributeChangeNotification-">sendAttributeChangeNotification</a></span>(<a href="../../../javax/management/AttributeChangeNotification.html" title="class in javax.management">AttributeChangeNotification</a> notification)</code>
<div class="block">
发送一个attributeChangeNotification，该属性传递给ModelMBean上注册的attributeChangeNotification侦听器。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/modelmbean/ModelMBeanNotificationBroadcaster.html#sendNotification-javax.management.Notification-">sendNotification</a></span>(<a href="../../../javax/management/Notification.html" title="class in javax.management">Notification</a> ntfyObj)</code>
<div class="block">
发送通知，该通知将作为jmx.modelmbean.generic通知传递给ModelMBean上的注册通知侦听器。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/modelmbean/ModelMBeanNotificationBroadcaster.html#sendNotification-java.lang.String-">sendNotification</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> ntfyText)</code>
<div class="block">
发送一个通知，其中包含传递给ModelMBean上注册的通知侦听器的文本字符串。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.management.NotificationBroadcaster">
<!-- --> </a> <h3>Methods inherited from interface javax.management.<a href="../../../javax/management/NotificationBroadcaster.html" title="interface in javax.management">NotificationBroadcaster</a></h3> <code><a href="../../../javax/management/NotificationBroadcaster.html#addNotificationListener-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-">addNotificationListener</a>, <a href="../../../javax/management/NotificationBroadcaster.html#getNotificationInfo--">getNotificationInfo</a>, <a href="../../../javax/management/NotificationBroadcaster.html#removeNotificationListener-javax.management.NotificationListener-">removeNotificationListener</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="sendNotification-javax.management.Notification-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>sendNotification</h4> <pre>void sendNotification(<a href="../../../javax/management/Notification.html" title="class in javax.management">Notification</a> ntfyObj)
throws <a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
<a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></pre>
<div class="block">
发送通知，该通知将作为jmx.modelmbean.generic通知传递给ModelMBean上的注册通知侦听器。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>ntfyObj</code> - 要传递给侦听器对象的“handleNotification”方法的通知。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - 包装分布式通信异常。
</dd>
<dd>
<code><a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 包裹一个IllegalArgumentException：在参数中传递的Notification对象为null。
</dd>
</dl> </li>
</ul> <a name="sendNotification-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>sendNotification</h4> <pre>void sendNotification(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> ntfyText)
throws <a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
<a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></pre>
<div class="block">
发送一个通知，其中包含传递给ModelMBean上注册的通知侦听器的文本字符串。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>ntfyText</code> - 将通知中传递给侦听器对象的“handleNotification”方法的文本。</span>
<span>构造的通知将是：键入“jmx.modelmbean.generic”源此ModelMBean实例序列1</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - 包裹分布式通信异常。
</dd>
<dd>
<code><a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 包裹一个IllegalArgumentException：参数中传递的Notification文本字符串为null。
</dd>
</dl> </li>
</ul> <a name="sendAttributeChangeNotification-javax.management.AttributeChangeNotification-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>sendAttributeChangeNotification</h4> <pre>void sendAttributeChangeNotification(<a href="../../../javax/management/AttributeChangeNotification.html" title="class in javax.management">AttributeChangeNotification</a> notification)
throws <a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
<a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></pre>
<div class="block">
发送一个attributeChangeNotification，该属性传递给ModelMBean上注册的attributeChangeNotification侦听器。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>notification</code> - 要传递给侦听器对象的“handleNotification”方法的通知。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - 包裹分布式通信异常。
</dd>
<dd>
<code><a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 包裹一个IllegalArgumentException：参数中传递的AttributeChangeNotification对象为null。
</dd>
</dl> </li>
</ul> <a name="sendAttributeChangeNotification-javax.management.Attribute-javax.management.Attribute-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>sendAttributeChangeNotification</h4> <pre>void sendAttributeChangeNotification(<a href="../../../javax/management/Attribute.html" title="class in javax.management">Attribute</a> oldValue,
<a href="../../../javax/management/Attribute.html" title="class in javax.management">Attribute</a> newValue)
throws <a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
<a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></pre>
<div class="block">
发送一个attributeChangeNotification，其中包含该属性的旧值和新值到ModelMBean上注册的AttributeChangeNotification侦听器。
<p></p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>oldValue</code> -
<code>oldValue</code>的原始值
</dd>
<dd>
<span><code>newValue</code> - <code>newValue</code>的当前值</span>
<pre> <span>The constructed attributeChangeNotification will be:
type "jmx.attribute.change"
source this ModelMBean instance
sequence 1
attributeName oldValue.getName()
attributeType oldValue's class
attributeOldValue oldValue.getValue()
attributeNewValue newValue.getValue()</span> </pre>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - 包装分布式通信异常。
</dd>
<dd>
<code><a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 包裹一个IllegalArgumentException：在参数中传递的属性对象为null或参数中两个Attribute对象的名称不相同。
</dd>
</dl> </li>
</ul> <a name="addAttributeChangeNotificationListener-javax.management.NotificationListener-java.lang.String-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addAttributeChangeNotificationListener</h4> <pre>void addAttributeChangeNotificationListener(<a href="../../../javax/management/NotificationListener.html" title="interface in javax.management">NotificationListener</a> listener,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> attributeName,
<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> handback)
throws <a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
<a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a>,
<a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></pre>
<div class="block">
<span>注册一个实现NotificationListener接口的对象作为监听器。</span>
<span>当通过或通过ModelMBean发出任何attributeChangeNotification时，将调用此对象的'handleNotification（）'方法。</span>
<span>这不包括其他通知。</span>
<span>他们必须独立注册。</span>
<span>将为此attributeName生成AttributeChangeNotification。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>listener</code> - 将处理由注册的MBean发出的通知的侦听器对象。
</dd>
<dd>
<span><code>attributeName</code> - 要接收更改通知的ModelMBean属性的名称。</span>
<span>如果为null，则所有属性更改将导致发出attributeChangeNotification。</span>
</dd>
<dd>
<code>handback</code> - 发出通知时发送给侦听器的上下文通知。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 侦听器不能为空。
</dd>
<dd>
<code><a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - 包装分布式通信异常。
</dd>
<dd>
<code><a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 包裹一个IllegalArgumentException参数中传递的属性名称不存在。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/management/modelmbean/ModelMBeanNotificationBroadcaster.html#removeAttributeChangeNotificationListener-javax.management.NotificationListener-java.lang.String-"><code>removeAttributeChangeNotificationListener(javax.management.NotificationListener, java.lang.String)</code></a>
</dd>
</dl> </li>
</ul> <a name="removeAttributeChangeNotificationListener-javax.management.NotificationListener-java.lang.String-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>removeAttributeChangeNotificationListener</h4> <pre>void removeAttributeChangeNotificationListener(<a href="../../../javax/management/NotificationListener.html" title="interface in javax.management">NotificationListener</a> listener,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> attributeName)
throws <a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
<a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a>,
<a href="../../../javax/management/ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</a></pre>
<div class="block">
从RequiredModelMBean中删除attributeChangeNotifications的侦听器。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>listener</code> - 处理注册MBean发出的通知的侦听器名称。</span>
<span>此方法将删除与此侦听器相关的所有信息。</span>
</dd>
<dd>
<span><code>attributeName</code> - 侦听器不再需要接收attributeChangeNotifications的属性。</span>
<span>如果为null，则将为所有attributeChangeNotifications移除侦听器。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/management/ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</a></code> - 监听器未在MBean中注册或为空。
</dd>
<dd>
<code><a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - 包裹分布式通信异常。
</dd>
<dd>
<code><a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 包裹一个IllegalArgumentException如果inAttributeName参数与属性名称不对应。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/management/modelmbean/ModelMBeanNotificationBroadcaster.html#addAttributeChangeNotificationListener-javax.management.NotificationListener-java.lang.String-java.lang.Object-"><code>addAttributeChangeNotificationListener(javax.management.NotificationListener, java.lang.String, java.lang.Object)</code></a>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>
Reference in New Issue View Git Blame Copy Permalink