mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-05 16:22:43 +08:00
178 lines
11 KiB
HTML
178 lines
11 KiB
HTML
<div class="header">
|
||
<div class="subTitle">
|
||
compact3
|
||
</div>
|
||
<div class="subTitle">
|
||
javax.management
|
||
</div>
|
||
<h2 class="title" title="Interface MBeanRegistration">Interface MBeanRegistration</h2>
|
||
</div><div class="contentContainer">
|
||
<div class="description">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<dl>
|
||
<dt>
|
||
所有已知实现类：
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../javax/management/monitor/CounterMonitor.html" title="javax.management.monitor中的类">CounterMonitor</a> ， <a href="../../javax/management/monitor/GaugeMonitor.html" title="javax.management.monitor中的类">GaugeMonitor</a> ， <a href="../../javax/management/remote/JMXConnectorServer.html" title="javax.management.remote中的类">JMXConnectorServer</a> ， <a href="../../javax/management/loading/MLet.html" title="javax.management.loading中的类">MLet</a> ， <a href="../../javax/management/monitor/Monitor.html" title="javax.management.monitor中的类">Monitor</a> ， <a href="../../javax/management/loading/PrivateMLet.html" title="javax.management.loading中的类">PrivateMLet</a> ， <a href="../../javax/management/relation/RelationService.html" title="javax.management.relation中的类">RelationService</a> ， <a href="../../javax/management/relation/RelationSupport.html" title="javax.management.relation中的类">RelationSupport</a> ， <a href="../../javax/management/modelmbean/RequiredModelMBean.html" title="javax.management.modelmbean中的类">RequiredModelMBean</a> ， <a href="../../javax/management/remote/rmi/RMIConnectorServer.html" title="javax.management.remote.rmi中的类">RMIConnectorServer</a> ， <a href="../../javax/management/StandardEmitterMBean.html" title="javax.management中的类">StandardEmitterMBean</a> ， <a href="../../javax/management/StandardMBean.html" title="javax.management中的类">StandardMBean</a> ， <a href="../../javax/management/monitor/StringMonitor.html" title="javax.management.monitor中的类">StringMonitor</a> ， <a href="../../javax/management/timer/Timer.html" title="javax.management.timer中的类">Timer</a></span>
|
||
</dd>
|
||
</dl>
|
||
<hr/> <br/> <pre>public interface <span class="typeNameLabel">MBeanRegistration</span></pre>
|
||
<div class="block">
|
||
<p> <span>可以由MBean实现，以便在从MBean服务器注册或注销之前和之后执行操作。</span> <span>MBean还可以实现此接口，以便引用该MBean服务器中的MBean服务器和/或其名称。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始：</span>
|
||
</dt>
|
||
<dd>
|
||
1.5
|
||
</dd>
|
||
</dl> </li>
|
||
</ul>
|
||
</div>
|
||
<div class="summary">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<!-- ========== METHOD SUMMARY =========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="method.summary">
|
||
<!-- --> </a> <h3>方法摘要</h3>
|
||
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
|
||
<caption>
|
||
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
|
||
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
|
||
<span class="tableTab" id="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
|
||
</caption>
|
||
<tbody>
|
||
<tr>
|
||
<th class="colFirst" scope="col">Modifier and Type</th>
|
||
<th class="colLast" scope="col">Method and Description</th>
|
||
</tr>
|
||
<tr class="altColor" id="i0">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanRegistration.html#postDeregister--">postDeregister</a></span>()</code>
|
||
<div class="block">
|
||
允许MBean在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/MBeanRegistration.html#postRegister-java.lang.Boolean-">postRegister</a></span>(<a href="../../java/lang/Boolean.html" title="class in java.lang">Boolean</a> registrationDone)</code>
|
||
<div class="block">
|
||
允许MBean在MBean服务器中注册或注册失败后执行所需的操作。
|
||
</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/MBeanRegistration.html#preDeregister--">preDeregister</a></span>()</code>
|
||
<div class="block">
|
||
允许MBean在MBean服务器取消注册之前执行所需的任何操作。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i3">
|
||
<td class="colFirst"><code><a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/MBeanRegistration.html#preRegister-javax.management.MBeanServer-javax.management.ObjectName-">preRegister</a></span>(<a href="../../javax/management/MBeanServer.html" title="interface in javax.management">MBeanServer</a> server, <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="preRegister-javax.management.MBeanServer-javax.management.ObjectName-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>preRegister</h4> <pre><a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> preRegister(<a href="../../javax/management/MBeanServer.html" title="interface in javax.management">MBeanServer</a> server,
|
||
<a href="../../javax/management/ObjectName.html" title="class in javax.management">ObjectName</a> name)
|
||
throws <a href="../../java/lang/Exception.html" title="class in java.lang">异常</a></pre>
|
||
<div class="block">
|
||
<span>允许MBean在MBean服务器注册之前执行所需的任何操作。</span>
|
||
<span>如果未指定MBean的名称，则MBean可以为其注册提供一个名称。</span>
|
||
<span>如果引发任何异常，MBean将不会在MBean服务器中注册。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>server</code> - MBean将在其中
|
||
<code>server</code>的MBean服务器。
|
||
</dd>
|
||
<dd>
|
||
<span><code>name</code> - MBean的对象名称。</span>
|
||
<span>此名称为null如果名称参数的一个<code>createMBean</code>或<code>registerMBean</code>方法在<a href="../../javax/management/MBeanServer.html" title="javax.management中的接口"><code>MBeanServer</code></a>接口为空。</span>
|
||
<span>在这种情况下，此方法必须为新的MBean返回非空的ObjectName。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>要注册MBean的名称。</span>
|
||
<span>此值不能为空。</span>
|
||
<span>如果<code>name</code>参数不为空，则通常不一定是返回值。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code><a href="../../java/lang/Exception.html" title="class in java.lang">异常</a></code> - 这个异常将被MBean服务器捕获，并重新抛出为<a href="../../javax/management/MBeanRegistrationException.html" title="javax.management中的类"><code>MBeanRegistrationException</code></a> 。</span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="postRegister-java.lang.Boolean-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>postRegister</h4> <pre>void postRegister(<a href="../../java/lang/Boolean.html" title="class in java.lang">Boolean</a> registrationDone)</pre>
|
||
<div class="block">
|
||
<span>允许MBean在MBean服务器中注册或注册失败后执行所需的操作。</span>
|
||
<p> <span>如果此方法的实现抛出一个<a href="../../java/lang/RuntimeException.html" title="java.lang中的类"><code>RuntimeException</code></a>或<a href="../../java/lang/Error.html" title="java.lang中的类"><code>Error</code></a> ，则MBean服务器的重新抛出那些内部<a href="../../javax/management/RuntimeMBeanException.html" title="javax.management中的类"><code>RuntimeMBeanException</code></a>或<a href="../../javax/management/RuntimeErrorException.html" title="javax.management中的类"><code>RuntimeErrorException</code></a>分别。</span> <span>但是，在postRegister中<code>postRegister</code>将不会更改MBean的状态：如果MBean已经注册（ <code>registrationDone</code>是<code>true</code> ），则MBean将保持注册。</span> </p>
|
||
<p> <span>这可能会导致代码调用<code>createMBean()</code>或<code>registerMBean()</code> ，因为这样的代码可能会假设MBean注册失败，当提出这样的异常。</span> <span>因此，如果可以避免，建议<code>postRegister</code>实现不会抛出运行时异常或错误。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>registrationDone</code> - 指示MBean服务器中MBean是否已成功注册。</span>
|
||
<span>值false表示注册阶段失败。</span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="preDeregister--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>preDeregister</h4> <pre>void preDeregister()
|
||
throws <a href="../../java/lang/Exception.html" title="class in java.lang">异常</a></pre>
|
||
<div class="block">
|
||
允许MBean在MBean服务器取消注册之前执行所需的任何操作。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code><a href="../../java/lang/Exception.html" title="class in java.lang">异常</a></code> - 此异常将被MBean服务器捕获，并重新抛出为<a href="../../javax/management/MBeanRegistrationException.html" title="javax.management中的类"><code>MBeanRegistrationException</code></a> 。</span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="postDeregister--">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>postDeregister</h4> <pre>void postDeregister()</pre>
|
||
<div class="block">
|
||
<span>允许MBean在MBean服务器中取消注册后执行所需的任何操作。</span>
|
||
<p> <span>如果此方法的实现抛出一个<a href="../../java/lang/RuntimeException.html" title="java.lang中的类"><code>RuntimeException</code></a>或<a href="../../java/lang/Error.html" title="java.lang中的类"><code>Error</code></a> ，则MBean服务器的重新抛出那些内部<a href="../../javax/management/RuntimeMBeanException.html" title="javax.management中的类"><code>RuntimeMBeanException</code></a>或<a href="../../javax/management/RuntimeErrorException.html" title="javax.management中的类"><code>RuntimeErrorException</code></a>分别。</span> <span>但是，在postDeregister中<code>postDeregister</code>将不会更改MBean的状态：MBean已经成功取消注册，并将保持不变。</span> </p>
|
||
<p> <span>这可能会使代码调用<code>unregisterMBean()</code> ，因为它可能会假设MBean注销失败。</span> <span>因此，如果可以避免，建议<code>postDeregister</code>实现不会抛出运行时异常或错误。</span> </p>
|
||
</div> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |