mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-06 17:25:01 +08:00
632 lines
34 KiB
HTML
632 lines
34 KiB
HTML
<div class="header">
|
||
<div class="subTitle">
|
||
compact3
|
||
</div>
|
||
<div class="subTitle">
|
||
javax.management.modelmbean
|
||
</div>
|
||
<h2 class="title" title="Interface ModelMBeanInfo">Interface ModelMBeanInfo</h2>
|
||
</div><div class="contentContainer">
|
||
<div class="description">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<dl>
|
||
<dt>
|
||
所有已知实现类:
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../javax/management/modelmbean/ModelMBeanInfoSupport.html" title="javax.management.modelmbean中的类">ModelMBeanInfoSupport</a></span>
|
||
</dd>
|
||
</dl>
|
||
<hr/> <br/> <pre>public interface <span class="typeNameLabel">ModelMBeanInfo</span></pre>
|
||
<div class="block">
|
||
<span>该接口由ModelMBeanInfo为每个ModelMBean实现。</span>
|
||
<span>每个JMX代理必须随附此接口的实现。</span>
|
||
<p> <span>希望可管理的Java资源使用MBeanServer的createMBean方法实例化ModelMBean。</span> <span>资源然后设置ModelMBean实例的ModelMBeanInfo和Descriptors。</span> <span>通过ModelMBean的ModelMBeanInfo公开的属性,操作和通知包括管理界面,可以从MBean,连接器/适配器(如其他MBean)访问。</span> <span>通过描述符,可以将托管应用程序中的值和方法定义并映射到ModelMBean的属性和操作。</span> <span>该映射可以在文件开发过程中定义,也可以在运行时以动态和编程方式进行定义。</span> </p>
|
||
<p> <span>在MBeanServer中实例化的每个ModelMBean变得可管理:其属性,操作和通知可以通过连接到该MBeanServer的连接器/适配器进行远程访问。</span> <span>除非是符合JMX的MBean,否则不能在MBeanServer中注册Java对象。</span> <span>通过实例化一个ModelMBean,资源保证MBean有效。</span> <span>必须在每个公共方法上抛出MBeanException和RuntimeOperationsException。</span> <span>这允许从分布式通信(RMI,EJB等)中包装异常</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="../../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/modelmbean/ModelMBeanInfo.html#clone--">clone</a></span>()</code>
|
||
<div class="block">
|
||
创建并返回此对象的副本。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i1">
|
||
<td class="colFirst"><code><a href="../../../javax/management/modelmbean/ModelMBeanAttributeInfo.html" title="class in javax.management.modelmbean">ModelMBeanAttributeInfo</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/modelmbean/ModelMBeanInfo.html#getAttribute-java.lang.String-">getAttribute</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> inName)</code>
|
||
<div class="block">
|
||
返回名称请求的ModelMBeanAttributeInfo。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i2">
|
||
<td class="colFirst"><code><a href="../../../javax/management/MBeanAttributeInfo.html" title="class in javax.management">MBeanAttributeInfo</a>[]</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/modelmbean/ModelMBeanInfo.html#getAttributes--">getAttributes</a></span>()</code>
|
||
<div class="block">
|
||
返回暴露给管理的属性列表。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i3">
|
||
<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/modelmbean/ModelMBeanInfo.html#getClassName--">getClassName</a></span>()</code>
|
||
<div class="block">
|
||
返回此
|
||
<code>MBeanInfo</code>的MBean的Java类的名称。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i4">
|
||
<td class="colFirst"><code><a href="../../../javax/management/MBeanConstructorInfo.html" title="class in javax.management">MBeanConstructorInfo</a>[]</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/modelmbean/ModelMBeanInfo.html#getConstructors--">getConstructors</a></span>()</code>
|
||
<div class="block">
|
||
返回MBean的公共构造函数的列表。
|
||
</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/modelmbean/ModelMBeanInfo.html#getDescription--">getDescription</a></span>()</code>
|
||
<div class="block">
|
||
返回MBean的可读描述。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i6">
|
||
<td class="colFirst"><code><a href="../../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/modelmbean/ModelMBeanInfo.html#getDescriptor-java.lang.String-java.lang.String-">getDescriptor</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> inDescriptorName, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> inDescriptorType)</code>
|
||
<div class="block">
|
||
返回由name和descriptorType请求的描述符。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i7">
|
||
<td class="colFirst"><code><a href="../../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a>[]</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/modelmbean/ModelMBeanInfo.html#getDescriptors-java.lang.String-">getDescriptors</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> inDescriptorType)</code>
|
||
<div class="block">
|
||
返回一个Descriptor数组,它由TypeDelegorType类型的ModelMBeanInfo的所有描述符组成。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i8">
|
||
<td class="colFirst"><code><a href="../../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/modelmbean/ModelMBeanInfo.html#getMBeanDescriptor--">getMBeanDescriptor</a></span>()</code>
|
||
<div class="block">
|
||
返回包含MBean宽策略的ModelMBean描述符。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i9">
|
||
<td class="colFirst"><code><a href="../../../javax/management/modelmbean/ModelMBeanNotificationInfo.html" title="class in javax.management.modelmbean">ModelMBeanNotificationInfo</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/modelmbean/ModelMBeanInfo.html#getNotification-java.lang.String-">getNotification</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> inName)</code>
|
||
<div class="block">
|
||
返回名称请求的ModelMBeanNotificationInfo。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i10">
|
||
<td class="colFirst"><code><a href="../../../javax/management/MBeanNotificationInfo.html" title="class in javax.management">MBeanNotificationInfo</a>[]</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/modelmbean/ModelMBeanInfo.html#getNotifications--">getNotifications</a></span>()</code>
|
||
<div class="block">
|
||
返回MBean发出的通知列表。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i11">
|
||
<td class="colFirst"><code><a href="../../../javax/management/modelmbean/ModelMBeanOperationInfo.html" title="class in javax.management.modelmbean">ModelMBeanOperationInfo</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/modelmbean/ModelMBeanInfo.html#getOperation-java.lang.String-">getOperation</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> inName)</code>
|
||
<div class="block">
|
||
返回名称请求的ModelMBeanOperationInfo。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i12">
|
||
<td class="colFirst"><code><a href="../../../javax/management/MBeanOperationInfo.html" title="class in javax.management">MBeanOperationInfo</a>[]</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/modelmbean/ModelMBeanInfo.html#getOperations--">getOperations</a></span>()</code>
|
||
<div class="block">
|
||
返回MBean的操作列表。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i13">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/modelmbean/ModelMBeanInfo.html#setDescriptor-javax.management.Descriptor-java.lang.String-">setDescriptor</a></span>(<a href="../../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a> inDescriptor, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> inDescriptorType)</code>
|
||
<div class="block">
|
||
在ModelMBean的类型为inDescriptorType的info数组中设置描述符。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i14">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/modelmbean/ModelMBeanInfo.html#setDescriptors-javax.management.Descriptor:A-">setDescriptors</a></span>(<a href="../../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a>[] inDescriptors)</code>
|
||
<div class="block">
|
||
在ModelMBeanInfo中添加或替换描述符。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i15">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/management/modelmbean/ModelMBeanInfo.html#setMBeanDescriptor-javax.management.Descriptor-">setMBeanDescriptor</a></span>(<a href="../../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a> inDescriptor)</code>
|
||
<div class="block">
|
||
设置ModelMBean的描述符。
|
||
</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="getDescriptors-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getDescriptors</h4> <pre><a href="../../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a>[] getDescriptors(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> inDescriptorType)
|
||
throws <a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
|
||
<a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></pre>
|
||
<div class="block">
|
||
返回一个Descriptor数组,它由TypeDelegorType类型的ModelMBeanInfo的所有描述符组成。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>inDescriptorType</code> - 必须为要返回的描述符设置的descriptorType字段的值。</span>
|
||
<span>必须是“mbean”,“属性”,“操作”,“构造函数”或“通知”。</span>
|
||
<span>如果为空或空,则将返回所有类型。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
描述符数组包含ModelMBean的所有描述符,如果键入inDescriptorType。
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - 包裹分布式通信异常。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 当descriptorType参数不是“mbean”,“attribute”,“operation”,“constructor”,“notification”,empty或null时,会包装一个IllegalArgumentException。
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/management/modelmbean/ModelMBeanInfo.html#setDescriptors-javax.management.Descriptor:A-"><code>setDescriptors(javax.management.Descriptor[])</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="setDescriptors-javax.management.Descriptor:A-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>setDescriptors</h4> <pre>void setDescriptors(<a href="../../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a>[] inDescriptors)
|
||
throws <a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
|
||
<a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></pre>
|
||
<div class="block">
|
||
在ModelMBeanInfo中添加或替换描述符。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>inDescriptors</code> - 要在ModelMBeanInfo中设置的描述符。</span>
|
||
<span>列表的空白元素将被忽略。</span>
|
||
<span>所有描述符必须具有名称和descriptorType字段。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 为null或无效描述符包装一个IllegalArgumentException。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - 包装分布式通信异常。
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/management/modelmbean/ModelMBeanInfo.html#getDescriptors-java.lang.String-"><code>getDescriptors(java.lang.String)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getDescriptor-java.lang.String-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getDescriptor</h4> <pre><a href="../../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a> getDescriptor(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> inDescriptorName,
|
||
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> inDescriptorType)
|
||
throws <a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
|
||
<a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></pre>
|
||
<div class="block">
|
||
返回由name和descriptorType请求的描述符。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>inDescriptorName</code> - 描述
|
||
<code>inDescriptorName</code>的名称。
|
||
</dd>
|
||
<dd>
|
||
<span><code>inDescriptorType</code> - 正在请求的描述符的类型。</span>
|
||
<span>如果这是空或空,则搜索所有类型。</span>
|
||
<span>有效的类型是'mbean','attribute','constructor''operation'和'notification'。</span>
|
||
<span>该值将等于返回的描述符中的“descriptorType”字段。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>描述符包含具有相同名称和descriptorType的ModelMBean的描述符。</span>
|
||
<span>如果没有找到描述符,则返回null。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - 包装分布式通信异常。
|
||
</dd>
|
||
<dd>
|
||
<span><code><a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 为null描述符名称或空值或无效类型包装IllegalArgumentException。</span>
|
||
<span>类型必须是“mbean”,“attribute”,“constructor”,“operation”或“notification”。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/management/modelmbean/ModelMBeanInfo.html#setDescriptor-javax.management.Descriptor-java.lang.String-"><code>setDescriptor(javax.management.Descriptor, java.lang.String)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="setDescriptor-javax.management.Descriptor-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>setDescriptor</h4> <pre>void setDescriptor(<a href="../../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a> inDescriptor,
|
||
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> inDescriptorType)
|
||
throws <a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
|
||
<a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></pre>
|
||
<div class="block">
|
||
<span>在ModelMBean的类型为inDescriptorType的info数组中设置描述符。</span>
|
||
<span>将调用相应ModelMBean * Info的setDescriptor方法来设置指定的描述符。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>inDescriptor</code> - 要在ModelMBean中设置的描述符。</span>
|
||
<span>它不能为空。</span>
|
||
<span>所有描述符必须具有名称和descriptorType字段。</span>
|
||
</dd>
|
||
<dd>
|
||
<span><code>inDescriptorType</code> - 要设置的描述符的类型。</span>
|
||
<span>如果这是空值,则使用描述符中的descriptorType字段。</span>
|
||
<span>如果指定,则必须在描述符的descriptorType字段中设置此值。</span>
|
||
<span>必须是“mbean”,“属性”,“构造函数”,“操作”或“通知”。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 为非法或空参数包装一个IllegalArgumentException,或者如果在相应的MBeanAttributeInfo或MBeanConstructorInfo或MBeanNotificationInfo或MBeanOperationInfo中找不到描述符的名称字段。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - 包装分布式通信异常。
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/management/modelmbean/ModelMBeanInfo.html#getDescriptor-java.lang.String-java.lang.String-"><code>getDescriptor(java.lang.String, java.lang.String)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getMBeanDescriptor--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getMBeanDescriptor</h4> <pre><a href="../../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a> getMBeanDescriptor()
|
||
throws <a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
|
||
<a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></pre>
|
||
<div class="block">
|
||
<p> <span>返回包含MBean宽策略的ModelMBean描述符。</span> <span>此描述符包含有关MBean的元数据和用于持久性和缓存的默认策略。</span> </p>
|
||
<p id="descriptor"> <span>描述符中的字段被定义为但不限于以下内容。</span> <span>请注意,当该表中的Type为Number时,也可以使用Long的十进制表示形式的String。</span> </p>
|
||
<span> Name Type Meaning name String MBean name. descriptorType String Must be "mbean". displayName String Name of MBean to be used in displays. persistPolicy String One of: OnUpdate|OnTimer|NoMoreOftenThan|OnUnregister|Always|Never. See the section "MBean Descriptor Fields" in the JMX specification document. persistLocation String The fully qualified directory name where the MBean should be persisted (if appropriate). persistFile String File name into which the MBean should be persisted. persistPeriod Number Frequency of persist cycle in seconds, for OnTime and NoMoreOftenThan PersistPolicy currencyTimeLimit Number How long cached value is valid: <0 never, =0 always, >0 seconds. log String t: log all notifications, f: log no notifications. logfile String Fully qualified filename to log events to. visibility Number 1-4 where 1: always visible 4: rarely visible. export String Name to be used to export/expose this MBean so that it is findable by other JMX Agents. presentationString String XML formatted string to allow presentation of data to be associated with the MBean. </span>
|
||
<table border="1" cellpadding="5" summary="ModelMBean Fields">
|
||
</table>
|
||
<p> <span>默认描述符是:name = className,descriptorType =“mbean”,displayName = className,persistPolicy =“never”,log =“F”,visibility =“1”如果描述符不包含所有这些字段,具有这些默认值。</span> </p>
|
||
<p> <span><b>注:</b>由于与此规范的以前版本不一致,建议不要使用负值或零值<code>currencyTimeLimit</code> 。</span> <span>要指示缓存值永远无效,请省略<code>currencyTimeLimit</code>字段。</span> <span>要指示它始终有效,请为此字段使用非常大的数字。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
MBean描述符。
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - 包装分布式通信异常。
|
||
</dd>
|
||
<dd>
|
||
<span><code><a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 获得<a href="../../../java/lang/RuntimeException.html" title="java.lang中的类">描述符</a>时发生<code>RuntimeException</code>。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/management/modelmbean/ModelMBeanInfo.html#setMBeanDescriptor-javax.management.Descriptor-"><code>setMBeanDescriptor(javax.management.Descriptor)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="setMBeanDescriptor-javax.management.Descriptor-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>setMBeanDescriptor</h4> <pre>void setMBeanDescriptor(<a href="../../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a> inDescriptor)
|
||
throws <a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
|
||
<a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></pre>
|
||
<div class="block">
|
||
<span>设置ModelMBean的描述符。</span>
|
||
<span>此描述符包含有关MBean的默认MBean宽元数据以及持久性和缓存的默认策略。</span>
|
||
<span>此操作完全替换描述符,不进行合并。</span>
|
||
<span>如果要设置的描述符为null,则将创建默认描述符。</span>
|
||
<span>默认描述符是:name = className,descriptorType =“mbean”,displayName = className,persistPolicy =“never”,log =“F”,visibility =“1”如果描述符不包含所有这些字段,具有这些默认值。</span>
|
||
<span>有关字段名称的描述,请参阅<a href="../../../javax/management/modelmbean/ModelMBeanInfo.html#getMBeanDescriptor--"><code>getMBeanDescriptor</code></a>方法javadoc。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>inDescriptor</code> - 要设置的描述符。
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - 包装分布式通信异常。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 为无效描述符包装一个IllegalArgumentException。
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/management/modelmbean/ModelMBeanInfo.html#getMBeanDescriptor--"><code>getMBeanDescriptor()</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getAttribute-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getAttribute</h4> <pre><a href="../../../javax/management/modelmbean/ModelMBeanAttributeInfo.html" title="class in javax.management.modelmbean">ModelMBeanAttributeInfo</a> getAttribute(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> inName)
|
||
throws <a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
|
||
<a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></pre>
|
||
<div class="block">
|
||
返回名称请求的ModelMBeanAttributeInfo。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>inName</code> - 要获取的ModelMBeanAttributeInfo的名称。</span>
|
||
<span>如果此名称不存在ModelMBeanAttributeInfo,则返回null。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
命名属性的属性信息,如果没有,则为null。
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - 包裹分布式通信异常。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 为null属性名称包装一个IllegalArgumentException。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getOperation-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getOperation</h4> <pre><a href="../../../javax/management/modelmbean/ModelMBeanOperationInfo.html" title="class in javax.management.modelmbean">ModelMBeanOperationInfo</a> getOperation(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> inName)
|
||
throws <a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
|
||
<a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></pre>
|
||
<div class="block">
|
||
返回名称请求的ModelMBeanOperationInfo。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>inName</code> - 要获取的ModelMBeanOperationInfo的名称。</span>
|
||
<span>如果此名称不存在ModelMBeanOperationInfo,则返回null。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
命名操作的操作信息,如果没有,则为null。
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - 包装分布式通信异常。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 为空操作名称包装一个IllegalArgumentException。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getNotification-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getNotification</h4> <pre><a href="../../../javax/management/modelmbean/ModelMBeanNotificationInfo.html" title="class in javax.management.modelmbean">ModelMBeanNotificationInfo</a> getNotification(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> inName)
|
||
throws <a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a>,
|
||
<a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></pre>
|
||
<div class="block">
|
||
返回名称请求的ModelMBeanNotificationInfo。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>inName</code> - 要获取的ModelMBeanNotificationInfo的名称。</span>
|
||
<span>如果此名称不存在ModelMBeanNotificationInfo,则返回null。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
命名通知的信息,如果没有,则返回null。
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../javax/management/MBeanException.html" title="class in javax.management">MBeanException</a></code> - 包裹分布式通信异常。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 为null通知名称包装一个IllegalArgumentException。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="clone--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>clone</h4> <pre><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> clone()</pre>
|
||
<div class="block">
|
||
创建并返回此对象的副本。
|
||
</div> </li>
|
||
</ul> <a name="getAttributes--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getAttributes</h4> <pre><a href="../../../javax/management/MBeanAttributeInfo.html" title="class in javax.management">MBeanAttributeInfo</a>[] getAttributes()</pre>
|
||
<div class="block">
|
||
<span>返回暴露给管理的属性列表。</span>
|
||
<span>每个属性由<code>MBeanAttributeInfo</code>对象描述。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<code>MBeanAttributeInfo</code>对象的数组。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getClassName--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getClassName</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getClassName()</pre>
|
||
<div class="block">
|
||
返回此
|
||
<code>MBeanInfo</code>的MBean的Java类的名称。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
Java类名。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getConstructors--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getConstructors</h4> <pre><a href="../../../javax/management/MBeanConstructorInfo.html" title="class in javax.management">MBeanConstructorInfo</a>[] getConstructors()</pre>
|
||
<div class="block">
|
||
<span>返回MBean的公共构造函数的列表。</span>
|
||
<span>每个构造函数由<code>MBeanConstructorInfo</code>对象描述。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
一组
|
||
<code>MBeanConstructorInfo</code>对象。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getDescription--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getDescription</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getDescription()</pre>
|
||
<div class="block">
|
||
返回MBean的可读描述。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
说明。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getNotifications--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getNotifications</h4> <pre><a href="../../../javax/management/MBeanNotificationInfo.html" title="class in javax.management">MBeanNotificationInfo</a>[] getNotifications()</pre>
|
||
<div class="block">
|
||
<span>返回MBean发出的通知列表。</span>
|
||
<span>每个通知由<code>MBeanNotificationInfo</code>对象描述。</span>
|
||
<p> <span>除了应用程序指定的任何通知之外,ModelMBean还可能会同时发送两个附加通知:</span> </p>
|
||
<ul>
|
||
<li> <span>一个描述符名称“GENERIC”和displayName“jmx.modelmbean.generic”</span> </li>
|
||
<li> <span>二是具有描述符名称“ATTRIBUTE_CHANGE”和displayName“jmx.attribute.change”的标准属性更改通知</span> </li>
|
||
</ul>
|
||
<span>因此,ModelMBeanInfo的任何实现应始终添加除应用程序指定的那些通知之外的两个通知。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
一组
|
||
<code>MBeanNotificationInfo</code>对象。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getOperations--">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>getOperations</h4> <pre><a href="../../../javax/management/MBeanOperationInfo.html" title="class in javax.management">MBeanOperationInfo</a>[] getOperations()</pre>
|
||
<div class="block">
|
||
<span>返回MBean的操作列表。</span>
|
||
<span>每个操作由<code>MBeanOperationInfo</code>对象描述。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<code>MBeanOperationInfo</code>对象的数组。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |