680 lines
43 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.remote.rmi
</div>
<h2 class="title" title="Class RMIConnector">Class RMIConnector</h2>
</div><div class="contentContainer">
<ul class="inheritance">
<li><a href="../../../../java/lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li>javax.management.remote.rmi.RMIConnector</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Implemented Interfaces:
</dt>
<dd>
<span><a href="../../../../java/io/Closeable.html" title="java.io中的接口">Closeable</a> <a href="../../../../java/io/Serializable.html" title="java.io中的接口">Serializable</a> <a href="../../../../java/lang/AutoCloseable.html" title="java.lang中的接口">AutoCloseable</a> <a href="../../../../javax/management/remote/JMXAddressable.html" title="javax.management.remote中的接口">JMXAddressable</a> <a href="../../../../javax/management/remote/JMXConnector.html" title="javax.management.remote中的接口">JMXConnector</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public class <span class="typeNameLabel">RMIConnector</span>
extends <a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a>
implements <a href="../../../../javax/management/remote/JMXConnector.html" title="interface in javax.management.remote">JMXConnector</a>, <a href="../../../../java/io/Serializable.html" title="interface in java.io">Serializable</a>, <a href="../../../../javax/management/remote/JMXAddressable.html" title="interface in javax.management.remote">JMXAddressable</a></pre>
<div class="block">
<p> <span>与远程RMI连接器的连接。</span> <span>通常,这样的连接使用<a href="../../../../javax/management/remote/JMXConnectorFactory.html" title="javax.management.remote中的类"><code>JMXConnectorFactory</code></a></span> <span>然而专门的应用程序可以直接使用这个类例如使用没有经过JNDI的<a href="../../../../javax/management/remote/rmi/RMIServer.html" title="javax.management.remote.rmi中的接口"><code>RMIServer</code></a>存根。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.5
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../../serialized-form.html#javax.management.remote.rmi.RMIConnector">Serialized Form</a>
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.summary">
<!-- --> </a> <h3>Field Summary</h3>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.javax.management.remote.JMXConnector">
<!-- --> </a> <h3>Fields inherited from interface javax.management.remote.<a href="../../../../javax/management/remote/JMXConnector.html" title="interface in javax.management.remote">JMXConnector</a></h3> <code><a href="../../../../javax/management/remote/JMXConnector.html#CREDENTIALS">CREDENTIALS</a></code></li>
</ul> </li>
</ul>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- --> </a> <h3>构造方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Constructor Summary table, listing constructors, and an explanation">
<caption>
<span>构造方法</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../javax/management/remote/rmi/RMIConnector.html#RMIConnector-javax.management.remote.JMXServiceURL-java.util.Map-">RMIConnector</a></span>(<a href="../../../../javax/management/remote/JMXServiceURL.html" title="class in javax.management.remote">JMXServiceURL</a> url, <a href="../../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../../java/lang/String.html" title="class in java.lang">String</a>,?&gt; environment)</code>
<div class="block">
构造一个
<code>RMIConnector</code>将RMI连接器服务器与给定的地址连接。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../javax/management/remote/rmi/RMIConnector.html#RMIConnector-javax.management.remote.rmi.RMIServer-java.util.Map-">RMIConnector</a></span>(<a href="../../../../javax/management/remote/rmi/RMIServer.html" title="interface in javax.management.remote.rmi">RMIServer</a> rmiServer, <a href="../../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../../java/lang/String.html" title="class in java.lang">String</a>,?&gt; environment)</code>
<div class="block">
构造一个
<code>RMIConnector</code>使用给定的RMI存根。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- ========== 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="t4"><span><a href="javascript:show(8);">具体的方法</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/remote/rmi/RMIConnector.html#addConnectionNotificationListener-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-">addConnectionNotificationListener</a></span>(<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">
添加一个监听器以通知连接状态的变化。
</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/remote/rmi/RMIConnector.html#close--">close</a></span>()</code>
<div class="block">
关闭与其服务器的客户端连接。
</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/remote/rmi/RMIConnector.html#connect--">connect</a></span>()</code>
<div class="block">
建立与连接器服务器的连接。
</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/remote/rmi/RMIConnector.html#connect-java.util.Map-">connect</a></span>(<a href="../../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../../java/lang/String.html" title="class in java.lang">String</a>,?&gt; environment)</code>
<div class="block">
建立与连接器服务器的连接。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../../../javax/management/remote/JMXServiceURL.html" title="class in javax.management.remote">JMXServiceURL</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/management/remote/rmi/RMIConnector.html#getAddress--">getAddress</a></span>()</code>
<div class="block">
该连接器的地址。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<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/remote/rmi/RMIConnector.html#getConnectionId--">getConnectionId</a></span>()</code>
<div class="block">
从连接器服务器获取此连接的ID。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code><a href="../../../../javax/management/MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/management/remote/rmi/RMIConnector.html#getMBeanServerConnection--">getMBeanServerConnection</a></span>()</code>
<div class="block">
返回表示远程MBean服务器的
<code>MBeanServerConnection</code>对象。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code><a href="../../../../javax/management/MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/management/remote/rmi/RMIConnector.html#getMBeanServerConnection-javax.security.auth.Subject-">getMBeanServerConnection</a></span>(<a href="../../../../javax/security/auth/Subject.html" title="class in javax.security.auth">Subject</a> delegationSubject)</code>
<div class="block">
返回一个
<code>MBeanServerConnection</code>远程MBean服务器的
<code>MBeanServerConnection</code>对象,代表所提供的委托主体执行操作。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/management/remote/rmi/RMIConnector.html#removeConnectionNotificationListener-javax.management.NotificationListener-">removeConnectionNotificationListener</a></span>(<a href="../../../../javax/management/NotificationListener.html" title="interface in javax.management">NotificationListener</a> listener)</code>
<div class="block">
从列表中删除一个监听器以通知状态更改。
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/management/remote/rmi/RMIConnector.html#removeConnectionNotificationListener-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-">removeConnectionNotificationListener</a></span>(<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">
从列表中删除一个监听器以通知状态更改。
</div> </td>
</tr>
<tr class="altColor" id="i10">
<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/remote/rmi/RMIConnector.html#toString--">toString</a></span>()</code>
<div class="block">
返回此对象的字符串表示形式。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a></h3> <code><a href="../../../../java/lang/Object.html#clone--">clone</a>, <a href="../../../../java/lang/Object.html#equals-java.lang.Object-">equals</a>, <a href="../../../../java/lang/Object.html#finalize--">finalize</a>, <a href="../../../../java/lang/Object.html#getClass--">getClass</a>, <a href="../../../../java/lang/Object.html#hashCode--">hashCode</a>, <a href="../../../../java/lang/Object.html#notify--">notify</a>, <a href="../../../../java/lang/Object.html#notifyAll--">notifyAll</a>, <a href="../../../../java/lang/Object.html#wait--">wait</a>, <a href="../../../../java/lang/Object.html#wait-long-">wait</a>, <a href="../../../../java/lang/Object.html#wait-long-int-">wait</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="RMIConnector-javax.management.remote.JMXServiceURL-java.util.Map-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>RMIConnector</h4> <pre>public RMIConnector(<a href="../../../../javax/management/remote/JMXServiceURL.html" title="class in javax.management.remote">JMXServiceURL</a> url,
<a href="../../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../../java/lang/String.html" title="class in java.lang">String</a>,?&gt; environment)</pre>
<div class="block">
<p> <span>构造一个<code>RMIConnector</code>将RMI连接器服务器与给定的地址连接。</span> </p>
<p> <span>该地址可以使用以下语法之一直接引用到连接器服务器:</span> </p>
<pre> <span>service:jmx:rmi://<em>[host[:port]]</em>/stub/<em>encoded-stub</em>
service:jmx:iiop://<em>[host[:port]]</em>/ior/<em>encoded-IOR</em></span> </pre>
<p> <span>(这里,方括号<code>[]</code>不是地址的一部分,但表示主机和端口是可选的。)</span> </p>
<p> <span>该地址可以指示通过JNDI查找RMI存根的位置使用以下语法之一</span> </p>
<pre> <span>service:jmx:rmi://<em>[host[:port]]</em>/jndi/<em>jndi-name</em>
service:jmx:iiop://<em>[host[:port]]</em>/jndi/<em>jndi-name</em></span> </pre>
<p> <span>实现还可以识别额外的地址语法,例如:</span> </p>
<pre> <span>service:jmx:iiop://<em>[host[:port]]</em>/stub/<em>encoded-stub</em></span> </pre>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>url</code> - RMI连接器服务器的地址。
</dd>
<dd>
<span><code>environment</code> - 指定如何进行连接的附加属性。</span>
<span>对于基于JNDI的地址这些属性可以有效地包括由<a href="../../../../javax/naming/InitialContext.html#InitialContext-java.util.Hashtable-"><code>InitialContext</code>识别的</a> JNDI <a href="../../../../javax/naming/InitialContext.html#InitialContext-java.util.Hashtable-">属性</a></span>
<span>此参数可以为空这相当于一个空的Map。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>url</code>为空。
</dd>
</dl> </li>
</ul> <a name="RMIConnector-javax.management.remote.rmi.RMIServer-java.util.Map-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>RMIConnector</h4> <pre>public RMIConnector(<a href="../../../../javax/management/remote/rmi/RMIServer.html" title="interface in javax.management.remote.rmi">RMIServer</a> rmiServer,
<a href="../../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../../java/lang/String.html" title="class in java.lang">String</a>,?&gt; environment)</pre>
<div class="block">
<p>使用给定的RMI存根构造一个<code>RMIConnector</code></p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>rmiServer</code> - 表示RMI连接器服务器的RMI存根。
</dd>
<dd>
<span><code>environment</code> - 指定如何进行连接的附加属性。</span>
<span>此参数可以为空这相当于一个空的Map。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>rmiServer</code>为空。
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="toString--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>toString</h4> <pre>public <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> toString()</pre>
<div class="block">
<p> <span>返回此对象的字符串表示形式。</span> <span>一般来说, <code>toString</code>方法返回一个“textually代表”这个对象的字符串。</span> <span>结果应该是一个简明扼要的表达,容易让人阅读。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写:</span>
</dt>
<dd>
<code><a href="../../../../java/lang/Object.html#toString--">toString</a></code>
<code><a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
该对象的字符串表示形式。
</dd>
</dl> </li>
</ul> <a name="getAddress--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAddress</h4> <pre>public <a href="../../../../javax/management/remote/JMXServiceURL.html" title="class in javax.management.remote">JMXServiceURL</a> getAddress()</pre>
<div class="block">
<p>该连接器的地址。 </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../javax/management/remote/JMXAddressable.html#getAddress--">getAddress</a></code>在接口
<code><a href="../../../../javax/management/remote/JMXAddressable.html" title="interface in javax.management.remote">JMXAddressable</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
该连接器的地址如果没有则为null。
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.6
</dd>
</dl> </li>
</ul> <a name="connect--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>connect</h4> <pre>public void connect()
throws <a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面: <code><a href="../../../../javax/management/remote/JMXConnector.html#connect--">JMXConnector</a></code>复制</span>
</div>
<div class="block">
<p> <span>建立与连接器服务器的连接。</span> <span>此方法相当于<a href="../../../../javax/management/remote/JMXConnector.html#connect-java.util.Map-"><code>connect(null)</code></a></span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../javax/management/remote/JMXConnector.html#connect--">connect</a></code>中的
<code><a href="../../../../javax/management/remote/JMXConnector.html" title="interface in javax.management.remote">JMXConnector</a></code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果由于通信问题而无法建立连接,或者在
<code>iiop</code>协议的情况下不支持RMI / IIOP
</dd>
</dl> </li>
</ul> <a name="connect-java.util.Map-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>connect</h4> <pre>public void connect(<a href="../../../../java/util/Map.html" title="interface in java.util">Map</a>&lt;<a href="../../../../java/lang/String.html" title="class in java.lang">String</a>,?&gt; environment)
throws <a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面复制: <code><a href="../../../../javax/management/remote/JMXConnector.html#connect-java.util.Map-">JMXConnector</a></code></span>
</div>
<div class="block">
<p> <span>建立与连接器服务器的连接。</span> </p>
<p> <span>如果<code>connect</code>已经在此对象上成功调用,则再次调用它不起作用。</span> <span>不过如果<a href="../../../../javax/management/remote/JMXConnector.html#close--"><code>JMXConnector.close()</code></a>被称为<code>connect</code>后,新的<code>connect</code>将会抛出一个<code>IOException</code></span> </p>
<p> <span>否则, <code>connect</code>从未在此对象上被调用,或者已被调用但产生异常。</span> <span>然后调用<code>connect</code>将尝试建立与连接器服务器的连接。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../javax/management/remote/JMXConnector.html#connect-java.util.Map-">connect</a></code>在接口
<code><a href="../../../../javax/management/remote/JMXConnector.html" title="interface in javax.management.remote">JMXConnector</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>environment</code> - 连接的属性。</span>
<span>在此映射属性中时指定的地图覆盖性能<code>JMXConnector</code>被创造了,如果有的话。</span>
<span>此参数可以为null这相当于一个空的地图。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果由于通信问题而无法建立连接,或者在
<code>iiop</code>协议的情况下不支持RMI / IIOP
</dd>
</dl> </li>
</ul> <a name="getConnectionId--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getConnectionId</h4> <pre>public <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> getConnectionId()
throws <a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面复制: <code><a href="../../../../javax/management/remote/JMXConnector.html#getConnectionId--">JMXConnector</a></code></span>
</div>
<div class="block">
<p> <span>从连接器服务器获取此连接的ID。</span> <span>对于给定的连接器服务器每个连接将具有唯一的ID在连接的生命周期内不会更改。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../javax/management/remote/JMXConnector.html#getConnectionId--">getConnectionId</a></code>在界面
<code><a href="../../../../javax/management/remote/JMXConnector.html" title="interface in javax.management.remote">JMXConnector</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>此连接的唯一ID。</span>
<span>这与连接器服务器在其<a href="../../../../javax/management/remote/JMXConnectionNotification.html" title="javax.management.remote中的类"><code>JMXConnectionNotification</code></a>包含的ID相同。</span>
<span><a href="../../../../javax/management/remote/package-summary.html"><code>package description</code></a>描述了连接ID的约定。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果无法获取连接ID例如因为连接被关闭或断开。
</dd>
</dl> </li>
</ul> <a name="getMBeanServerConnection--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getMBeanServerConnection</h4> <pre>public <a href="../../../../javax/management/MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</a> getMBeanServerConnection()
throws <a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">从接口复制: <code><a href="../../../../javax/management/remote/JMXConnector.html#getMBeanServerConnection--">JMXConnector</a></code></span>
</div>
<div class="block">
<p> <span>返回表示远程MBean服务器的<code>MBeanServerConnection</code>对象。</span> <span>对于给定的<code>JMXConnector</code> ,两个成功调用此方法通常会返回相同的<code>MBeanServerConnection</code>对象,尽管这不是必需的。</span> </p>
<p> <span>对于返回的<code>MBeanServerConnection</code>中的每个方法调用该方法将导致在远程MBean服务器中调用相应的方法。</span> <span>MBean服务器方法返回的值是返回给客户端的值。</span> <span>如果MBean服务器方法生成<code>异常</code> ,客户端可以看到相同的<code>异常</code></span> <span>如果MBean服务器方法或者试图调用它产生<code>Error</code> ,所述<code>Error</code>被包裹在一个<a href="../../../../javax/management/remote/JMXServerErrorException.html" title="javax.management.remote中的类"><code>JMXServerErrorException</code></a> ,其由客户端可见。</span> </p>
<p> <span>调用此方法相当于调用<a href="../../../../javax/management/remote/JMXConnector.html#getMBeanServerConnection-javax.security.auth.Subject-"><code>getMBeanServerConnection(null)</code></a>这意味着没有指定委托主体并且所有在MBeanServerConnection上调用的<code>MBeanServerConnection</code>必须使用经过身份验证的主题(如果有)。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../javax/management/remote/JMXConnector.html#getMBeanServerConnection--">getMBeanServerConnection</a></code>在接口
<code><a href="../../../../javax/management/remote/JMXConnector.html" title="interface in javax.management.remote">JMXConnector</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
通过将其方法转发到远程MBean服务器来实现
<code>MBeanServerConnection</code>接口的对象。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果无法创建有效的
<code>MBeanServerConnection</code> 例如因为尚未建立与远程MBean服务器的连接使用
<a href="../../../../javax/management/remote/JMXConnector.html#connect-java.util.Map-"><code>connect</code></a>方法)或已关闭或已断开连接。
</dd>
</dl> </li>
</ul> <a name="getMBeanServerConnection-javax.security.auth.Subject-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getMBeanServerConnection</h4> <pre>public <a href="../../../../javax/management/MBeanServerConnection.html" title="interface in javax.management">MBeanServerConnection</a> getMBeanServerConnection(<a href="../../../../javax/security/auth/Subject.html" title="class in javax.security.auth">Subject</a> delegationSubject)
throws <a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面复制: <code><a href="../../../../javax/management/remote/JMXConnector.html#getMBeanServerConnection-javax.security.auth.Subject-">JMXConnector</a></code></span>
</div>
<div class="block">
<p> <span>返回一个<code>MBeanServerConnection</code>远程MBean服务器的<code>MBeanServerConnection</code>对象,代表所提供的委托主体执行操作。</span> <span>对于给定的<code>JMXConnector</code><code>Subject</code> ,两个成功调用此方法通常会返回相同的<code>MBeanServerConnection</code>对象,尽管这不是必需的。</span> </p>
<p> <span>对于返回的<code>MBeanServerConnection</code>中的每个方法调用该方法将导致相应的方法在远程MBean服务器中代表给定的授权对象而不是经过身份验证的主题进行调用。</span> <span>MBean服务器方法返回的值是返回给客户端的值。</span> <span>如果MBean服务器方法生成<code>异常</code> ,客户端可以看到相同的<code>异常</code></span> <span>如果MBean服务器方法或者试图调用它产生<code>Error</code> ,所述<code>Error</code>被包裹在一个<a href="../../../../javax/management/remote/JMXServerErrorException.html" title="javax.management.remote中的类"><code>JMXServerErrorException</code></a> ,其由客户端可见。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../javax/management/remote/JMXConnector.html#getMBeanServerConnection-javax.security.auth.Subject-">getMBeanServerConnection</a></code>在界面
<code><a href="../../../../javax/management/remote/JMXConnector.html" title="interface in javax.management.remote">JMXConnector</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>delegationSubject</code> -在<code>Subject</code>以其名义请求将被执行。</span>
<span>可以为null在这种情况下将代表被认证的主题如果有的话执行请求。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
实现该目的
<code>MBeanServerConnection</code>通过将其方法转发到远程MBean服务器代表一给定委托主题的接口。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果无法创建有效的
<code>MBeanServerConnection</code> 例如因为尚未建立与远程MBean服务器的连接使用
<a href="../../../../javax/management/remote/JMXConnector.html#connect-java.util.Map-"><code>connect</code></a>方法),或者已关闭或已断开连接。
</dd>
</dl> </li>
</ul> <a name="addConnectionNotificationListener-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addConnectionNotificationListener</h4> <pre>public void addConnectionNotificationListener(<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)</pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面复制: <code><a href="../../../../javax/management/remote/JMXConnector.html#addConnectionNotificationListener-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-">JMXConnector</a></code></span>
</div>
<div class="block">
<p> <span>添加一个监听器以通知连接状态的变化。</span> <span>收听者将收到<code>JMXConnectionNotification</code>类型的<a href="../../../../javax/management/remote/JMXConnectionNotification.html" title="javax.management.remote中的类">通知</a></span> <span>一个实现也可以发送其他类型的通知。</span> </p>
<p> <span>可以使用此方法添加任意数量的侦听器。</span> <span>可以使用相同或不同的过滤器和回传值,多次添加相同的侦听器。</span> <span>重复条目没有特殊处理。</span> <span>例如,如果一个监听器被注册了两次,没有过滤器,那么它的<code>handleNotification</code>方法将被调用两次,每个通知。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../javax/management/remote/JMXConnector.html#addConnectionNotificationListener-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-">addConnectionNotificationListener</a></code>在接口
<code><a href="../../../../javax/management/remote/JMXConnector.html" title="interface in javax.management.remote">JMXConnector</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>listener</code> - 接收连接状态通知的侦听器。
</dd>
<dd>
<code>filter</code> - 一个过滤器,用于选择要将哪些通知传递给侦听器;如果要传送所有通知,则为空。
</dd>
<dd>
<span><code>handback</code> - 与每个通知一起提供给侦听器的对象。</span>
<span>可以为null。</span>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../../javax/management/remote/JMXConnector.html#removeConnectionNotificationListener-javax.management.NotificationListener-"><code>JMXConnector.removeConnectionNotificationListener(javax.management.NotificationListener)</code></a>
<a href="../../../../javax/management/NotificationBroadcaster.html#addNotificationListener-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-"><code>NotificationBroadcaster.addNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)</code></a>
</dd>
</dl> </li>
</ul> <a name="removeConnectionNotificationListener-javax.management.NotificationListener-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeConnectionNotificationListener</h4> <pre>public void removeConnectionNotificationListener(<a href="../../../../javax/management/NotificationListener.html" title="interface in javax.management">NotificationListener</a> listener)
throws <a href="../../../../javax/management/ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面复制: <code><a href="../../../../javax/management/remote/JMXConnector.html#removeConnectionNotificationListener-javax.management.NotificationListener-">JMXConnector</a></code></span>
</div>
<div class="block">
<p> <span>从列表中删除一个监听器以通知状态更改。</span> <span>以前必须添加侦听器。</span> <span>如果有多个匹配的侦听器,则全部被删除。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../javax/management/remote/JMXConnector.html#removeConnectionNotificationListener-javax.management.NotificationListener-">removeConnectionNotificationListener</a></code>在接口
<code><a href="../../../../javax/management/remote/JMXConnector.html" title="interface in javax.management.remote">JMXConnector</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>listener</code> - 接收连接状态通知的侦听器。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../javax/management/ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</a></code> - 如果监听器未注册此
<code>JMXConnector</code>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../../javax/management/remote/JMXConnector.html#removeConnectionNotificationListener-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-"><code>JMXConnector.removeConnectionNotificationListener(NotificationListener, NotificationFilter, Object)</code></a>
<a href="../../../../javax/management/remote/JMXConnector.html#addConnectionNotificationListener-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-"><code>JMXConnector.addConnectionNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)</code></a>
<a href="../../../../javax/management/NotificationEmitter.html#removeNotificationListener-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-"><code>NotificationEmitter.removeNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)</code></a>
</dd>
</dl> </li>
</ul> <a name="removeConnectionNotificationListener-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeConnectionNotificationListener</h4> <pre>public void removeConnectionNotificationListener(<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/ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面: <code><a href="../../../../javax/management/remote/JMXConnector.html#removeConnectionNotificationListener-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-">JMXConnector</a></code>复制</span>
</div>
<div class="block">
<p> <span>从列表中删除一个监听器以通知状态更改。</span> <span>先前已经添加了同样的三个参数的侦听器。</span> <span>如果有多个匹配的侦听器,只有一个被删除。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../javax/management/remote/JMXConnector.html#removeConnectionNotificationListener-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-">removeConnectionNotificationListener</a></code>在接口
<code><a href="../../../../javax/management/remote/JMXConnector.html" title="interface in javax.management.remote">JMXConnector</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>listener</code> - 接收连接状态通知的侦听器。
</dd>
<dd>
<span><code>filter</code> - 一个过滤器,用于选择要将哪些通知传递给侦听器。</span>
<span>可以为null。</span>
</dd>
<dd>
<span><code>handback</code> - 与每个通知一起提供给侦听器的对象。</span>
<span>可以为null。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../javax/management/ListenerNotFoundException.html" title="class in javax.management">ListenerNotFoundException</a></code> - 如果监听器未注册此
<code>JMXConnector</code> ,或未注册给定过滤器和回传。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../../javax/management/remote/JMXConnector.html#removeConnectionNotificationListener-javax.management.NotificationListener-"><code>JMXConnector.removeConnectionNotificationListener(NotificationListener)</code></a>
<a href="../../../../javax/management/remote/JMXConnector.html#addConnectionNotificationListener-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-"><code>JMXConnector.addConnectionNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)</code></a>
<a href="../../../../javax/management/NotificationEmitter.html#removeNotificationListener-javax.management.NotificationListener-javax.management.NotificationFilter-java.lang.Object-"><code>NotificationEmitter.removeNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)</code></a>
</dd>
</dl> </li>
</ul> <a name="close--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>close</h4> <pre>public void close()
throws <a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">从接口复制: <code><a href="../../../../javax/management/remote/JMXConnector.html#close--">JMXConnector</a></code></span>
</div>
<div class="block">
<p> <span>关闭与其服务器的客户端连接。</span> <span>使用由<code>JMXConnector.getMBeanServerConnection()</code>返回的<a href="../../../../javax/management/remote/JMXConnector.html#getMBeanServerConnection--">MBeanServerConnection的</a>任何持续的或新的请求将获得一个<code>IOException</code></span> </p>
<p> <span>如果<code>close</code>已经在此对象上成功调用,则再次调用它不起作用。</span> <span>如果<code>close</code>从未被调用,或者如果被调用但产生异常,则将尝试关闭连接。</span> <span>这个尝试可以成功,在这种情况下, <code>close</code>将正常返回,否则可能会产生异常。</span> </p>
<p> <span>关闭连接是一个潜在的慢操作。</span> <span>例如,如果服务器崩溃,则关闭操作可能需要等待网络协议超时。</span> <span>不想封闭操作的调用者应该在单独的线程中执行。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/io/Closeable.html#close--">close</a></code>在接口
<code><a href="../../../../java/io/Closeable.html" title="interface in java.io">Closeable</a></code>
</dd>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../java/lang/AutoCloseable.html#close--">close</a></code>中的
<code><a href="../../../../java/lang/AutoCloseable.html" title="interface in java.lang">AutoCloseable</a></code>
</dd>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../javax/management/remote/JMXConnector.html#close--">close</a></code>在接口
<code><a href="../../../../javax/management/remote/JMXConnector.html" title="interface in javax.management.remote">JMXConnector</a></code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果连接不能被干净地关闭。</span>
<span>如果抛出此异常,则不知道连接的服务器端是否已完全关闭。</span>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>