DescriptorSupport (Java Platform SE 8 )

java.lang.Object
- javax.management.modelmbean.DescriptorSupport

All Implemented Interfaces:

Serializable， Cloneable， Descriptor
```
public class DescriptorSupport
extends Object
implements Descriptor
```
这类表示为ModelMBean元的元数据。一个描述符的一部分ModelMBeanNotificationInfo，ModelMBeanAttributeInfo，ModelMBeanInfo，modelmbeanconstructorinfo，和modelmbeanparameterinfo。
描述符由字段的集合组成。每个字段是字段名=值格式。字段名称是不区分大小写的，情况将被保存在字段值上。

所有字段名称和值都不是预定义的。可以通过任何程序定义和添加新字段。一些领域已经实施的一致性和支持预定义ModelMBeanInfo ModelMBeanAttributeInfo，ModelMBeanConstructorInfo，ModelMBeanNotificationInfo，modelmbeanoperationinfo ModelMBean类，。

这个班的serialVersionUID是-6292969195866300415L。

从以下版本开始：

一点五

另请参见：

Serialized Form

构造方法摘要

构造方法
Constructor and Description
`DescriptorSupport()` 描述符默认构造函数。
`DescriptorSupport(DescriptorSupport inDescr)` 以描述符为参数的描述符构造函数。
`DescriptorSupport(int initNumFields)` 广义的构造函数。
`DescriptorSupport(String... fields)` 构造函数以领域的字段名=值格式。
`DescriptorSupport(String inStr)` 一个以XML字符串的描述符构造函数。
`DescriptorSupport(String[] fieldNames, Object[] fieldValues)` 取字段名和字段值。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`Object`	`clone()` 返回一个新的描述符，该描述符是描述符的副本。
`boolean`	`equals(Object o)` 将此描述符与给定对象进行比较。
`String[]`	`getFieldNames()` 返回描述符中的所有字段名称。
`String[]`	`getFields()` 返回包含在该描述符中的字段数组中的所有字段。
`Object`	`getFieldValue(String fieldName)` 返回一个特定字段名的值，如果没有该名称的值，则为。
`Object[]`	`getFieldValues(String... fieldNames)` 返回在描述符中的所有字段值作为一个对象数组。
`int`	`hashCode()` 返回此描述符的哈希代码值。
`boolean`	`isValid()` 如果所有字段都具有给定名称的合法值，则返回真值。
`void`	`removeField(String fieldName)` 从描述符中移除字段。
`void`	`setField(String fieldName, Object fieldValue)` 为特定字段名称设置值。
`void`	`setFields(String[] fieldNames, Object[] fieldValues)` 将字段名称数组中的所有字段设置为字段值数组中的相同索引的新值。
`String`	`toString()` 返回表示描述符的人类可读的字符串。
`String`	`toXMLString()` 返回表示描述子的XML字符串。

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - DescriptorSupport
```
public DescriptorSupport()
```
    描述符默认构造函数。默认初始描述符大小为20。它将随着需要的增长。
    注意创建的空描述符无效的描述符（方法 isValid返回 false）
  - DescriptorSupport
```
public DescriptorSupport(int initNumFields)
                  throws MBeanException,
                         RuntimeOperationsException
```
    广义的构造函数。作为参数，存储描述符字段的映射的初始容量。能力将随着需要的增长。
    注意创建的空描述符无效的描述符（方法 isValid返回 false）。
    
    参数
    
    initNumFields -存储描述符字段映射的初始容量。
    
    异常
    
    为initnumfields非法值 RuntimeOperationsException -（<= 0）
    
    MBeanException套分布式通信异常。
  - DescriptorSupport
```
public DescriptorSupport(DescriptorSupport inDescr)
```
    以描述符为参数的描述符构造函数。创建一个新的描述符，该描述符初始化为参数传递的描述符的值。
    
    参数
    
    inDescr的描述符被用来初始化构建描述符。如果它是空的或不包含描述符字段，将创建一个空描述符。
  - DescriptorSupport
