study/uTools-Manuals
1
0
Fork 0
mirror of https://github.com/fofolee/uTools-Manuals.git synced 2025-07-05 08:12:43 +08:00
Code Issues Packages Projects Releases Wiki Activity
uTools-Manuals/docs/java/javax/management/MBeanServerConnection.html

1556 lines
102 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
</div>
<h2 class="title" title="Interface MBeanServerConnection">Interface MBeanServerConnection</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Known Subinterfaces:
</dt>
<dd>
<span><a href="../../javax/management/MBeanServer.html" title="javax.management中的接口">MBeanServer</a> ， <a href="../../javax/management/remote/MBeanServerForwarder.html" title="javax.management.remote中的接口">MBeanServerForwarder</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">MBeanServerConnection</span></pre>
<div class="block">
<span>此接口表示与MBean服务器通信的方式，无论是本地还是远程。</span>
<span><a href="../../javax/management/MBeanServer.html" title="javax.management中的接口">代表</a>本地MBean服务器的<a href="../../javax/management/MBeanServer.html" title="javax.management中的接口"><code>MBeanServer</code></a>接口扩展了此接口。</span>
</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/MBeanServerConnection.html#addNotificationListener-javax.management.ObjectName-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-">addNotificationListener</a></span>(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name, <a href="../../javax/management/NotificationListener.html" title="interface in javax.management">NotificationListener</a> listener, <a href="../../javax/management/NotificationFilter.html" title="interface in javax.management">NotificationFilter</a> filter, <a href="../../java/lang/Object.html" title="class in java.lang">Object</a> handback)</code>
<div class="block">
将一个监听器添加到注册的MBean。
</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/MBeanServerConnection.html#addNotificationListener-javax.management.ObjectName-javax.management.ObjectName-javax.management.NotificationFilter-java.lang.Object-">addNotificationListener</a></span>(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name, <a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> listener, <a href="../../javax/management/NotificationFilter.html" title="interface in javax.management">NotificationFilter</a> filter, <a href="../../java/lang/Object.html" title="class in java.lang">Object</a> handback)</code>
<div class="block">
将一个监听器添加到注册的MBean。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../javax/management/ObjectInstance.html" title="class in javax.management">ObjectInstance</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#createMBean-java.lang.String-javax.management.ObjectName-">createMBean</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> className, <a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name)</code>
<div class="block">
在MBean服务器中实例化并注册一个MBean。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../javax/management/ObjectInstance.html" title="class in javax.management">ObjectInstance</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#createMBean-java.lang.String-javax.management.ObjectName-java.lang.Object:A-java.lang.String:A-">createMBean</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> className, <a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name, <a href="../../java/lang/Object.html" title="class in java.lang">Object</a>[] params, <a href="../../java/lang/String.html" title="class in java.lang">String</a>[] signature)</code>
<div class="block">
在MBean服务器中实例化并注册一个MBean。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../javax/management/ObjectInstance.html" title="class in javax.management">ObjectInstance</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#createMBean-java.lang.String-javax.management.ObjectName-javax.management.ObjectName-">createMBean</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> className, <a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name, <a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> loaderName)</code>
<div class="block">
在MBean服务器中实例化并注册一个MBean。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code><a href="../../javax/management/ObjectInstance.html" title="class in javax.management">ObjectInstance</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#createMBean-java.lang.String-javax.management.ObjectName-javax.management.ObjectName-java.lang.Object:A-java.lang.String:A-">createMBean</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> className, <a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name, <a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> loaderName, <a href="../../java/lang/Object.html" title="class in java.lang">Object</a>[] params, <a href="../../java/lang/String.html" title="class in java.lang">String</a>[] signature)</code>
<div class="block">
在MBean服务器中实例化并注册一个MBean。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code><a href="../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#getAttribute-javax.management.ObjectName-java.lang.String-">getAttribute</a></span>(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name, <a href="../../java/lang/String.html" title="class in java.lang">String</a> attribute)</code>
<div class="block">
获取命名MBean的特定属性的值。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code><a href="../../javax/management/AttributeList.html" title="class in javax.management">AttributeList</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#getAttributes-javax.management.ObjectName-java.lang.String:A-">getAttributes</a></span>(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name, <a href="../../java/lang/String.html" title="class in java.lang">String</a>[] attributes)</code>
<div class="block">
检索命名MBean的几个属性的值。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code><a href="../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#getDefaultDomain--">getDefaultDomain</a></span>()</code>
<div class="block">
返回用于命名MBean的默认域。
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code><a href="../../java/lang/String.html" title="class in java.lang">String</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#getDomains--">getDomains</a></span>()</code>
<div class="block">
返回任何MBean当前注册的域列表。
</div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code><a href="../../java/lang/Integer.html" title="class in java.lang">Integer</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#getMBeanCount--">getMBeanCount</a></span>()</code>
<div class="block">
返回在MBean服务器中注册的MBeans数。
</div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code><a href="../../javax/management/MBeanInfo.html" title="class in javax.management">MBeanInfo</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#getMBeanInfo-javax.management.ObjectName-">getMBeanInfo</a></span>(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name)</code>
<div class="block">
此方法可以发现MBean公开管理的属性和操作。
</div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code><a href="../../javax/management/ObjectInstance.html" title="class in javax.management">ObjectInstance</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#getObjectInstance-javax.management.ObjectName-">getObjectInstance</a></span>(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name)</code>
<div class="block">
获取
<code>ObjectInstance</code>与MBean服务器注册的给定MBean。
</div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code><a href="../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#invoke-javax.management.ObjectName-java.lang.String-java.lang.Object:A-java.lang.String:A-">invoke</a></span>(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name, <a href="../../java/lang/String.html" title="class in java.lang">String</a> operationName, <a href="../../java/lang/Object.html" title="class in java.lang">Object</a>[] params, <a href="../../java/lang/String.html" title="class in java.lang">String</a>[] signature)</code>
<div class="block">
调用MBean上的操作。
</div> </td>
</tr>
<tr class="altColor" id="i14">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#isInstanceOf-javax.management.ObjectName-java.lang.String-">isInstanceOf</a></span>(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name, <a href="../../java/lang/String.html" title="class in java.lang">String</a> className)</code>
<div class="block">
如果指定的MBean是指定类的实例，则返回true，否则返回false。
</div> </td>
</tr>
<tr class="rowColor" id="i15">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#isRegistered-javax.management.ObjectName-">isRegistered</a></span>(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name)</code>
<div class="block">
检查由其对象名称标识的MBean是否已经向MBean服务器注册。
</div> </td>
</tr>
<tr class="altColor" id="i16">
<td class="colFirst"><code><a href="../../java/util/Set.html" title="interface in java.util">Set</a>&lt;<a href="../../javax/management/ObjectInstance.html" title="class in javax.management">ObjectInstance</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#queryMBeans-javax.management.ObjectName-javax.management.QueryExp-">queryMBeans</a></span>(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name, <a href="../../javax/management/QueryExp.html" title="interface in javax.management">QueryExp</a> query)</code>
<div class="block">
获取由MBean服务器控制的MBean。
</div> </td>
</tr>
<tr class="rowColor" id="i17">
<td class="colFirst"><code><a href="../../java/util/Set.html" title="interface in java.util">Set</a>&lt;<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#queryNames-javax.management.ObjectName-javax.management.QueryExp-">queryNames</a></span>(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name, <a href="../../javax/management/QueryExp.html" title="interface in javax.management">QueryExp</a> query)</code>
<div class="block">
获取由MBean服务器控制的MBean的名称。
</div> </td>
</tr>
<tr class="altColor" id="i18">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#removeNotificationListener-javax.management.ObjectName-javax.management.NotificationListener-">removeNotificationListener</a></span>(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name, <a href="../../javax/management/NotificationListener.html" title="interface in javax.management">NotificationListener</a> listener)</code>
<div class="block">
从注册的MBean中删除一个监听器。
</div> </td>
</tr>
<tr class="rowColor" id="i19">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#removeNotificationListener-javax.management.ObjectName-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-">removeNotificationListener</a></span>(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name, <a href="../../javax/management/NotificationListener.html" title="interface in javax.management">NotificationListener</a> listener, <a href="../../javax/management/NotificationFilter.html" title="interface in javax.management">NotificationFilter</a> filter, <a href="../../java/lang/Object.html" title="class in java.lang">Object</a> handback)</code>
<div class="block">
从注册的MBean中删除一个监听器。
</div> </td>
</tr>
<tr class="altColor" id="i20">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#removeNotificationListener-javax.management.ObjectName-javax.management.ObjectName-">removeNotificationListener</a></span>(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name, <a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> listener)</code>
<div class="block">
从注册的MBean中删除一个监听器。
</div> </td>
</tr>
<tr class="rowColor" id="i21">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#removeNotificationListener-javax.management.ObjectName-javax.management.ObjectName-javax.management.NotificationFilter-java.lang.Object-">removeNotificationListener</a></span>(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name, <a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> listener, <a href="../../javax/management/NotificationFilter.html" title="interface in javax.management">NotificationFilter</a> filter, <a href="../../java/lang/Object.html" title="class in java.lang">Object</a> handback)</code>
<div class="block">
从注册的MBean中删除一个监听器。
</div> </td>
</tr>
<tr class="altColor" id="i22">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#setAttribute-javax.management.ObjectName-javax.management.Attribute-">setAttribute</a></span>(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name, <a href="../../javax/management/Attribute.html" title="class in javax.management">Attribute</a> attribute)</code>
<div class="block">
设置命名MBean的特定属性的值。
</div> </td>
</tr>
<tr class="rowColor" id="i23">
<td class="colFirst"><code><a href="../../javax/management/AttributeList.html" title="class in javax.management">AttributeList</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#setAttributes-javax.management.ObjectName-javax.management.AttributeList-">setAttributes</a></span>(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name, <a href="../../javax/management/AttributeList.html" title="class in javax.management">AttributeList</a> attributes)</code>
<div class="block">
设置一个命名MBean的几个属性的值。
</div> </td>
</tr>
<tr class="altColor" id="i24">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanServerConnection.html#unregisterMBean-javax.management.ObjectName-">unregisterMBean</a></span>(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name)</code>
<div class="block">
从MBean服务器取消注册MBean。
</div> </td>
</tr>
</tbody>
</table> </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="createMBean-java.lang.String-javax.management.ObjectName-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createMBean</h4> <pre><a href="../../javax/management/ObjectInstance.html" title="class in javax.management">ObjectInstance</a> createMBean(<a href="../../java/lang/String.html" title="class in java.lang">String</a> className,
<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name)
throws <a href="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</a>,
<a href="../../javax/management/InstanceAlreadyExistsException.html" title="class in javax.management">InstanceAlreadyExistsException</a>,
<a href="../../javax/management/MBeanRegistrationException.html" title="class in javax.management">MBeanRegistrationException</a>,
<a href="../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
<a href="../../javax/management/NotCompliantMBeanException.html" title="class in javax.management">NotCompliantMBeanException</a>,
<a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<p> <span>在MBean服务器中实例化并注册一个MBean。</span> <span>MBean服务器将使用它的<a href="../../javax/management/loading/ClassLoaderRepository.html" title="javax.management.loading中的接口"><code>Default Loader Repository</code></a>加载MBean的类。</span> <span>对象名称与MBean相关联。</span> <span>如果给定的对象名称为空，则MBean必须通过实现<a href="../../javax/management/MBeanRegistration.html" title="javax.management中的接口"><code>MBeanRegistration</code></a>接口并从<a href="../../javax/management/MBeanRegistration.html#preRegister-javax.management.MBeanServer-javax.management.ObjectName-"><code>preRegister</code></a>方法返回名称来提供自己的名称。</span> </p>
<p> <span>此方法相当于<a href="../../javax/management/MBeanServerConnection.html#createMBean-java.lang.String-javax.management.ObjectName-java.lang.Object:A-java.lang.String:A-"><code>createMBean(className, name, (Object[]) null, (String[]) null)</code></a> 。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>className</code> - 要实例化的MBean的类名。
</dd>
<dd>
<span><code>name</code> - MBean的对象名称。</span>
<span>可能为null。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>一个<code>ObjectInstance</code> ，包含<code>ObjectName</code>和新实例化的MBean的Java类名。</span>
<span>如果包含的<code>ObjectName</code>是<code>n</code> ，则包含的Java类名称为<code><a href="../../javax/management/MBeanServerConnection.html#getMBeanInfo-javax.management.ObjectName-"><code>getMBeanInfo(n)</code></a>.getClassName()</code> 。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</a></code> - 包裹一个
<code>java.lang.ClassNotFoundException</code>或
<code>java.lang.Exception</code> ，当尝试调用MBean的构造函数时。
</dd>
<dd>
<code><a href="../../javax/management/InstanceAlreadyExistsException.html" title="class in javax.management">InstanceAlreadyExistsException</a></code> - MBean已经在MBean服务器的控制之下了。
</dd>
<dd>
<span><code><a href="../../javax/management/MBeanRegistrationException.html" title="class in javax.management">MBeanRegistrationException</a></code> - MBean的<code>preRegister</code> （ <code>MBeanRegistration</code>接口）方法已经抛出异常。</span>
<span>MBean将不会被注册。</span>
</dd>
<dd>
<span><code><a href="../../javax/management/RuntimeMBeanException.html" title="class in javax.management">RuntimeMBeanException</a></code> - 如果MBean的构造函数或其<code>preRegister</code>或<code>postRegister</code>方法抛出一个<code>RuntimeException</code> 。</span>
<span>如果<code>postRegister</code> （ <code>MBeanRegistration</code>的MBean的接口）方法抛出<code>RuntimeException</code> ，所述<code>createMBean</code>方法将抛出<code>RuntimeMBeanException</code> ，虽然该MBean创建和注册成功了。</span>
<span>在这种情况下，即使<code>createMBean</code>方法抛出异常，MBean也会实际注册。</span>
<span>请注意， <code>RuntimeMBeanException</code>也可以抛出<code>preRegister</code> ，在这种情况下，MBean将不会被注册。</span>
</dd>
<dd>
<span><code><a href="../../javax/management/RuntimeErrorException.html" title="class in javax.management">RuntimeErrorException</a></code> -如果<code>postRegister</code> （ <code>MBeanRegistration</code>的MBean的接口）方法抛出<code>Error</code> ，所述<code>createMBean</code>方法将抛出<code>RuntimeErrorException</code> ，虽然该MBean创建和注册成功了。</span>
<span>在这种情况下，即使<code>createMBean</code>方法抛出异常，MBean也会实际注册。</span>
<span>请注意， <code>RuntimeErrorException</code>也可以被<code>preRegister</code>抛出，在这种情况下MBean将不会被注册。</span>
</dd>
<dd>
<code><a href="../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - MBean的构造函数抛出异常
</dd>
<dd>
<code><a href="../../javax/management/NotCompliantMBeanException.html" title="class in javax.management">NotCompliantMBeanException</a></code> - 此类不是符合JMX的MBean
</dd>
<dd>
<code><a href="../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> -包装一个
<code>java.lang.IllegalArgumentException</code> ：通过className传入参数是空值，则
<code>ObjectName</code>传入的参数包含一个图案或没有
<code>ObjectName</code>被为MBean指定。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通信时发生通信问题。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../javax/management/MBeanRegistration.html" title="javax.management中的接口"><code>MBeanRegistration</code></a></span>
</dd>
</dl> </li>
</ul> <a name="createMBean-java.lang.String-javax.management.ObjectName-javax.management.ObjectName-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createMBean</h4> <pre><a href="../../javax/management/ObjectInstance.html" title="class in javax.management">ObjectInstance</a> createMBean(<a href="../../java/lang/String.html" title="class in java.lang">String</a> className,
<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name,
<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> loaderName)
throws <a href="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</a>,
<a href="../../javax/management/InstanceAlreadyExistsException.html" title="class in javax.management">InstanceAlreadyExistsException</a>,
<a href="../../javax/management/MBeanRegistrationException.html" title="class in javax.management">MBeanRegistrationException</a>,
<a href="../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
<a href="../../javax/management/NotCompliantMBeanException.html" title="class in javax.management">NotCompliantMBeanException</a>,
<a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a>,
<a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<p> <span>在MBean服务器中实例化并注册一个MBean。</span> <span>要使用的类加载器由其对象名称标识。</span> <span>对象名称与MBean相关联。</span> <span>如果加载器的对象名称为空，则将使用加载MBean服务器的ClassLoader。</span> <span>如果给出的MBean对象名称为空，则MBean必须通过实现<a href="../../javax/management/MBeanRegistration.html" title="javax.management中的接口"><code>MBeanRegistration</code></a>接口并从<a href="../../javax/management/MBeanRegistration.html#preRegister-javax.management.MBeanServer-javax.management.ObjectName-"><code>preRegister</code></a>方法返回名称来提供自己的名称。</span> </p>
<p> <span>这个方法相当于<a href="../../javax/management/MBeanServerConnection.html#createMBean-java.lang.String-javax.management.ObjectName-javax.management.ObjectName-java.lang.Object:A-java.lang.String:A-"><code>createMBean(className, name, loaderName, (Object[]) null, (String[]) null)</code></a> 。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>className</code> - 要实例化的MBean的类名。
</dd>
<dd>
<span><code>name</code> - MBean的对象名称。</span>
<span>可能为null。</span>
</dd>
<dd>
<code>loaderName</code> - 要使用的类加载器的对象名。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>一个<code>ObjectInstance</code> ，其中包含<code>ObjectName</code>和新实例化的MBean的Java类名。</span>
<span>如果包含的<code>ObjectName</code>是<code>n</code> ，则包含的Java类名称为<code><a href="../../javax/management/MBeanServerConnection.html#getMBeanInfo-javax.management.ObjectName-"><code>getMBeanInfo(n)</code></a>.getClassName()</code> 。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</a></code> - 包裹一个
<code>java.lang.ClassNotFoundException</code>或
<code>java.lang.Exception</code> ，当尝试调用MBean的构造函数时发生。
</dd>
<dd>
<code><a href="../../javax/management/InstanceAlreadyExistsException.html" title="class in javax.management">InstanceAlreadyExistsException</a></code> - MBean已经在MBean服务器的控制之下。
</dd>
<dd>
<span><code><a href="../../javax/management/MBeanRegistrationException.html" title="class in javax.management">MBeanRegistrationException</a></code> - MBean的<code>preRegister</code> （ <code>MBeanRegistration</code>接口）方法已经抛出异常。</span>
<span>MBean将不会被注册。</span>
</dd>
<dd>
<span><code><a href="../../javax/management/RuntimeMBeanException.html" title="class in javax.management">RuntimeMBeanException</a></code> - 如果MBean的构造函数或其<code>preRegister</code>或<code>postRegister</code>方法抛出一个<code>RuntimeException</code> 。</span>
<span>如果<code>postRegister</code> （ <code>MBeanRegistration</code>的MBean的接口）方法抛出<code>RuntimeException</code> ，所述<code>createMBean</code>方法将抛出<code>RuntimeMBeanException</code> ，虽然该MBean创建和注册成功了。</span>
<span>在这种情况下，即使<code>createMBean</code>方法抛出异常，MBean也将实际注册。</span>
<span>请注意， <code>RuntimeMBeanException</code>也可以由<code>preRegister</code>抛出，在这种情况下，MBean将不会被注册。</span>
</dd>
<dd>
<span><code><a href="../../javax/management/RuntimeErrorException.html" title="class in javax.management">RuntimeErrorException</a></code> -如果<code>postRegister</code> （ <code>MBeanRegistration</code>的MBean的接口）方法抛出<code>Error</code> ，所述<code>createMBean</code>方法将抛出<code>RuntimeErrorException</code> ，虽然该MBean创建和注册成功了。</span>
<span>在这种情况下，即使<code>createMBean</code>方法抛出异常，MBean也将实际注册。</span>
<span>请注意， <code>RuntimeErrorException</code>也可以被<code>preRegister</code>抛出，在这种情况下MBean将不会被注册。</span>
</dd>
<dd>
<code><a href="../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - MBean的构造函数已抛出异常
</dd>
<dd>
<code><a href="../../javax/management/NotCompliantMBeanException.html" title="class in javax.management">NotCompliantMBeanException</a></code> - 此类不是符合JMX的MBean
</dd>
<dd>
<code><a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a></code> - 指定的类加载器未在MBean服务器中注册。
</dd>
<dd>
<code><a href="../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> -包装一个
<code>java.lang.IllegalArgumentException</code> ：通过className传入参数是空值，则
<code>ObjectName</code>传入的参数包含一个图案或没有
<code>ObjectName</code>被为MBean指定。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通话时发生通信问题。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../javax/management/MBeanRegistration.html" title="javax.management中的接口"><code>MBeanRegistration</code></a></span>
</dd>
</dl> </li>
</ul> <a name="createMBean-java.lang.String-javax.management.ObjectName-java.lang.Object:A-java.lang.String:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createMBean</h4> <pre><a href="../../javax/management/ObjectInstance.html" title="class in javax.management">ObjectInstance</a> createMBean(<a href="../../java/lang/String.html" title="class in java.lang">String</a> className,
<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name,
<a href="../../java/lang/Object.html" title="class in java.lang">Object</a>[] params,
<a href="../../java/lang/String.html" title="class in java.lang">String</a>[] signature)
throws <a href="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</a>,
<a href="../../javax/management/InstanceAlreadyExistsException.html" title="class in javax.management">InstanceAlreadyExistsException</a>,
<a href="../../javax/management/MBeanRegistrationException.html" title="class in javax.management">MBeanRegistrationException</a>,
<a href="../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
<a href="../../javax/management/NotCompliantMBeanException.html" title="class in javax.management">NotCompliantMBeanException</a>,
<a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>在MBean服务器中实例化并注册一个MBean。</span>
<span>MBean服务器将使用其<a href="../../javax/management/loading/ClassLoaderRepository.html" title="javax.management.loading中的接口"><code>Default Loader Repository</code></a>加载MBean的类。</span>
<span>对象名称与MBean相关联。</span>
<span>如果给定的对象名称为空，则MBean必须通过实现<a href="../../javax/management/MBeanRegistration.html" title="javax.management中的接口"><code>MBeanRegistration</code></a>接口并从<a href="../../javax/management/MBeanRegistration.html#preRegister-javax.management.MBeanServer-javax.management.ObjectName-"><code>preRegister</code></a>方法返回名称来提供自己的名称。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>className</code> - 要实例化的MBean的类名。
</dd>
<dd>
<span><code>name</code> - MBean的对象名称。</span>
<span>可能为null。</span>
</dd>
<dd>
<code>params</code> - 包含要调用的构造函数的参数的数组。
</dd>
<dd>
<code>signature</code> - 包含要调用的构造函数的签名的数组。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>一个<code>ObjectInstance</code> ，包含<code>ObjectName</code>和新实例化的MBean的Java类名。</span>
<span>如果包含的<code>ObjectName</code>是<code>n</code> ，则包含的Java类名称为<code><a href="../../javax/management/MBeanServerConnection.html#getMBeanInfo-javax.management.ObjectName-"><code>getMBeanInfo(n)</code></a>.getClassName()</code> 。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</a></code> - 包裹一个
<code>java.lang.ClassNotFoundException</code>或
<code>java.lang.Exception</code>在尝试调用MBean的构造函数时发生。
</dd>
<dd>
<code><a href="../../javax/management/InstanceAlreadyExistsException.html" title="class in javax.management">InstanceAlreadyExistsException</a></code> - MBean已经在MBean服务器的控制之下。
</dd>
<dd>
<span><code><a href="../../javax/management/MBeanRegistrationException.html" title="class in javax.management">MBeanRegistrationException</a></code> - MBean的<code>preRegister</code> （ <code>MBeanRegistration</code>接口）方法已抛出异常。</span>
<span>MBean将不会被注册。</span>
</dd>
<dd>
<span><code><a href="../../javax/management/RuntimeMBeanException.html" title="class in javax.management">RuntimeMBeanException</a></code> - 如果MBean的构造函数或其<code>preRegister</code>或<code>postRegister</code>方法抛出一个<code>RuntimeException</code> 。</span>
<span>如果MBean的<code>postRegister</code> （ <code>MBeanRegistration</code>接口）方法抛出一个<code>RuntimeException</code> ，则<code>createMBean</code>方法将抛出一个<code>RuntimeMBeanException</code> ，尽管MBean的创建和注册成功。</span>
<span>在这种情况下，即使<code>createMBean</code>方法抛出异常，MBean也将实际注册。</span>
<span>请注意， <code>RuntimeMBeanException</code>也可以被<code>preRegister</code>抛出，在这种情况下，MBean将不会被注册。</span>
</dd>
<dd>
<span><code><a href="../../javax/management/RuntimeErrorException.html" title="class in javax.management">RuntimeErrorException</a></code> -如果<code>postRegister</code> （ <code>MBeanRegistration</code>的MBean的接口）方法抛出<code>Error</code> ，所述<code>createMBean</code>方法将抛出<code>RuntimeErrorException</code> ，虽然该MBean创建和注册成功了。</span>
<span>在这种情况下，即使<code>createMBean</code>方法抛出异常，MBean也会实际注册。</span>
<span>请注意， <code>RuntimeErrorException</code>也可以由<code>preRegister</code>抛出，在这种情况下MBean将不会被注册。</span>
</dd>
<dd>
<code><a href="../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - MBean的构造函数抛出异常
</dd>
<dd>
<code><a href="../../javax/management/NotCompliantMBeanException.html" title="class in javax.management">NotCompliantMBeanException</a></code> - 此类不是符合JMX的MBean
</dd>
<dd>
<code><a href="../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> -包装一个
<code>java.lang.IllegalArgumentException</code> ：通过className传入参数是空值，则
<code>ObjectName</code>传入的参数包含一个图案或没有
<code>ObjectName</code>被为MBean指定。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通话时发生通信问题。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../javax/management/MBeanRegistration.html" title="javax.management中的接口"><code>MBeanRegistration</code></a></span>
</dd>
</dl> </li>
</ul> <a name="createMBean-java.lang.String-javax.management.ObjectName-javax.management.ObjectName-java.lang.Object:A-java.lang.String:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createMBean</h4> <pre><a href="../../javax/management/ObjectInstance.html" title="class in javax.management">ObjectInstance</a> createMBean(<a href="../../java/lang/String.html" title="class in java.lang">String</a> className,
<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name,
<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> loaderName,
<a href="../../java/lang/Object.html" title="class in java.lang">Object</a>[] params,
<a href="../../java/lang/String.html" title="class in java.lang">String</a>[] signature)
throws <a href="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</a>,
<a href="../../javax/management/InstanceAlreadyExistsException.html" title="class in javax.management">InstanceAlreadyExistsException</a>,
<a href="../../javax/management/MBeanRegistrationException.html" title="class in javax.management">MBeanRegistrationException</a>,
<a href="../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
<a href="../../javax/management/NotCompliantMBeanException.html" title="class in javax.management">NotCompliantMBeanException</a>,
<a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a>,
<a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<p> <span>在MBean服务器中实例化并注册一个MBean。</span> <span>要使用的类加载器由其对象名称标识。</span> <span>对象名称与MBean相关联。</span> <span>如果未指定加载程序的对象名称，则将使用加载MBean服务器的ClassLoader。</span> <span>如果给出的MBean对象名称为空，则MBean必须通过实现<a href="../../javax/management/MBeanRegistration.html" title="javax.management中的接口"><code>MBeanRegistration</code></a>接口并从<a href="../../javax/management/MBeanRegistration.html#preRegister-javax.management.MBeanServer-javax.management.ObjectName-"><code>preRegister</code></a>方法返回名称来提供自己的名称。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>className</code> - 要实例化的MBean的类名。
</dd>
<dd>
<span><code>name</code> - MBean的对象名称。</span>
<span>可能为null。</span>
</dd>
<dd>
<code>params</code> - 包含要调用的构造函数的参数的数组。
</dd>
<dd>
<code>signature</code> - 包含要调用的构造函数的签名的数组。
</dd>
<dd>
<code>loaderName</code> - 要使用的类加载器的对象名称。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>一个<code>ObjectInstance</code> ，包含<code>ObjectName</code>和新实例化的MBean的Java类名。</span>
<span>如果包含的<code>ObjectName</code>是<code>n</code> ，则包含的Java类名称为<code><a href="../../javax/management/MBeanServerConnection.html#getMBeanInfo-javax.management.ObjectName-"><code>getMBeanInfo(n)</code></a>.getClassName()</code> 。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</a></code> - 包装一个
<code>java.lang.ClassNotFoundException</code>或
<code>java.lang.Exception</code> ，当尝试调用MBean的构造函数时。
</dd>
<dd>
<code><a href="../../javax/management/InstanceAlreadyExistsException.html" title="class in javax.management">InstanceAlreadyExistsException</a></code> - MBean已经在MBean服务器的控制之下了。
</dd>
<dd>
<span><code><a href="../../javax/management/MBeanRegistrationException.html" title="class in javax.management">MBeanRegistrationException</a></code> - MBean的<code>preRegister</code> （ <code>MBeanRegistration</code>接口）方法已经抛出异常。</span>
<span>MBean将不会被注册。</span>
</dd>
<dd>
<span><code><a href="../../javax/management/RuntimeMBeanException.html" title="class in javax.management">RuntimeMBeanException</a></code> - MBean的构造函数或其<code>preRegister</code>或<code>postRegister</code>方法抛出一个<code>RuntimeException</code> 。</span>
<span>如果MBean的<code>postRegister</code> （ <code>MBeanRegistration</code>接口）方法抛出一个<code>RuntimeException</code> ，则<code>createMBean</code>方法将抛出一个<code>RuntimeMBeanException</code> ，尽管MBean的创建和注册成功。</span>
<span>在这种情况下，即使<code>createMBean</code>方法抛出异常，MBean也会实际注册。</span>
<span>请注意， <code>RuntimeMBeanException</code>也可以由<code>preRegister</code>抛出，在这种情况下MBean将不会被注册。</span>
</dd>
<dd>
<span><code><a href="../../javax/management/RuntimeErrorException.html" title="class in javax.management">RuntimeErrorException</a></code> -如果<code>postRegister</code>方法（ <code>MBeanRegistration</code>的MBean的接口）方法抛出<code>Error</code> ，所述<code>createMBean</code>方法将抛出<code>RuntimeErrorException</code> ，虽然该MBean创建和注册成功了。</span>
<span>在这种情况下，即使<code>createMBean</code>方法抛出异常，MBean也将实际注册。</span>
<span>请注意， <code>RuntimeErrorException</code>也可以由<code>preRegister</code>抛出，在这种情况下，MBean将不会被注册。</span>
</dd>
<dd>
<code><a href="../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - MBean的构造函数已抛出异常
</dd>
<dd>
<code><a href="../../javax/management/NotCompliantMBeanException.html" title="class in javax.management">NotCompliantMBeanException</a></code> - 此类不是符合JMX的MBean
</dd>
<dd>
<code><a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a></code> - 指定的类加载器未在MBean服务器中注册。
</dd>
<dd>
<code><a href="../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> -包装一个
<code>java.lang.IllegalArgumentException</code> ：通过className传入参数是空值，则
<code>ObjectName</code>传入的参数包含一个图案或没有
<code>ObjectName</code>被为MBean指定。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通信时发生通信问题。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../javax/management/MBeanRegistration.html" title="javax.management中的接口"><code>MBeanRegistration</code></a></span>
</dd>
</dl> </li>
</ul> <a name="unregisterMBean-javax.management.ObjectName-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>unregisterMBean</h4> <pre>void unregisterMBean(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name)
throws <a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a>,
<a href="../../javax/management/MBeanRegistrationException.html" title="class in javax.management">MBeanRegistrationException</a>,
<a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>从MBean服务器取消注册MBean。</span>
<span>MBean由其对象名称标识。</span>
<span>一旦方法被调用，MBean可能不再被其对象名称访问。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要注销的MBean的对象名称。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a></code> - MBean指定的MBean未在MBean服务器中注册。
</dd>
<dd>
<code><a href="../../javax/management/MBeanRegistrationException.html" title="class in javax.management">MBeanRegistrationException</a></code> - MBean的preDeregister（（
<code>MBeanRegistration</code>接口）方法已经抛出异常。
</dd>
<dd>
<span><code><a href="../../javax/management/RuntimeMBeanException.html" title="class in javax.management">RuntimeMBeanException</a></code> -如果<code>postDeregister</code> （ <code>MBeanRegistration</code>的MBean的接口）方法抛出一个<code>RuntimeException</code> ，该<code>unregisterMBean</code>方法将抛出<code>RuntimeMBeanException</code> ，虽然该MBean注销成功。</span>
<span>在这种情况下，即使<code>unregisterMBean</code>方法抛出异常，MBean实际上也将被注销。</span>
<span>请注意， <code>RuntimeMBeanException</code>也可以由<code>preDeregister</code>抛出，在这种情况下，MBean将保持注册。</span>
</dd>
<dd>
<span><code><a href="../../javax/management/RuntimeErrorException.html" title="class in javax.management">RuntimeErrorException</a></code> - 如果MBean的<code>postDeregister</code> （ <code>MBeanRegistration</code>接口）方法抛出<code>Error</code> ，则<code>unregisterMBean</code>方法将抛出一个<code>RuntimeErrorException</code> ，尽管MBean注销成功。</span>
<span>在这种情况下，即使<code>unregisterMBean</code>方法抛出异常，MBean实际上也将被注销。</span>
<span>请注意， <code>RuntimeMBeanException</code>也可以被<code>preDeregister</code>抛出，在这种情况下，MBean将保持注册。</span>
</dd>
<dd>
<span><code><a href="../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 包裹一个<code>java.lang.IllegalArgumentException</code> ：参数中的对象名称为null或尝试注销时的MBean是<a href="../../javax/management/MBeanServerDelegate.html" title="javax.management中的类"><code>MBeanServerDelegate</code></a> MBean。</span>
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通信时发生通信问题。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../javax/management/MBeanRegistration.html" title="javax.management中的接口"><code>MBeanRegistration</code></a></span>
</dd>
</dl> </li>
</ul> <a name="getObjectInstance-javax.management.ObjectName-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getObjectInstance</h4> <pre><a href="../../javax/management/ObjectInstance.html" title="class in javax.management">ObjectInstance</a> getObjectInstance(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name)
throws <a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a>,
<a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
获取在MBean服务器上
<code>ObjectInstance</code>的给定MBean的ObjectInstance。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - MBean的对象名称。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>该<code>ObjectInstance</code>与<var>name</var>指定的与MBean关联。</span>
<span>包含的<code>ObjectName</code>是<code>name</code> ，包含的类名是<code><a href="../../javax/management/MBeanServerConnection.html#getMBeanInfo-javax.management.ObjectName-"><code>getMBeanInfo(name)</code></a>.getClassName()</code> 。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a></code> - 指定的MBean未在MBean服务器中注册。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通信时发生通信问题。
</dd>
</dl> </li>
</ul> <a name="queryMBeans-javax.management.ObjectName-javax.management.QueryExp-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>queryMBeans</h4> <pre><a href="../../java/util/Set.html" title="interface in java.util">Set</a>&lt;<a href="../../javax/management/ObjectInstance.html" title="class in javax.management">ObjectInstance</a>&gt; queryMBeans(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name,
<a href="../../javax/management/QueryExp.html" title="interface in javax.management">QueryExp</a> query)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>获取由MBean服务器控制的MBean。</span>
<span>该方法允许获得以下任何一种：所有MBean， <code>ObjectName</code>和/或Query表达式上的模式匹配指定的一组MBean，一个特定的MBean。</span>
<span>当对象名称为空或没有指定域和键属性时，将选择所有对象（如果指定了查询，则过滤它们）。</span>
<span>它返回所选MBean的<code>ObjectInstance</code>对象（包含<code>ObjectName</code>和Java类名）的集合。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>name</code> - 标识要检索的MBean的对象名称模式。</span>
<span>如果指定了null或没有域和密钥属性，则将检索注册的所有MBean。</span>
</dd>
<dd>
<span><code>query</code> - 要应用于选择MBean的查询表达式。</span>
<span>如果null，则不会应用查询表达式来选择MBean。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>一组包含所选MBean的<code>ObjectInstance</code>对象。</span>
<span>如果没有MBean满足查询，则返回一个空列表。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通信时发生通信问题。
</dd>
</dl> </li>
</ul> <a name="queryNames-javax.management.ObjectName-javax.management.QueryExp-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>queryNames</h4> <pre><a href="../../java/util/Set.html" title="interface in java.util">Set</a>&lt;<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a>&gt; queryNames(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name,
<a href="../../javax/management/QueryExp.html" title="interface in javax.management">QueryExp</a> query)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>获取由MBean服务器控制的MBean的名称。</span>
<span>此方法可以获得以下任何一种：所有MBean的名称， <code>ObjectName</code>和/或Query表达式上的模式匹配指定的一组MBean的名称，特定的MBean名称（相当于测试MBean是否为注册）。</span>
<span>当对象名称为空或没有指定域和键属性时，将选择所有对象（如果指定了查询，则将其过滤）。</span>
<span>它返回所选MBean的一组ObjectNames。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>name</code> - 标识要检索的MBean名称的对象名称模式。</span>
<span>如果指定了null或没有域和键属性，将检索所有注册的MBean的名称。</span>
</dd>
<dd>
<span><code>query</code> - 要应用于选择MBean的查询表达式。</span>
<span>如果null，则不会应用查询表达式来选择MBean。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>包含所选MBean的ObjectName的集合。</span>
<span>如果没有MBean满足查询，则返回一个空列表。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通信时发生通信问题。
</dd>
</dl> </li>
</ul> <a name="isRegistered-javax.management.ObjectName-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isRegistered</h4> <pre>boolean isRegistered(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
检查由其对象名称标识的MBean是否已经向MBean服务器注册。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要检查的MBean的对象名称。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果MBean已经在MBean服务器中注册，则为true，否则为false。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 包装
<code>java.lang.IllegalArgumentException</code> ：参数中的对象名称为null。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通话时发生通信问题。
</dd>
</dl> </li>
</ul> <a name="getMBeanCount--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getMBeanCount</h4> <pre><a href="../../java/lang/Integer.html" title="class in java.lang">Integer</a> getMBeanCount()
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
返回在MBean服务器中注册的MBeans数。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
注册的MBean的数量。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通信时发生通信问题。
</dd>
</dl> </li>
</ul> <a name="getAttribute-javax.management.ObjectName-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttribute</h4> <pre><a href="../../java/lang/Object.html" title="class in java.lang">Object</a> getAttribute(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name,
<a href="../../java/lang/String.html" title="class in java.lang">String</a> attribute)
throws <a href="../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
<a href="../../javax/management/AttributeNotFoundException.html" title="class in javax.management">AttributeNotFoundException</a>,
<a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a>,
<a href="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</a>,
<a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>获取命名MBean的特定属性的值。</span>
<span>MBean由其对象名称标识。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> -
<code>name</code>属性的MBean的对象名称。
</dd>
<dd>
<code>attribute</code> - 指定要检索的属性名称的字符串。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
检索属性的值。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/management/AttributeNotFoundException.html" title="class in javax.management">AttributeNotFoundException</a></code> - 指定的属性在MBean中无法访问。
</dd>
<dd>
<code><a href="../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - 包装MBean的getter抛出的异常。
</dd>
<dd>
<code><a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a></code> - MBean指定的MBean未在MBean服务器中注册。
</dd>
<dd>
<code><a href="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</a></code> - 在尝试调用设置器时抛出一个
<code>java.lang.Exception</code> 。
</dd>
<dd>
<code><a href="../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 包裹一个
<code>java.lang.IllegalArgumentException</code> ：参数中的对象名称为null或参数中的属性为null。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通信时发生通信问题。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/management/MBeanServerConnection.html#setAttribute-javax.management.ObjectName-javax.management.Attribute-"><code>setAttribute(javax.management.ObjectName, javax.management.Attribute)</code></a>
</dd>
</dl> </li>
</ul> <a name="getAttributes-javax.management.ObjectName-java.lang.String:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttributes</h4> <pre><a href="../../javax/management/AttributeList.html" title="class in javax.management">AttributeList</a> getAttributes(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name,
<a href="../../java/lang/String.html" title="class in java.lang">String</a>[] attributes)
throws <a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a>,
<a href="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</a>,
<a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<p> <span>检索命名MBean的几个属性的值。</span> <span>MBean由其对象名称标识。</span> </p>
<p> <span>如果由于某种原因无法检索到一个或多个属性，则返回的<code>AttributeList</code>将被省略。</span> <span>调用者应该检查列表与<code>attributes</code>数组的大小相同。</span> <span>要发现什么问题被检索防止给定的属性，请拨打<a href="../../javax/management/MBeanServerConnection.html#getAttribute-javax.management.ObjectName-java.lang.String-"><code>getAttribute</code></a>该属性。</span> </p>
<p> <span>这是一个调用此方法并检查其成功检索所有请求的属性的示例：</span> </p>
<pre> <span>String[] attrNames = ...;
AttributeList list = mbeanServerConnection.getAttributes(objectName, attrNames);
if (list.size() == attrNames.length)
System.out.println("All attributes were retrieved successfully");
else {
<code> List&lt;String&gt;</code> missing = new <code> ArrayList&lt;String&gt;</code>(
<!--
--><a href="../../java/util/Arrays.html#asList-T...-"><code>Arrays.asList</code></a>(attrNames));
for (Attribute a : list.asList())
missing.remove(a.getName());
System.out.println("Did not retrieve: " + missing);
}</span> </pre>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> -
<code>name</code>属性的MBean的对象名称。
</dd>
<dd>
<code>attributes</code> - 要检索的属性的列表。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
检索属性的列表。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a></code> - 指定的MBean未在MBean服务器中注册。
</dd>
<dd>
<code><a href="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</a></code> - 尝试调用动态MBean的getAttributes方法时发生异常。
</dd>
<dd>
<code><a href="../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 包装
<code>java.lang.IllegalArgumentException</code> ：参数中的对象名称为null或参数中的属性为空。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通信时发生通信问题。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/management/MBeanServerConnection.html#setAttributes-javax.management.ObjectName-javax.management.AttributeList-"><code>setAttributes(javax.management.ObjectName, javax.management.AttributeList)</code></a>
</dd>
</dl> </li>
</ul> <a name="setAttribute-javax.management.ObjectName-javax.management.Attribute-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setAttribute</h4> <pre>void setAttribute(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name,
<a href="../../javax/management/Attribute.html" title="class in javax.management">Attribute</a> attribute)
throws <a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a>,
<a href="../../javax/management/AttributeNotFoundException.html" title="class in javax.management">AttributeNotFoundException</a>,
<a href="../../javax/management/InvalidAttributeValueException.html" title="class in javax.management">InvalidAttributeValueException</a>,
<a href="../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
<a href="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</a>,
<a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>设置命名MBean的特定属性的值。</span>
<span>MBean由其对象名称标识。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要在其中设置属性的MBean的名称。
</dd>
<dd>
<code>attribute</code> - 要设置的属性的标识和要设置的值。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a></code> - 指定的MBean未在MBean服务器中注册。
</dd>
<dd>
<code><a href="../../javax/management/AttributeNotFoundException.html" title="class in javax.management">AttributeNotFoundException</a></code> - MBean中无法访问指定的属性。
</dd>
<dd>
<code><a href="../../javax/management/InvalidAttributeValueException.html" title="class in javax.management">InvalidAttributeValueException</a></code> -
<code><a href="../../javax/management/InvalidAttributeValueException.html" title="class in javax.management">InvalidAttributeValueException</a></code>的值无效。
</dd>
<dd>
<code><a href="../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - 包装由MBean的setter抛出的异常。
</dd>
<dd>
<code><a href="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</a></code> - 在尝试调用设置器时抛出一个
<code>java.lang.Exception</code> 。
</dd>
<dd>
<code><a href="../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 包装
<code>java.lang.IllegalArgumentException</code> ：参数中的对象名称为null或参数中的属性为null。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通信时发生通信问题。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/management/MBeanServerConnection.html#getAttribute-javax.management.ObjectName-java.lang.String-"><code>getAttribute(javax.management.ObjectName, java.lang.String)</code></a>
</dd>
</dl> </li>
</ul> <a name="setAttributes-javax.management.ObjectName-javax.management.AttributeList-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setAttributes</h4> <pre><a href="../../javax/management/AttributeList.html" title="class in javax.management">AttributeList</a> setAttributes(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name,
<a href="../../javax/management/AttributeList.html" title="class in javax.management">AttributeList</a> attributes)
throws <a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a>,
<a href="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</a>,
<a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<p> <span>设置一个命名MBean的几个属性的值。</span> <span>MBean由其对象名称标识。</span> </p>
<p> <span>如果由于某种原因无法设置一个或多个属性，则返回的<code>AttributeList</code>将被省略。</span> <span>主叫方应检查输入端<code>AttributeList</code>的大小与输出的大小相同。</span> <span>要发现什么问题被检索防止给定的属性，它通常可以打电话<a href="../../javax/management/MBeanServerConnection.html#setAttribute-javax.management.ObjectName-javax.management.Attribute-"><code>setAttribute</code></a>该属性，虽然这不能保证工作。</span> <span>（例如，两个属性的值可能已被拒绝，因为它们彼此不一致，可以单独设置其中一个属性。）</span> </p>
<p> <span>这是一个调用此方法并检查其成功设置所有请求的属性的示例：</span> </p>
<pre> <span>AttributeList inputAttrs = ...;
AttributeList outputAttrs = mbeanServerConnection.setAttributes(
<!--
-->objectName, inputAttrs);
if (inputAttrs.size() == outputAttrs.size())
System.out.println("All attributes were set successfully");
else {
<code> List&lt;String&gt;</code> missing = new <code> ArrayList&lt;String&gt;</code>();
for (Attribute a : inputAttrs.asList())
missing.add(a.getName());
for (Attribute a : outputAttrs.asList())
missing.remove(a.getName());
System.out.println("Did not set: " + missing);
}</span> </pre>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要在其中设置属性的MBean的对象名称。
</dd>
<dd>
<code>attributes</code> - 属性列表：要设置的属性的标识以及要设置的属性值。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
已设置的属性列表及其新值。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a></code> - 指定的MBean未在MBean服务器中注册。
</dd>
<dd>
<code><a href="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</a></code> - 尝试调用动态MBean的getAttributes方法时发生异常。
</dd>
<dd>
<code><a href="../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 包裹一个
<code>java.lang.IllegalArgumentException</code> ：参数中的对象名称为null或参数中的属性为空。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通信时发生通信问题。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/management/MBeanServerConnection.html#getAttributes-javax.management.ObjectName-java.lang.String:A-"><code>getAttributes(javax.management.ObjectName, java.lang.String[])</code></a>
</dd>
</dl> </li>
</ul> <a name="invoke-javax.management.ObjectName-java.lang.String-java.lang.Object:A-java.lang.String:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>invoke</h4> <pre><a href="../../java/lang/Object.html" title="class in java.lang">Object</a> invoke(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name,
<a href="../../java/lang/String.html" title="class in java.lang">String</a> operationName,
<a href="../../java/lang/Object.html" title="class in java.lang">Object</a>[] params,
<a href="../../java/lang/String.html" title="class in java.lang">String</a>[] signature)
throws <a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a>,
<a href="../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
<a href="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</a>,
<a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<p> <span>调用MBean上的操作。</span> </p>
<p> <span>由于需要一个<code>signature</code>来区分可能的重载操作，所以在可能的情况下通过<a href="../../javax/management/JMX.html#newMBeanProxy-javax.management.MBeanServerConnection-javax.management.ObjectName-java.lang.Class-">MBean proxy</a>调用操作要简单得多。</span> <span>例如，假设你有一个这样的标准MBean接口：</span> </p>
<pre> <span>public interface FooMBean {
public int countMatches(String[] patterns, boolean ignoreCase);
}</span> </pre>
<p> <span><code>countMatches</code>操作可以被调用如下：</span> </p>
<pre> <span>String[] myPatterns = ...;
int count = (Integer) mbeanServerConnection.invoke(
objectName,
"countMatches",
new Object[] {myPatterns, true},
new String[] {String[].class.getName(), boolean.class.getName()});</span> </pre>
<p> <span>或者，它可以通过代理调用如下：</span> </p>
<pre> <span>String[] myPatterns = ...;
FooMBean fooProxy = JMX.newMBeanProxy(
mbeanServerConnection, objectName, FooMBean.class);
int count = fooProxy.countMatches(myPatterns, true);</span> </pre>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要调用该方法的MBean的对象名称。
</dd>
<dd>
<code>operationName</code> - 要调用的操作的名称。
</dd>
<dd>
<code>params</code> - 包含在调用操作时要设置的参数的数组
</dd>
<dd>
<span><code>signature</code> - 包含操作签名的数组，由<a href="../../java/lang/Class.html#getName--"><code>Class.getName()</code></a>返回的格式的类名数组。</span>
<span>将使用与用于加载调用操作的MBean相同的类加载器来加载类对象。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
由操作返回的对象，表示在指定的MBean上调用操作的结果。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a></code> - 指定的MBean未在MBean服务器中注册。
</dd>
<dd>
<code><a href="../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - 包装MBean调用方法抛出的异常。
</dd>
<dd>
<code><a href="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</a></code> - 在尝试调用该方法时抛出一个
<code>java.lang.Exception</code> 。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通话时发生通信问题。
</dd>
</dl> </li>
</ul> <a name="getDefaultDomain--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDefaultDomain</h4> <pre><a href="../../java/lang/String.html" title="class in java.lang">String</a> getDefaultDomain()
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回用于命名MBean的默认域。</span>
<span>如果用户没有指定域，默认域名将用作MBeans的ObjectName中的域部分。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
默认域。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通信时发生通信问题。
</dd>
</dl> </li>
</ul> <a name="getDomains--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDomains</h4> <pre><a href="../../java/lang/String.html" title="class in java.lang">String</a>[] getDomains()
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<p> <span>返回任何MBean当前注册的域列表。</span> <span>当且仅当至少有一个MBean注册了一个ObjectName，其中<a href="../../javax/management/ObjectName.html#getDomain--"><code>getDomain()</code></a>等于该字符串时，该字符串在返回的数组中。</span> <span>未定义返回的数组中的字符串顺序。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
域列表。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通信时发生通信问题。
</dd>
</dl> </li>
</ul> <a name="addNotificationListener-javax.management.ObjectName-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addNotificationListener</h4> <pre>void addNotificationListener(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name,
<a href="../../javax/management/NotificationListener.html" title="interface in javax.management">NotificationListener</a> listener,
<a href="../../javax/management/NotificationFilter.html" title="interface in javax.management">NotificationFilter</a> filter,
<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> handback)
throws <a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a>,
<a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<p> <span>将一个监听器添加到注册的MBean。</span> <span>MBean发出的通知将被转发给收听者。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 应在其上添加侦听器的MBean的名称。
</dd>
<dd>
<code>listener</code> - 将处理由注册的MBean发出的通知的侦听器对象。
</dd>
<dd>
<span><code>filter</code> - 过滤器对象。</span>
<span>如果过滤器为空，则在处理通知之前不会执行过滤。</span>
</dd>
<dd>
<code>handback</code> - 发出通知时发送到侦听器的上下文。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a></code> - 提供的MBean名称与任何注册的MBean不匹配。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通信时发生通信问题。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/management/MBeanServerConnection.html#removeNotificationListener-javax.management.ObjectName-javax.management.NotificationListener-"><code>removeNotificationListener(ObjectName, NotificationListener)</code></a> ，
<a href="../../javax/management/MBeanServerConnection.html#removeNotificationListener-javax.management.ObjectName-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-"><code>removeNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)</code></a>
</dd>
</dl> </li>
</ul> <a name="addNotificationListener-javax.management.ObjectName-javax.management.ObjectName-javax.management.NotificationFilter-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addNotificationListener</h4> <pre>void addNotificationListener(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name,
<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> listener,
<a href="../../javax/management/NotificationFilter.html" title="interface in javax.management">NotificationFilter</a> filter,
<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> handback)
throws <a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a>,
<a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<p> <span>将一个监听器添加到注册的MBean。</span> </p>
<p> <span>MBean发出的通知将由MBeanServer转发给侦听器。</span> <span>如果通知源是对MBean对象的引用，则MBean服务器将用该MBean的ObjectName替换它。</span> <span>否则源不变。</span> </p>
<p> <span>接收通知的侦听器对象是在调用此方法时用给定名称注册的对象。</span> <span>即使随后未注册，它将继续收到通知。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 应添加侦听器的MBean的名称。
</dd>
<dd>
<code>listener</code> - 将处理由注册的MBean发出的通知的侦听器的对象名称。
</dd>
<dd>
<span><code>filter</code> - 过滤器对象。</span>
<span>如果过滤器为空，则在处理通知之前不会执行过滤。</span>
</dd>
<dd>
<code>handback</code> - 发出通知时发送到侦听器的上下文。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a></code> - 通知侦听器或通知广播者的MBean名称与任何已注册的MBean不匹配。
</dd>
<dd>
<span><code><a href="../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 包裹一个<a href="../../java/lang/IllegalArgumentException.html" title="java.lang中的类"><code>IllegalArgumentException</code></a> 。</span>
<span>由<code>listener</code>命名的MBean存在但不实现<a href="../../javax/management/NotificationListener.html" title="javax.management中的接口"><code>NotificationListener</code></a>接口。</span>
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通信时发生通信问题。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/management/MBeanServerConnection.html#removeNotificationListener-javax.management.ObjectName-javax.management.ObjectName-"><code>removeNotificationListener(ObjectName, ObjectName)</code></a> ，
<a href="../../javax/management/MBeanServerConnection.html#removeNotificationListener-javax.management.ObjectName-javax.management.ObjectName-javax.management.NotificationFilter-java.lang.Object-"><code>removeNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)</code></a>
</dd>
</dl> </li>
</ul> <a name="removeNotificationListener-javax.management.ObjectName-javax.management.ObjectName-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeNotificationListener</h4> <pre>void removeNotificationListener(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name,
<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> listener)
throws <a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a>,
<a href="../../javax/management/ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</a>,
<a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>从注册的MBean中删除一个监听器。</span>
<p> <span>如果监听器注册不止一次，也许使用不同的过滤器或回调函数，此方法将删除所有这些注册。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 应删除侦听器的MBean的名称。
</dd>
<dd>
<code>listener</code> - 要删除的侦听器的对象名称。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a></code> - 提供的MBean名称与任何注册的MBean不匹配。
</dd>
<dd>
<code><a href="../../javax/management/ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</a></code> - 监听器未在MBean中注册。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通话时发生通信问题。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/management/MBeanServerConnection.html#addNotificationListener-javax.management.ObjectName-javax.management.ObjectName-javax.management.NotificationFilter-java.lang.Object-"><code>addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)</code></a>
</dd>
</dl> </li>
</ul> <a name="removeNotificationListener-javax.management.ObjectName-javax.management.ObjectName-javax.management.NotificationFilter-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeNotificationListener</h4> <pre>void removeNotificationListener(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name,
<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> listener,
<a href="../../javax/management/NotificationFilter.html" title="interface in javax.management">NotificationFilter</a> filter,
<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> handback)
throws <a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a>,
<a href="../../javax/management/ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</a>,
<a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<p> <span>从注册的MBean中删除一个监听器。</span> </p>
<p> <span>该MBean必须有一个与给定匹配的侦听<code>listener</code> ， <code>filter</code>和<code>handback</code>参数。</span> <span>如果有多个这样的听众，只有一个被删除。</span> </p>
<p> <span><code>filter</code>和<code>handback</code>参数当且仅当在要删除的侦听器中为空时才可以为空。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 应删除侦听器的MBean的名称。
</dd>
<dd>
<code>listener</code> - 要删除的侦听器的对象名称。
</dd>
<dd>
<code>filter</code> - 添加侦听器时指定的过滤器。
</dd>
<dd>
<code>handback</code> - 添加侦听器时指定的回调。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a></code> - 提供的MBean名称与任何注册的MBean不匹配。
</dd>
<dd>
<code><a href="../../javax/management/ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</a></code> - 监听器未在MBean中注册，或者未注册给定过滤器和回传。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通信时发生通信问题。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/management/MBeanServerConnection.html#addNotificationListener-javax.management.ObjectName-javax.management.ObjectName-javax.management.NotificationFilter-java.lang.Object-"><code>addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)</code></a>
</dd>
</dl> </li>
</ul> <a name="removeNotificationListener-javax.management.ObjectName-javax.management.NotificationListener-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeNotificationListener</h4> <pre>void removeNotificationListener(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name,
<a href="../../javax/management/NotificationListener.html" title="interface in javax.management">NotificationListener</a> listener)
throws <a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a>,
<a href="../../javax/management/ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</a>,
<a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<p> <span>从注册的MBean中删除一个监听器。</span> </p>
<p> <span>如果监听器注册不止一次，也许使用不同的过滤器或回调函数，此方法将删除所有这些注册。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 应删除侦听器的MBean的名称。
</dd>
<dd>
<code>listener</code> - 要删除的侦听器。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a></code> - 提供的MBean名称与任何已注册的MBean不匹配。
</dd>
<dd>
<code><a href="../../javax/management/ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</a></code> - 监听器未在MBean中注册。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通信时发生通信问题。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/management/MBeanServerConnection.html#addNotificationListener-javax.management.ObjectName-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-"><code>addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)</code></a>
</dd>
</dl> </li>
</ul> <a name="removeNotificationListener-javax.management.ObjectName-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeNotificationListener</h4> <pre>void removeNotificationListener(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name,
<a href="../../javax/management/NotificationListener.html" title="interface in javax.management">NotificationListener</a> listener,
<a href="../../javax/management/NotificationFilter.html" title="interface in javax.management">NotificationFilter</a> filter,
<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> handback)
throws <a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a>,
<a href="../../javax/management/ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</a>,
<a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<p> <span>从注册的MBean中删除一个监听器。</span> </p>
<p> <span>该MBean必须有一个与给定匹配的侦听<code>listener</code> ， <code>filter</code>和<code>handback</code>参数。</span> <span>如果有多个这样的听众，只有一个被删除。</span> </p>
<p> <span><code>filter</code>和<code>handback</code>参数可以为null，当且仅当它们在要删除的侦听器中为空时。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 应删除侦听器的MBean的名称。
</dd>
<dd>
<code>listener</code> - 要删除的侦听器。
</dd>
<dd>
<code>filter</code> - 添加侦听器时指定的过滤器。
</dd>
<dd>
<code>handback</code> - 添加侦听器时指定的回调。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a></code> - 提供的MBean名称与任何注册的MBean不匹配。
</dd>
<dd>
<code><a href="../../javax/management/ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</a></code> - 监听器未在MBean中注册，或者未注册到给定的过滤器和回传。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通信时发生通信问题。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/management/MBeanServerConnection.html#addNotificationListener-javax.management.ObjectName-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-"><code>addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)</code></a>
</dd>
</dl> </li>
</ul> <a name="getMBeanInfo-javax.management.ObjectName-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getMBeanInfo</h4> <pre><a href="../../javax/management/MBeanInfo.html" title="class in javax.management">MBeanInfo</a> getMBeanInfo(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name)
throws <a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a>,
<a href="../../javax/management/IntrospectionException.html" title="class in javax.management">IntrospectionException</a>,
<a href="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</a>,
<a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
此方法可以发现MBean公开管理的属性和操作。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要分析的MBean的名称
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>MBeanInfo</code>一个实例允许检索此MBean的所有属性和操作。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/management/IntrospectionException.html" title="class in javax.management">IntrospectionException</a></code> - 内省时发生异常。
</dd>
<dd>
<code><a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a></code> - 未找到
<code><a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a></code>的MBean。
</dd>
<dd>
<code><a href="../../javax/management/ReflectionException.html" title="class in javax.management">ReflectionException</a></code> - 尝试调用动态MBean的getMBeanInfo时发生异常。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通信时发生通信问题。
</dd>
</dl> </li>
</ul> <a name="isInstanceOf-javax.management.ObjectName-java.lang.String-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>isInstanceOf</h4> <pre>boolean isInstanceOf(<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name,
<a href="../../java/lang/String.html" title="class in java.lang">String</a> className)
throws <a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a>,
<a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<p> <span>如果指定的MBean是指定类的实例，则返回true，否则返回false。</span> </p>
<p> <span>如果<code>name</code>未命名为MBean，则此方法将抛出<a href="../../javax/management/InstanceNotFoundException.html" title="javax.management中的类"><code>InstanceNotFoundException</code></a> 。</span> </p>
<p> <span>否则，让</span> <br/> <span>X是由<code>name</code>命名的MBean，</span> <br/> <span>L是X的ClassLoader，</span> <br/> <span>N是X的<a href="../../javax/management/MBeanInfo.html" title="javax.management中的类"><code>MBeanInfo</code>中</a>的类名。</span> </p>
<p> <span>如果N等于<code>className</code> ，则结果为真。</span> </p>
<p> <span>否则，如果L成功加载<code>className</code> ，并且X是此类的实例，则结果为true。</span> </p>
<p> <span>否则，如果L成功加载N和<code>className</code> ，并且第二个类可以从第一个类可分配，则结果为true。</span> </p>
<p> <span>否则，结果是假的。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - MBean的
<code>ObjectName</code> 。
</dd>
<dd>
<code>className</code> - 类的名称。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果指定的MBean是根据上述规则的指定类的实例，则为true，否则为false。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/management/InstanceNotFoundException.html" title="class in javax.management">InstanceNotFoundException</a></code> - 指定的MBean未在MBean服务器中注册。
</dd>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 与MBean服务器通信时发生通信问题。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../java/lang/Class.html#isInstance-java.lang.Object-"><code>Class.isInstance(java.lang.Object)</code></a>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>
Reference in New Issue View Git Blame Copy Permalink