uTools-Manuals/docs/java/javax/management/ImmutableDescriptor.html

<div class="header">
<div class="subTitle">
     compact3 
   </div>
<div class="subTitle">
     javax.management 
   </div>
<h2 class="title" title="Class ImmutableDescriptor">Class ImmutableDescriptor</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.ImmutableDescriptor</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/Serializable.html" title="java.io中的接口">Serializable</a> ， <a href="../../java/lang/Cloneable.html" title="java.lang中的接口">Cloneable</a> ， <a href="../../javax/management/Descriptor.html" title="javax.management中的接口">Descriptor</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public class <span class="typeNameLabel">ImmutableDescriptor</span>
extends <a href="../../java/lang/Object.html" title="class in java.lang">Object</a>
implements <a href="../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a></pre>
<div class="block">
        一个不可变的描述符。 
      </div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
         1.6 
       </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../serialized-form.html#javax.management.ImmutableDescriptor">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>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Field Summary table, listing fields, and an explanation">
<caption>
<span>Fields</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Field and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static <a href="../../javax/management/ImmutableDescriptor.html" title="class in javax.management">ImmutableDescriptor</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/ImmutableDescriptor.html#EMPTY_DESCRIPTOR">EMPTY_DESCRIPTOR</a></span></code>
<div class="block">
              一个空描述符。 
            </div> </td>
</tr>
</tbody>
</table> </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/ImmutableDescriptor.html#ImmutableDescriptor-java.util.Map-">ImmutableDescriptor</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; fields)</code>
<div class="block">
              构造描述符，其中字段的名称和值是给定Map的键和值。 
            </div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../javax/management/ImmutableDescriptor.html#ImmutableDescriptor-java.lang.String...-">ImmutableDescriptor</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a>... fields)</code>
<div class="block">
              构造一个包含给定字段的描述符。 
            </div> </td>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../javax/management/ImmutableDescriptor.html#ImmutableDescriptor-java.lang.String:A-java.lang.Object:A-">ImmutableDescriptor</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a>[] fieldNames, <a href="../../java/lang/Object.html" title="class in java.lang">Object</a>[] fieldValues)</code>
<div class="block">
              构造一个包含给定字段和值的描述符。 
            </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="t1"><span><a href="javascript:show(1);">静态方法</a></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><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/ImmutableDescriptor.html#clone--">clone</a></span>()</code>
<div class="block">
              返回一个等于该描述符的描述符。 
            </div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/ImmutableDescriptor.html#equals-java.lang.Object-">equals</a></span>(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> o)</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/ImmutableDescriptor.html#getFieldNames--">getFieldNames</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/ImmutableDescriptor.html#getFields--">getFields</a></span>()</code>
<div class="block">
              以字符串数组的形式返回此描述符中包含的所有字段。 
            </div> </td>
</tr>
<tr class="altColor" id="i4">
<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/ImmutableDescriptor.html#getFieldValue-java.lang.String-">getFieldValue</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> fieldName)</code>
<div class="block">
              返回特定字段名称的值，如果该名称没有值，则返回null。 
            </div> </td>
</tr>
<tr class="rowColor" id="i5">
<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/ImmutableDescriptor.html#getFieldValues-java.lang.String...-">getFieldValues</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a>... fieldNames)</code>
<div class="block">
              将描述符中的所有字段值作为对象数组返回。 
            </div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/ImmutableDescriptor.html#hashCode--">hashCode</a></span>()</code>
<div class="block">
              返回此描述符的哈希码值。 
            </div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/ImmutableDescriptor.html#isValid--">isValid</a></span>()</code>
<div class="block">
              如果所有字段都具有给定名称的合法值，则返回true。 
            </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/ImmutableDescriptor.html#removeField-java.lang.String-">removeField</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> fieldName)</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/ImmutableDescriptor.html#setField-java.lang.String-java.lang.Object-">setField</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> fieldName, <a href="../../java/lang/Object.html" title="class in java.lang">Object</a> fieldValue)</code>
<div class="block">
              此操作不受支持，因为此类是不可变的。 
            </div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/ImmutableDescriptor.html#setFields-java.lang.String:A-java.lang.Object:A-">setFields</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a>[] fieldNames, <a href="../../java/lang/Object.html" title="class in java.lang">Object</a>[] fieldValues)</code>
<div class="block">
              此操作不受支持，因为此类是不可变的。 
            </div> </td>
</tr>
<tr class="rowColor" id="i11">
<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/ImmutableDescriptor.html#toString--">toString</a></span>()</code>
<div class="block">
              返回对象的字符串表示形式。 
            </div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code>static <a href="../../javax/management/ImmutableDescriptor.html" title="class in javax.management">ImmutableDescriptor</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/management/ImmutableDescriptor.html#union-javax.management.Descriptor...-">union</a></span>(<a href="../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a>... descriptors)</code>
<div class="block">
              返回一个 
             <code>ImmutableDescriptor</code> ，其内容是给定描述符的并集。 
            </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#finalize--">finalize</a>, <a href="../../java/lang/Object.html#getClass--">getClass</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">
<!-- ============ FIELD DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.detail">
<!-- --> </a> <h3>字段详细信息</h3> <a name="EMPTY_DESCRIPTOR">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>EMPTY_DESCRIPTOR</h4> <pre>public static final <a href="../../javax/management/ImmutableDescriptor.html" title="class in javax.management">ImmutableDescriptor</a> EMPTY_DESCRIPTOR</pre>
<div class="block">
            一个空描述符。 
          </div> </li>
</ul> </li>
</ul>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="ImmutableDescriptor-java.lang.String:A-java.lang.Object:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>ImmutableDescriptor</h4> <pre>public ImmutableDescriptor(<a href="../../java/lang/String.html" title="class in java.lang">String</a>[] fieldNames,
                           <a href="../../java/lang/Object.html" title="class in java.lang">Object</a>[] fieldValues)</pre>
<div class="block">
            构造一个包含给定字段和值的描述符。 
          </div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果任一数组为空，或者数组的大小不同，或者字段名称为空或为空，或者同一个字段名称多次出现。 
           </dd>
</dl> </li>
</ul> <a name="ImmutableDescriptor-java.lang.String...-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>ImmutableDescriptor</h4> <pre>public ImmutableDescriptor(<a href="../../java/lang/String.html" title="class in java.lang">String</a>... fields)</pre>
<div class="block">
<span>构造一个包含给定字段的描述符。</span>
<span>每个字符串的格式必须为<code>fieldName=fieldValue</code> 。</span>
<span>字段名称以第<code>=</code>字符结尾;</span>
<span>例如，如果字符串为<code>a=b=c</code>则字段名称为<code>a</code> ，其值为<code>b=c</code> 。</span>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果参数为空，或者字段名称为空，或者同一个字段名称多次出现，或者其中一个字符串不包含 
            <code>=</code>字符。 
           </dd>
</dl> </li>
</ul> <a name="ImmutableDescriptor-java.util.Map-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>ImmutableDescriptor</h4> <pre>public ImmutableDescriptor(<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; fields)</pre>
<div class="block">
<p>构造描述符，其中字段的名称和值是给定Map的键和值。 </p>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果参数为空，或者字段名称为空或为空，或者同一个字段名称多次出现（由于字段名不区分大小写）。 
           </dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="union-javax.management.Descriptor...-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>union</h4> <pre>public static <a href="../../javax/management/ImmutableDescriptor.html" title="class in javax.management">ImmutableDescriptor</a> union(<a href="../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a>... descriptors)</pre>
<div class="block">
<p> <span>返回一个<code>ImmutableDescriptor</code> ，其内容是给定描述符的并集。</span> <span>任何描述符中出现的每个字段名称都将显示在结果中，该方法具有调用该方法时的值。</span> <span>任何描述符的后续更改不会影响此处返回的ImmutableDescriptor。</span> </p>
<p> <span>在最简单的情况下，只有一个描述符，返回的<code>ImmutableDescriptor</code>是在调用此方法时的字段的副本：</span> </p>
<pre>  <span>Descriptor d = something();
 ImmutableDescriptor copy = ImmutableDescriptor.union(d);</span> </pre>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>descriptors</code> - 要组合的描述符。</span>
<span>任何描述符都可以为null，在这种情况下，它将被跳过。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>一个<code>ImmutableDescriptor</code>是给定描述符的并集。</span>
<span>如果返回的对象可能与其中一个输入描述符相同，如果它是包含所有必填字段的ImmutableDescriptor。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果两个描述符包含具有不同关联值的相同字段名称。</span>
<span>如果原始数组值与相同的元素具有相同的类型，则它们被认为是相同的。</span>
<span>如果<a href="../../java/util/Arrays.html#deepEquals-java.lang.Object:A-java.lang.Object:A-"><code>Arrays.deepEquals(Object[],Object[])</code></a>返回true，对象数组值将被视为相同。</span>
</dd>
</dl> </li>
</ul> <a name="getFieldValue-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getFieldValue</h4> <pre>public final <a href="../../java/lang/Object.html" title="class in java.lang">Object</a> getFieldValue(<a href="../../java/lang/String.html" title="class in java.lang">String</a> fieldName)</pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../javax/management/Descriptor.html#getFieldValue-java.lang.String-">Descriptor</a></code>复制</span>
</div>
<div class="block">
            返回特定字段名称的值，如果该名称没有值，则返回null。 
          </div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/management/Descriptor.html#getFieldValue-java.lang.String-">getFieldValue</a></code>在界面 
            <code><a href="../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>fieldName</code> - 字段名称。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             相应的值，如果该字段不存在，则返回null。 
           </dd>
</dl> </li>
</ul> <a name="getFields--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getFields</h4> <pre>public final <a href="../../java/lang/String.html" title="class in java.lang">String</a>[] getFields()</pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../javax/management/Descriptor.html#getFields--">Descriptor</a></code>复制</span>
</div>
<div class="block">
            以字符串数组的形式返回此描述符中包含的所有字段。 
          </div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/management/Descriptor.html#getFields--">getFields</a></code>在界面 
            <code><a href="../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>字符串数组的字段格式为<i>fieldName = fieldValue</i></span>
<br/>
<span>如果字段的值不是String，那么将调用toString（）方法，并将包含在括号中的返回值用作返回数组中字段的值。</span>
<span>如果一个字段的值为null，那么返回的数组中的字段的值将为空。</span>
<span>如果描述符为空，您将获得一个空数组。</span>
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/management/Descriptor.html#setFields-java.lang.String:A-java.lang.Object:A-"><code>Descriptor.setFields(java.lang.String[], java.lang.Object[])</code></a>
</dd>
</dl> </li>
</ul> <a name="getFieldValues-java.lang.String...-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getFieldValues</h4> <pre>public final <a href="../../java/lang/Object.html" title="class in java.lang">Object</a>[] getFieldValues(<a href="../../java/lang/String.html" title="class in java.lang">String</a>... fieldNames)</pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../javax/management/Descriptor.html#getFieldValues-java.lang.String...-">Descriptor</a></code>复制</span>
</div>
<div class="block">
<span>将描述符中的所有字段值作为对象数组返回。</span>
<span>返回的值与<code>fieldNames</code> String数组参数的顺序相同。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/management/Descriptor.html#getFieldValues-java.lang.String...-">getFieldValues</a></code>在界面 
            <code><a href="../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>fieldNames</code> - 应返回值的字段名称的字符串数组。</span>
<span>如果数组为空，那么将返回一个空数组。</span>
<span>如果数组为空，那么将返回所有值，就像该参数是由<a href="../../javax/management/Descriptor.html#getFieldNames--"><code>Descriptor.getFieldNames()</code></a>返回的数组<a href="../../javax/management/Descriptor.html#getFieldNames--">一样</a> 。</span>
<span>如果数组中的字段名称不存在，包括其为空或空字符串的情况，那么返回的匹配数组元素将返回null。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>字段值的对象数组。</span>
<span>如果<code>fieldNames</code>的列表为空，您将获得一个空数组。</span>
</dd>
</dl> </li>
</ul> <a name="getFieldNames--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getFieldNames</h4> <pre>public final <a href="../../java/lang/String.html" title="class in java.lang">String</a>[] getFieldNames()</pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../javax/management/Descriptor.html#getFieldNames--">Descriptor</a></code>复制</span>
</div>
<div class="block">
            返回描述符中的所有字段名。 
          </div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/management/Descriptor.html#getFieldNames--">getFieldNames</a></code>在界面 
            <code><a href="../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>字符串数组字段名称。</span>
<span>如果描述符为空，您将获得一个空数组。</span>
</dd>
</dl> </li>
</ul> <a name="equals-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>equals</h4> <pre>public boolean equals(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> o)</pre>
<div class="block">
<span>将此描述符与给定对象进行比较。</span>
<span>如果给定的对象也是描述符，并且两个描述符具有相同的字段名称（可能在不同情况下）和相同的关联值，则对象是相等的。</span>
<span>如果满足以下条件，两个描述符中的字段的相应值相等：</span>
<ul>
<li> <span>如果一个值为null，那么另一个值也是。</span> </li>
<li> <span>如果一个值是原始数组，则另一个值必须是具有相同元素的相同类型的原始数组。</span> </li>
<li> <span>如果一个值是一个对象数组，那么另一个值必须也是，并且<a href="../../java/util/Arrays.html#deepEquals-java.lang.Object:A-java.lang.Object:A-"><code>Arrays.deepEquals(Object[],Object[])</code></a>必须返回true。</span> </li>
<li> <span>否则<a href="../../java/lang/Object.html#equals-java.lang.Object-"><code>Object.equals(Object)</code></a>必须返回true。</span> </li>
</ul>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/management/Descriptor.html#equals-java.lang.Object-">equals</a></code>在接口 
            <code><a href="../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a></code>
</dd>
<dt>
<span class="overrideSpecifyLabel">重写：</span>
</dt>
<dd>
<code><a href="../../java/lang/Object.html#equals-java.lang.Object-">equals</a></code>在 
            <code><a href="../../java/lang/Object.html" title="class in java.lang">Object</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>o</code> - 要比较的对象。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span><code>true</code>如果对象是一样的;</span>
<span><code>false</code>否则。</span>
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../java/lang/Object.html#hashCode--"><code>Object.hashCode()</code></a> ， <a href="../../java/util/HashMap.html" title="java.util中的类"><code>HashMap</code></a></span>
</dd>
</dl> </li>
</ul> <a name="hashCode--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>hashCode</h4> <pre>public int hashCode()</pre>
<div class="block">
<p> <span>返回此描述符的哈希码值。</span> <span>哈希码被计算为描述符中每个字段的哈希码的和。</span> <span>名称为<code>n</code> ，值为<code>v</code>的字段的哈希码为<code>n.toLowerCase().hashCode() ^ h</code> 。</span> <span>这里<code>h</code>是哈希码<code>v</code> ，计算如下：</span> </p>
<ul>
<li> <span>如果<code>v</code>为null，则<code>h</code>为0。</span> </li>
<li> <span>如果<code>v</code>是基本类型数组然后<code>h</code>使用的适当重载来计算的<code>java.util.Arrays.hashCode</code> 。</span> </li>
<li> <span>如果<code>v</code>是一个对象数组然后<code>h</code>使用计算<a href="../../java/util/Arrays.html#deepHashCode-java.lang.Object:A-"><code>Arrays.deepHashCode(Object[])</code></a> 。</span> </li>
<li> <span>否则<code>h</code>是<code>v.hashCode()</code> 。</span> </li>
</ul>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/management/Descriptor.html#hashCode--">hashCode</a></code>在接口 
            <code><a href="../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a></code>
</dd>
<dt>
<span class="overrideSpecifyLabel">重写：</span>
</dt>
<dd>
<code><a href="../../java/lang/Object.html#hashCode--">hashCode</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>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../java/lang/Object.html#equals-java.lang.Object-"><code>Object.equals(java.lang.Object)</code></a> ， 
            <a href="../../java/lang/System.html#identityHashCode-java.lang.Object-"><code>System.identityHashCode(java.lang.Object)</code></a>
</dd>
</dl> </li>
</ul> <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">
<span class="descfrmTypeLabel">描述从类别复制： <code><a href="../../java/lang/Object.html#toString--">Object</a></code></span>
</div>
<div class="block">
<span>返回对象的字符串表示形式。</span>
<span>一般来说， <code>toString</code>方法返回一个“textually代表”这个对象的字符串。</span>
<span>结果应该是一个简明扼要的表达，容易让人阅读。</span>
<span>建议所有子类覆盖此方法。</span>
<p> <span>该<code>toString</code>类方法<code>Object</code>返回一个由其中的对象是一个实例，该符号字符`的类的名称的字符串<code>@</code> ”和对象的哈希码的无符号的十六进制表示。</span> <span>换句话说，这个方法返回一个等于下列值的字符串：</span> </p>
<blockquote>
<span><pre>
 getClass().getName() + '@' + Integer.toHexString(hashCode())
 </pre></span>
</blockquote>
</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="isValid--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isValid</h4> <pre>public boolean isValid()</pre>
<div class="block">
<span>如果所有字段都具有给定名称的合法值，则返回true。</span>
<span>此方法总是返回true，但是子类可以覆盖它，以在适当时返回false。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/management/Descriptor.html#isValid--">isValid</a></code>在界面 
            <code><a href="../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             如果值合法，则为真。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 如果有效性检查失败。</span>
<span>如果描述符无效，该方法返回false，但如果尝试确定有效性失败，则返回此异常。</span>
</dd>
</dl> </li>
</ul> <a name="clone--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>clone</h4> <pre>public <a href="../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a> clone()</pre>
<div class="block">
<p> <span>返回一个等于该描述符的描述符。</span> <span>返回的描述符的更改对此描述符没有影响，反之亦然。</span> </p>
<p> <span>此方法返回调用它的对象。</span> <span>一个子类可以覆盖它，以返回另一个对象，只要合同得到尊重。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/management/Descriptor.html#clone--">clone</a></code>在界面 
            <code><a href="../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a></code>
</dd>
<dt>
<span class="overrideSpecifyLabel">重写：</span>
</dt>
<dd>
<code><a href="../../java/lang/Object.html#clone--">clone</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>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 用于字段名称或字段值的非法值。</span>
<span>如果由于任何原因描述符构造失败，将抛出此异常。</span>
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../java/lang/Cloneable.html" title="java.lang中的接口"><code>Cloneable</code></a></span>
</dd>
</dl> </li>
</ul> <a name="setFields-java.lang.String:A-java.lang.Object:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setFields</h4> <pre>public final void setFields(<a href="../../java/lang/String.html" title="class in java.lang">String</a>[] fieldNames,
                            <a href="../../java/lang/Object.html" title="class in java.lang">Object</a>[] fieldValues)
                     throws <a href="../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></pre>
<div class="block">
<span>此操作不受支持，因为此类是不可变的。</span>
<span>如果此调用将改变具有相同内容的可变描述<a href="../../java/lang/UnsupportedOperationException.html" title="java.lang中的类">符</a> ，则会抛出一个<a href="../../javax/management/RuntimeOperationsException.html" title="javax.management中的类"><code>UnsupportedOperationException</code></a>的<a href="../../java/lang/UnsupportedOperationException.html" title="java.lang中的类"><code>UnsupportedOperationException</code></a> 。</span>
<span>否则，行为与可变描述符相同：由于非法参数引起异常，或者没有任何效果。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/management/Descriptor.html#setFields-java.lang.String:A-java.lang.Object:A-">setFields</a></code>在界面 
            <code><a href="../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>fieldNames</code> - 字段名称的字符串数组。</span>
<span>数组和数组元素不能为空。</span>
</dd>
<dd>
<span><code>fieldValues</code> - 相应字段值的对象数组。</span>
<span>数组不能为null。</span>
<span>数组的元素可以为空。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 如果由于任何原因更改失败。</span>
<span>如果<code>fieldNames</code>或<code>fieldValues</code>为空，或者如果数组的长度不同，或者其中一个中存在非法值，则包装的异常为<a href="../../java/lang/IllegalArgumentException.html" title="java.lang中的类"><code>IllegalArgumentException</code></a> 。</span>
<span>包装的异常是<a href="../../java/lang/UnsupportedOperationException.html" title="java.lang中的类"><code>UnsupportedOperationException</code></a>如果描述符是不可变的，而调用将更改其内容。</span>
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/management/Descriptor.html#getFields--"><code>Descriptor.getFields()</code></a>
</dd>
</dl> </li>
</ul> <a name="setField-java.lang.String-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setField</h4> <pre>public final void setField(<a href="../../java/lang/String.html" title="class in java.lang">String</a> fieldName,
                           <a href="../../java/lang/Object.html" title="class in java.lang">Object</a> fieldValue)
                    throws <a href="../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></pre>
<div class="block">
<span>此操作不受支持，因为此类是不可变的。</span>
<span>如果此调用将改变具有相同内容的可变描述符，则抛出一个<a href="../../javax/management/RuntimeOperationsException.html" title="javax.management中的类"><code>RuntimeOperationsException</code></a>包装<a href="../../java/lang/UnsupportedOperationException.html" title="java.lang中的类"><code>UnsupportedOperationException</code></a> 。</span>
<span>否则，行为与可变描述符相同：由于非法参数引起异常，或者没有任何效果。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/management/Descriptor.html#setField-java.lang.String-java.lang.Object-">setField</a></code>在界面 
            <code><a href="../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>fieldName</code> - 要设置的字段名称。</span>
<span>不能为null或为空。</span>
</dd>
<dd>
<span><code>fieldValue</code> - 要为字段名称设置的字段值。</span>
<span>如果该值是该字段的有效值，则可以为null。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - 如果字段名称或字段值是非法的（包装异常是<a href="../../java/lang/IllegalArgumentException.html" title="java.lang中的类"><code>IllegalArgumentException</code></a> ）;</span>
<span>或者如果描述符是不可变的（包装异常是<a href="../../java/lang/UnsupportedOperationException.html" title="java.lang中的类"><code>UnsupportedOperationException</code></a> ）。</span>
</dd>
</dl> </li>
</ul> <a name="removeField-java.lang.String-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>removeField</h4> <pre>public final void removeField(<a href="../../java/lang/String.html" title="class in java.lang">String</a> fieldName)</pre>
<div class="block">
            从描述符中删除一个字段。 
          </div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/management/Descriptor.html#removeField-java.lang.String-">removeField</a></code>在接口 
            <code><a href="../../javax/management/Descriptor.html" title="interface in javax.management">Descriptor</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>fieldName</code> - 要删除的字段的字符串名称。</span>
<span>如果字段名称是非法的或没有找到该字段，则不会抛出异常。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/management/RuntimeOperationsException.html" title="class in javax.management">RuntimeOperationsException</a></code> - if a field of the given name exists and the descriptor is immutable. The wrapped exception will be an 
            <a href="../../java/lang/UnsupportedOperationException.html" title="class in java.lang"><code>UnsupportedOperationException</code></a>. 
           </dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>