```
public DescriptorSupport(String inStr)
                  throws MBeanException,
                         RuntimeOperationsException,
                         XMLParseException
```
    一个以XML字符串的描述符构造函数。
    
    对XML字符串的格式没有定义，但实施必须确保返回的字符串toXMLString()在现有的描述符可以用来实例化一个等价描述使用此构造函数。
    
    在这个实现中，所有字段值将被创建为字符串。如果字段值不是字符串，则程序员将不得不正确地重置或转换这些字段。
    
    参数
    
    inStr -一个XML格式的字符串用于填充此描述符。格式是没有定义的，但任何的实现必须确保字符串在现有的描述方法 toXMLString返回可用于实例化一个等价描述实例化时使用此构造函数。
    
    异常
    
    RuntimeOperationsException如果传入参数的字符串可以是空的
    
    XMLParseException XML解析的问题在分析输入的字符串
    
    MBeanException套分布式通信异常。
  - DescriptorSupport
```
public DescriptorSupport(String[] fieldNames,
                         Object[] fieldValues)
                  throws RuntimeOperationsException
```
    取字段名和字段值。既不数组可以是空的。
    
    参数
    
    fieldNames -字段名称的字符串数组。此数组中的任何元素都不能为空。
    
    fieldValues -相应字段对象的数组。数组的元素可以为空。的 fieldValue必须有效的 fieldName（如法 isValid定义）
    注：数组大小的参数应该匹配。如果两个数组都是空的，则创建一个空描述符。
    
    异常
    
    RuntimeOperationsException -非法值的字段名或字段值。数组的长度必须是相等的。如果描述符建设失败，任何原因，这个异常将被抛出。
  - DescriptorSupport
```
public DescriptorSupport(String... fields)
```
    构造函数以领域的字段名=值格式。
    
    参数
    
    fields -每个元素包含一个字段的名称和值的字符串数组。如果这个数组是空的或空的，那么将执行默认的构造函数。空字符串或空字符串将被忽略。
    所有字段值都应该是字符串。如果字段值不是字符串，则程序员将不得不正确地重置或转换这些字段。
    
    注：每个字符串的形式应字段名=值。字段名称结束了第一=特征；例如，如果字符串a=b=c然后字段名称是a及其价值是b=c。
    
    异常
    
    RuntimeOperationsException -非法值的字段名或字段值。字段必须包含一个“=”。=值”、“字段名”和“值”是非法的。字段名不能为空。”字段名=“会造成值为空。如果描述符建设失败，任何原因，这个异常将被抛出。
- 方法详细信息
  - getFieldValue
```
public Object getFieldValue(String fieldName)
                     throws RuntimeOperationsException
```
    从接口复制的描述： Descriptor
    
    返回一个特定字段名的值，如果没有该名称的值，则为。
    
    Specified by:
    
    getFieldValue 接口 Descriptor
    
    参数
    
    fieldName的字段名称。
    
    结果
    
    如果字段不存在，则相应的值或为空。
    
    异常
    
    RuntimeOperationsException如果字段名称是非法的。
  - setField
```
public void setField(String fieldName,
                     Object fieldValue)
              throws RuntimeOperationsException
```
    从接口复制的描述： Descriptor
    
    为特定字段名称设置值。这将修改一个现有的字段或添加一个新字段。
    
    字段值在它被设置之前将被验证。如果它无效，则将抛出一个异常。有效性的意义是依赖于描述符的实现。
    
    Specified by:
    
    setField 接口 Descriptor
    
    参数
    
    fieldName -要设置的字段名称。不能为空或空。
    
    fieldValue -被设置为字段名字段值。可以为空，如果这是一个字段的有效值。
    
    异常
    
    RuntimeOperationsException如果字段名或字段的值是非法的（包裹的例外是 IllegalArgumentException）；或者如果描述符是不变的（包裹的例外是 UnsupportedOperationException）。
  - getFields
```
public String[] getFields()
```
    从接口复制的描述： Descriptor
    
    返回包含在该描述符中的字段数组中的所有字段。
    
    Specified by:
    
    getFields 接口 Descriptor
    
    结果
    
    在格式字段名=值
    if字段的值字段的字符串数组不是一个字符串，然后tostring()方法将被调用，它返回的值，括号的，用于返回数组的字段的值。如果字段的值为空，则返回的数组中的字段的值将是空的。如果描述符是空的，你将得到一个空数组。
    
    另请参见：
    
    Descriptor.setFields(java.lang.String[], java.lang.Object[])
  - getFieldNames
```
public String[] getFieldNames()
```
    从接口复制的描述： Descriptor
    
    返回描述符中的所有字段名称。
    
    Specified by:
    
    getFieldNames 接口 Descriptor
    
    结果
    
    字段名称的字符串数组。如果描述符是空的，你将得到一个空数组。
  - getFieldValues
```
public Object[] getFieldValues(String... fieldNames)
```
    从接口复制的描述： Descriptor
    
    返回在描述符中的所有字段值作为一个对象数组。返回的值是相同的顺序为 fieldNames字符串数组参数。
    
    Specified by:
    
    getFieldValues 接口 Descriptor
    
    参数
    
    fieldNames -字段的名称，该值应返回的字符串数组。如果数组是空的，那么将返回一个空数组。如果数组为空然后所有值将返回，如果参数是由 Descriptor.getFieldNames()返回的数组。如果数组中的字段名不存在，包括它为空或空字符串的情况，则返回匹配数组元素返回的空值。
    
    结果
    
    字段值的对象数组。如果 fieldNames列表是空的，你会得到一个空数组。
  - setFields
```
public void setFields(String[] fieldNames,
                      Object[] fieldValues)
               throws RuntimeOperationsException
```
    从接口复制的描述： Descriptor
    
    将字段名称数组中的所有字段设置为字段值数组中的相同索引的新值。数组大小必须匹配。
    
    字段值在它被设置之前将被验证。如果它无效，则将抛出一个异常。如果数组是空的，那么没有更改将生效。
    
    Specified by:
    
    setFields 接口 Descriptor
    
    参数
    
    fieldNames -字段名称的字符串数组。数组和数组元素不能为空。
    
    fieldValues -相应字段对象的数组。数组不能为空。数组的元素可以为空。
    
    异常
    
    RuntimeOperationsException -如果变化没有以任何理由。包裹的例外是 IllegalArgumentException如果 fieldNames或 fieldValues是无效的，或者如果数组是不同的长度，或如果有其中一个非法值。包裹的例外是 UnsupportedOperationException如果描述符是不可变的，并能改变它的内容。
    
    另请参见：
    
    Descriptor.getFields()
  - clone
```
public Object clone()
             throws RuntimeOperationsException
```
    返回一个新的描述符，该描述符是描述符的副本。
    
    Specified by:
    
    clone 接口 Descriptor
    
    重写：
    
    clone 方法重写，继承类 Object
    
    结果
    
    这个实例的克隆。
    
    异常
    
    RuntimeOperationsException -非法值的字段名或字段值。如果描述符建设失败，任何原因，这个异常将被抛出。
    
    另请参见：
    
    Cloneable
  - removeField
```
public void removeField(String fieldName)
```
    从接口复制的描述： Descriptor
    
    从描述符中移除字段。
    
    Specified by:
    
    removeField 接口 Descriptor
    
    参数
    
    fieldName -场的字符串被删除。如果字段名称是非法的或未找到字段，则将不会引发异常。
  - equals
```
public boolean equals(Object o)
```
    将此描述符与给定对象进行比较。对象是相等的，如果给定的对象也是一个描述符，如果两个描述符有相同的字段名称（可能是不同的情况下）和相同的关联值。如果下列条件保持在两个描述符字段值分别相等：
    - 如果一个值是空的，那么另一个值也必须是。
    - 如果一个值是一个原始数组，那么另一个值必须是同一个元素的相同类型的原始数组。
    - 如果一个值是一个对象数组，然后其他必须也Arrays.deepEquals必须返回true。
    - 否则Object.equals(Object)必须返回true。
    Specified by:
    
    equals 接口 Descriptor
    
    重写：
    
    equals 方法重写，继承类 Object
    
    参数
    
    o -比较对象。
    
    结果
    
    true如果对象是相同的； false否则。
    
    另请参见：
    
    Object.hashCode()， HashMap
  - hashCode
```
public int hashCode()
```
    返回此描述符的哈希代码值。散列码被计算为描述符中的每个字段的哈希代码的总和。名称n和价值v字段的哈希代码n.toLowerCase().hashCode() ^ h。这里h是v哈希代码，计算如下：
    - 如果v空然后h 0。
    - 如果v是原始数组然后h是使用适当的超载java.util.Arrays.hashCode计算。
    - 如果v是对象数组然后h计算使用Arrays.deepHashCode。
    - 否则h是v.hashCode()。
    Specified by:
    
    hashCode 接口 Descriptor
    
    重写：
    
    hashCode 方法重写，继承类 Object
    
    结果
    
    此对象的哈希代码值。
    
    另请参见：
    
    Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)
  - isValid
```
public boolean isValid()
                throws RuntimeOperationsException
```
    如果所有字段都具有给定名称的合法值，则返回真值。
    此实现不支持互操作的一个目录或查找服务。因此，符合规范，没有检查完成的“出口”领域。
    
    否则此实现返回假：
    - 名称和descriptortype字段名是未定义的，或者为空，或者空字符串，或不
    - 类，方法，字段名的作用，因而，如果定义为空字符串，或不
    - persistperiod，currencyTimeLimit，lastupdatedtimestamp，lastreturnedtimestamp如果定义为空，或非数字字符串或数值> = 1
    - 日志中，如果定义是无效的，或者不是一个布尔或不是一个字符串值“T”、“F”、“真”、“假”。这些字符串值必须是不区分大小写的。
    - 能见度的字段，如果定义为空，或非数字字符串或数字值＞＝1，不是<< = 4
    - 严重的字段，如果定义是无效的，或者不是一个数字串或非数字值> = 0 < = 6
    - persistpolicy字段名，如果定义为空，或没有一个
      以下字符串：“更新”、“OnTimer”、“NoMoreOftenThan”、“OnUnregister”、“总是”、“从不”。这些字符串值必须不sensitive.
      案例
    Specified by:
    
    isValid 接口 Descriptor
    
    结果
    
    如果值是合法的。
    
    异常
    
    RuntimeOperationsException如果有效性检查的任何原因而失败，这将引发异常。
  - toXMLString
```
public String toXMLString()
```
    返回表示描述子的XML字符串。
    
    格式是没有定义的，但执行必须确保该方法返回的字符串可以被用来建立一个等价描述实例化时使用构造函数DescriptorSupport(String inStr)。
    
    这是不是字符串对象都tostring()号召他们创造价值的领域。该值将被封闭在括号中。它不能保证你可以重建这些对象，除非他们已经专门成立了支持tostring()有意义的格式有一个匹配的构造函数接受一个同样格式的字符串。
    
    如果描述符是空的，则返回下列字符串： <描述符> < /描述符>
    
    结果
    
    XML字符串。
    
    异常
    
    RuntimeOperationsException -非法值的字段名或字段值。如果XML格式化的字符串结构失败，任何原因，这个异常将被抛出。
  - toString
```
public String toString()
```
    返回表示描述符的人类可读的字符串。该字符串将在“字段名=值的格式，fieldname2 = fieldvalue2，…”
    如果有描述符中没有字段，则返回一个空字符串。
    如果值是一个对象的方法，然后tostring()叫它和它的返回值是用于封闭括号中的字段的值。
    
    重写：
    
    toString 方法重写，继承类 Object
    
    结果
    
    对象的字符串表示形式。
    
    异常
    
    RuntimeOperationsException -非法值的字段名或字段值。如果描述符字符串失败，任何原因，这个异常将被抛出。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class DescriptorSupport

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Constructor Detail

DescriptorSupport

DescriptorSupport

DescriptorSupport

DescriptorSupport

DescriptorSupport

DescriptorSupport

方法详细信息

getFieldValue

setField

getFields

getFieldNames

getFieldValues

setFields

clone

removeField

equals

hashCode

isValid

toXMLString

toString