mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-06 17:25:01 +08:00
296 lines
18 KiB
HTML
296 lines
18 KiB
HTML
<div class="header">
|
||
<div class="subTitle">
|
||
compact3
|
||
</div>
|
||
<div class="subTitle">
|
||
javax.management.remote
|
||
</div>
|
||
<h2 class="title" title="Interface JMXConnectorServerMBean">Interface JMXConnectorServerMBean</h2>
|
||
</div><div class="contentContainer">
|
||
<div class="description">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<dl>
|
||
<dt>
|
||
所有已知实现类：
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../javax/management/remote/JMXConnectorServer.html" title="javax.management.remote中的类">JMXConnectorServer</a> ， <a href="../../../javax/management/remote/rmi/RMIConnectorServer.html" title="javax.management.remote.rmi中的类">RMIConnectorServer</a></span>
|
||
</dd>
|
||
</dl>
|
||
<hr/> <br/> <pre>public interface <span class="typeNameLabel">JMXConnectorServerMBean</span></pre>
|
||
<div class="block">
|
||
<p> <span>连接器服务器的MBean接口。</span> <span>JMX API连接器服务器连接到MBean服务器，并与远程客户端的MBean服务器建立连接。</span> </p>
|
||
<p> <span>新创建的连接器服务器处于<em>非活动状态</em> ，并且尚未监听连接。</span> <span>只有当它的<a href="../../../javax/management/remote/JMXConnectorServerMBean.html#start--"><code>start</code></a>方法被调用它才开始侦听连接。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始：</span>
|
||
</dt>
|
||
<dd>
|
||
1.5
|
||
</dd>
|
||
</dl> </li>
|
||
</ul>
|
||
</div>
|
||
<div class="summary">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<!-- ========== METHOD SUMMARY =========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="method.summary">
|
||
<!-- --> </a> <h3>方法摘要</h3>
|
||
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
|
||
<caption>
|
||
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
|
||
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
|
||
<span class="tableTab" id="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
|
||
</caption>
|
||
<tbody>
|
||
<tr>
|
||
<th class="colFirst" scope="col">Modifier and Type</th>
|
||
<th class="colLast" scope="col">Method and Description</th>
|
||
</tr>
|
||
<tr class="altColor" id="i0">
|
||
<td class="colFirst"><code><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/JMXConnectorServerMBean.html#getAddress--">getAddress</a></span>()</code>
|
||
<div class="block">
|
||
该连接器服务器的地址。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i1">
|
||
<td class="colFirst"><code><a href="../../../java/util/Map.html" title="interface in java.util">Map</a><<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/JMXConnectorServerMBean.html#getAttributes--">getAttributes</a></span>()</code>
|
||
<div class="block">
|
||
此连接器服务器的属性。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i2">
|
||
<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/JMXConnectorServerMBean.html#getConnectionIds--">getConnectionIds</a></span>()</code>
|
||
<div class="block">
|
||
此连接器服务器当前打开的连接的ID列表。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i3">
|
||
<td class="colFirst"><code>boolean</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/remote/JMXConnectorServerMBean.html#isActive--">isActive</a></span>()</code>
|
||
<div class="block">
|
||
确定连接器服务器是否处于活动状态。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i4">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/remote/JMXConnectorServerMBean.html#setMBeanServerForwarder-javax.management.remote.MBeanServerForwarder-">setMBeanServerForwarder</a></span>(<a href="../../../javax/management/remote/MBeanServerForwarder.html" title="interface in javax.management.remote">MBeanServerForwarder</a> mbsf)</code>
|
||
<div class="block">
|
||
插入一个对象，拦截通过此连接器服务器到达的MBean服务器的请求。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i5">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/remote/JMXConnectorServerMBean.html#start--">start</a></span>()</code>
|
||
<div class="block">
|
||
激活连接器服务器，即开始侦听客户端连接。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i6">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/remote/JMXConnectorServerMBean.html#stop--">stop</a></span>()</code>
|
||
<div class="block">
|
||
停用连接器服务器，即停止侦听客户端连接。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i7">
|
||
<td class="colFirst"><code><a href="../../../javax/management/remote/JMXConnector.html" title="interface in javax.management.remote">JMXConnector</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/remote/JMXConnectorServerMBean.html#toJMXConnector-java.util.Map-">toJMXConnector</a></span>(<a href="../../../java/util/Map.html" title="interface in java.util">Map</a><<a href="../../../java/lang/String.html" title="class in java.lang">String</a>,?> env)</code>
|
||
<div class="block">
|
||
返回此连接器服务器的客户端存根。
|
||
</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="start--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>start</h4> <pre>void start()
|
||
throws <a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
|
||
<div class="block">
|
||
<p> <span>激活连接器服务器，即开始侦听客户端连接。</span> <span>当连接器服务器已经处于活动状态时调用此方法没有任何效果。</span> <span>当连接器服务器停止时调用此方法将生成一个<a href="../../../java/io/IOException.html" title="java.io中的类"><code>IOException</code></a> 。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果无法开始侦听或连接器服务器已停止。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果连接器服务器尚未连接到MBean服务器。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="stop--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>stop</h4> <pre>void stop()
|
||
throws <a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
|
||
<div class="block">
|
||
<p> <span>停用连接器服务器，即停止侦听客户端连接。</span> <span>调用此方法还将关闭此服务器所做的所有客户端连接。</span> <span>此方法返回后，无论是正常还是异常，连接器服务器将不会创建任何新的客户端连接。</span> </p>
|
||
<p> <span>一旦连接器服务器停止，它将无法再次启动。</span> </p>
|
||
<p> <span>当连接器服务器已经停止时调用此方法没有任何作用。</span> <span>当连接器服务器尚未启动时调用此方法将永久禁用连接器服务器对象。</span> </p>
|
||
<p> <span>如果关闭客户端连接会产生异常，则不会从此方法抛出该异常。</span> <span>具有<a href="../../../javax/management/remote/JMXConnectionNotification.html" title="javax.management.remote中的类"><code>JMXConnectionNotification.FAILED</code></a>类型的<a href="../../../javax/management/remote/JMXConnectionNotification.html#FAILED"><code>JMXConnectionNotification</code></a>从该MBean发出，连接的连接ID无法关闭。</span> </p>
|
||
<p> <span>关闭连接器服务器是一个潜在的慢操作。</span> <span>例如，如果具有打开连接的客户端计算机崩溃，则关闭操作可能必须等待网络协议超时。</span> <span>不想封闭操作的调用者应该在单独的线程中执行。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<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>
|
||
<span>除了服务器尝试关闭客户端连接之外，所有客户端连接都可能关闭。</span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="isActive--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>isActive</h4> <pre>boolean isActive()</pre>
|
||
<div class="block">
|
||
<p> <span>确定连接器服务器是否处于活动状态。</span> <span>当连接器服务器的<a href="../../../javax/management/remote/JMXConnectorServerMBean.html#start--"><code>start</code></a>方法成功返回时，连接器服务器开始处于活动状态，直到调用其<a href="../../../javax/management/remote/JMXConnectorServerMBean.html#stop--"><code>stop</code></a>方法或连接器服务器发生故障为止。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
如果连接器服务器处于活动状态，则为true。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="setMBeanServerForwarder-javax.management.remote.MBeanServerForwarder-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>setMBeanServerForwarder</h4> <pre>void setMBeanServerForwarder(<a href="../../../javax/management/remote/MBeanServerForwarder.html" title="interface in javax.management.remote">MBeanServerForwarder</a> mbsf)</pre>
|
||
<div class="block">
|
||
<p> <span>插入一个对象，拦截通过此连接器服务器到达的MBean服务器的请求。</span> <span>该目的将随着供给<code>MBeanServer</code>用于通过此连接器服务器创建的任何新的连接。</span> <span>现有连接不受影响。</span> </p>
|
||
<p> <span>该方法可以使用不同的<a href="../../../javax/management/remote/MBeanServerForwarder.html" title="javax.management.remote中的接口"><code>MBeanServerForwarder</code></a>对象多次<a href="../../../javax/management/remote/MBeanServerForwarder.html" title="javax.management.remote中的接口">调用</a> 。</span> <span>结果是一连串的代理商。</span> <span>最后一名货车是连锁店的第一名。</span> <span>更详细地说：</span> </p>
|
||
<ul>
|
||
<li><p> <span>如果此连接器服务器已与<code>MBeanServer</code>对象关联，那么该对象将被提供给<a href="../../../javax/management/remote/MBeanServerForwarder.html#setMBeanServer-javax.management.MBeanServer-"><code>mbsf.setMBeanServer</code></a> 。</span> <span>如果这样做会产生异常，则此方法会引发相同的异常，而不会产生任何其他影响。</span> </p></li>
|
||
<li><p> <span>如果此连接器尚未与<code>MBeanServer</code>对象关联，或者如果刚刚提到的<code>mbsf.setMBeanServer</code>呼叫成功，则<code>mbsf</code>将成为此连接器服务器的<code>MBeanServer</code> 。</span> </p></li>
|
||
</ul>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>mbsf</code> - 全新
|
||
<code>MBeanServerForwarder</code> 。
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果调用<a href="../../../javax/management/remote/MBeanServerForwarder.html#setMBeanServer-javax.management.MBeanServer-"><code>mbsf.setMBeanServer</code></a>失败与<code>IllegalArgumentException</code> 。</span>
|
||
<span>这包括<code>mbsf</code>为空的情况。</span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getConnectionIds--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getConnectionIds</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] getConnectionIds()</pre>
|
||
<div class="block">
|
||
<p>此连接器服务器当前打开的连接的ID列表。 </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>一个包含ID列表的新字符串数组。</span>
|
||
<span>如果没有当前打开的连接，该数组将为空。</span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getAddress--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getAddress</h4> <pre><a href="../../../javax/management/remote/JMXServiceURL.html" title="class in javax.management.remote">JMXServiceURL</a> getAddress()</pre>
|
||
<div class="block">
|
||
<p> <span>该连接器服务器的地址。</span> </p>
|
||
<p> <span>返回的地址可能不是创建连接器服务器时提供的原始<a href="../../../javax/management/remote/JMXServiceURL.html" title="javax.management.remote中的类"><code>JMXServiceURL</code></a> ，因为原始地址可能并不总是完成。</span> <span>例如，启动连接器服务器时可以动态分配端口号。</span> <span>相反，返回的地址是<a href="../../../javax/management/remote/JMXServiceURL.html" title="javax.management.remote中的类"><code>JMXConnectorServer</code></a>的实际<a href="../../../javax/management/remote/JMXConnectorServer.html" title="javax.management.remote中的类"><code>JMXServiceURL</code></a> 。</span> <span>这是客户提供给<a href="../../../javax/management/remote/JMXConnectorFactory.html#connect-javax.management.remote.JMXServiceURL-"><code>JMXConnectorFactory.connect(JMXServiceURL)</code></a>的地址。</span> </p>
|
||
<p> <span>需要注意的是返回的地址可能是<code>null</code>如果<code>JMXConnectorServer</code>尚未<a href="../../../javax/management/remote/JMXConnectorServerMBean.html#isActive--"><code>active</code></a> 。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
该连接器服务器的地址，如果没有，则为null。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getAttributes--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getAttributes</h4> <pre><a href="../../../java/util/Map.html" title="interface in java.util">Map</a><<a href="../../../java/lang/String.html" title="class in java.lang">String</a>,?> getAttributes()</pre>
|
||
<div class="block">
|
||
<p>此连接器服务器的属性。 </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>一个包含此连接器服务器属性的只读地图。</span>
|
||
<span>其值不可序列化的属性从该地图中省略。</span>
|
||
<span>如果没有可序列化的属性，返回的地图是空的。</span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="toJMXConnector-java.util.Map-">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>toJMXConnector</h4> <pre><a href="../../../javax/management/remote/JMXConnector.html" title="interface in javax.management.remote">JMXConnector</a> toJMXConnector(<a href="../../../java/util/Map.html" title="interface in java.util">Map</a><<a href="../../../java/lang/String.html" title="class in java.lang">String</a>,?> env)
|
||
throws <a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
|
||
<div class="block">
|
||
<p> <span>返回此连接器服务器的客户端存根。</span> <span>客户端存根是可串行化的对象，其<a href="../../../javax/management/remote/JMXConnector.html#connect-java.util.Map-"><code>connect</code></a>方法可用于与此连接器服务器建立一个新连接。</span> </p>
|
||
<p> <span>给定的连接器不需要支持生成客户端存根。</span> <span>但是，由JMX Remote API指定的连接器（JMXMP Connector和RMI Connector）。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>env</code> - 可以提供给<a href="../../../javax/management/remote/JMXConnector.html#connect-java.util.Map-"><code>JMXConnector.connect(Map)</code></a>的相同排序的客户端连接<a href="../../../javax/management/remote/JMXConnector.html#connect-java.util.Map-">参数</a> 。</span>
|
||
<span>可以为空，这相当于一个空的地图。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
客户端存根可用于与此连接器服务器建立新连接。
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果此连接器服务器不支持生成客户端存根。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果JMXConnectorServer未启动（请参阅
|
||
<a href="../../../javax/management/remote/JMXConnectorServerMBean.html#isActive--"><code>isActive()</code></a> ）。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果通信问题意味着无法创建存根。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |