DescriptorSupport (Платформа Java SE 8 b92)

java.lang. Объект
- javax.management.modelmbean.DescriptorSupport

Все Реализованные Интерфейсы:

Сериализуемый, Cloneable, Дескриптор
```
public class DescriptorSupport
extends Object
implements Descriptor
```
Этот class представляет набор метаданных для элемента ModelMBean. Дескриптор является частью ModelMBeanInfo, ModelMBeanNotificationInfo, ModelMBeanAttributeInfo, ModelMBeanConstructorInfo, и ModelMBeanParameterInfo.
Дескриптор состоит из набора полей. Каждое поле находится в формате fieldname=fieldvalue. Имена полей не являются чувствительными к регистру, случай будет сохранен на значениях полей.
Все имена полей и значения не предопределяются. Новые поля могут быть определены и добавлены любой программой. Некоторые поля были предопределены для непротиворечивости реализации и поддержки ModelMBeanInfo, ModelMBeanAttributeInfo, ModelMBeanConstructorInfo, ModelMBeanNotificationInfo, ModelMBeanOperationInfo и классами ModelMBean.
serialVersionUID этого class -6292969195866300415L.

С тех пор:

1.5

См. Также:

Сериализированная Форма

Сводка конструктора

Конструкторы
Конструктор и Описание
`DescriptorSupport()` Конструктор по умолчанию дескриптора.
`DescriptorSupport(DescriptorSupport inDescr)` Конструктор дескриптора, берущий Дескриптор в качестве параметра.
`DescriptorSupport(int initNumFields)` Конструктор дескриптора.
`DescriptorSupport(String... fields)` Поля взятия конструктора в формате fieldName=fieldValue.
`DescriptorSupport(String inStr)` Конструктор дескриптора, берущий XML Строка.
`DescriptorSupport(String[] fieldNames, Object[] fieldValues)` Конструктор, берущий имена полей и значения полей.

Сводка метода

Все Методы Методы экземпляра Конкретные Методы
Модификатор и Тип	Метод и Описание
`Объект`	`clone()` Возвращает новый Дескриптор, который является копией Дескриптора.
`boolean`	`equals(Object o)` Сравнивает этот дескриптор с данным объектом.
`Строка[]`	`getFieldNames()` Возвраты все имена полей в дескрипторе.
`Строка[]`	`getFields()` Возвраты все поля, содержавшиеся в этом дескрипторе как строковый массив.
`Объект`	`getFieldValue(String fieldName)` Возвращает значение для определенного имени поля, или нуль, если никакое значение не присутствует для того имени.
`Объект[]`	`getFieldValues(String... fieldNames)` Возвраты все значения полей в дескрипторе как массив Объектов.
`int`	`hashCode()` Возвращает значение хэш-кода для этого дескриптора.
`boolean`	`isValid()` Возвращает true, если у всех полей есть юридические значения, данные их имена.
`void`	`removeField(String fieldName)` Удаляет поле из дескриптора.
`void`	`setField(String fieldName, Object fieldValue)` Устанавливает значение для определенного имени поля.
`void`	`setFields(String[] fieldNames, Object[] fieldValues)` Наборы все поля в массиве имен полей к новому значению с тем же самым индексируют в массиве значений полей.
`Строка`	`toString()` Возвращает удобочитаемую строку, представляющую дескриптор.
`Строка`	`toXMLString()` Возвращает XML Строка, представляющая дескриптор.

Методы, наследованные от class java.lang. Объект
finalize, getClass, notify, notifyAll, wait, wait, wait

- Деталь конструктора
  - DescriptorSupport
```
public DescriptorSupport()
```
    Конструктор по умолчанию дескриптора. Размер дескриптора начальной буквы значения по умолчанию 20. Это вырастет как необходимый.
    Отметьте, что создаваемый пустой дескриптор не является допустимым дескриптором (метод isValid возвраты false)
  - DescriptorSupport
```
public DescriptorSupport(int initNumFields)
                  throws MBeanException,
                         RuntimeOperationsException
```
    Конструктор дескриптора. Берет в качестве параметра начальная емкость Карты, которая хранит поля дескриптора. Емкость вырастет как необходимый.
    Отметьте, что создаваемый пустой дескриптор не является допустимым дескриптором (метод isValid возвраты false).
    
    Параметры:
    
    initNumFields - Начальная емкость Карты, которая хранит поля дескриптора.
    
    Броски:
    
    RuntimeOperationsException - для недопустимого значения для initNumFields (<= 0)
    
    MBeanException - Обертывает распределенное коммуникационное Исключение.
  - DescriptorSupport
```
public DescriptorSupport(DescriptorSupport inDescr)
```
    Конструктор дескриптора, берущий Дескриптор в качестве параметра. Создает новый дескриптор, инициализированный к значениям дескриптора, который передают в параметре.
    
    Параметры:
    
    inDescr - дескриптор, который будет использоваться, чтобы инициализировать созданный дескриптор. Если это будет нулем или не будет содержать полей дескриптора, то пустой Дескриптор будет создаваться.
  - DescriptorSupport
```
public DescriptorSupport(String inStr)
                  throws MBeanException,
                         RuntimeOperationsException,
                         XMLParseException
```
    Конструктор дескриптора, берущий XML Строка.
    
    Формат строки XML не определяется, но реализация должна гарантировать что строка, возвращенная toXMLString() на существующем дескрипторе может использоваться, чтобы инстанцировать эквивалентного дескриптора, используя этого конструктора.
    
    В этой реализации все значения полей будут создаваться как Строки. Если значения полей не являются Строками, программист должен будет сбросить или преобразовать эти поля правильно.
    
    Параметры:
    
    inStr - Отформатированная XML строка, используемая, чтобы заполнить этот Дескриптор. Формат не определяется, но любая реализация должна гарантировать что строка, возвращенная методом toXMLString на существующем дескрипторе может использоваться, чтобы инстанцировать эквивалентного дескриптора, инстанцировано используя этого конструктора.
    
    Броски:
    
    RuntimeOperationsException - Если Строка inStr передала в параметре, нуль
    
    XMLParseException - XML, анализирующий проблему, анализируя строку ввода
    
    MBeanException - Обертывает распределенное коммуникационное Исключение.
  - DescriptorSupport
```
public DescriptorSupport(String[] fieldNames,
                         Object[] fieldValues)
                  throws RuntimeOperationsException
```
    Конструктор, берущий имена полей и значения полей. Никакой массив не может быть нулем.
    
    Параметры:
    
    fieldNames - Строковый массив имен полей. Никакие элементы этого массива не могут быть нулем.
    
    fieldValues - Объектный массив соответствующих значений полей. Элементы массива могут быть нулем. fieldValue должно быть допустимым для fieldName (как определено в методе isValid)
    Отметьте: размеры массива параметров должны соответствовать. Если оба массива пусты, то пустой дескриптор создается.
    
    Броски:
    
    RuntimeOperationsException - для недопустимого значения для имен полей или значений полей. Длины массива должны быть равными. Если сбои конструкции дескриптора по какой-либо причине, это исключение будет выдано.
  - DescriptorSupport
```
public DescriptorSupport(String... fields)
```
    Поля взятия конструктора в формате fieldName=fieldValue.
    
    Параметры:
    
    fields - Строковый массив с каждым элементом, содержащим имя поля и значение. Если этот массив будет нулем или пустой, то конструктор по умолчанию будет выполняться. Пустые строки или пустые строки будут проигнорированы.
    Все значения полей должны быть Строками. Если значения полей не являются Строками, программист должен будет сбросить или преобразовать эти поля правильно.
    Отметьте: Каждая строка должна иметь форму fieldName=fieldValue. Имя поля заканчивается в первом = символ; например, если Строка a=b=c тогда имя поля a и его значение b=c.
    
    Броски:
    
    RuntimeOperationsException - для недопустимого значения для имен полей или значений полей. Поле должно содержать "=". "=fieldValue", "имя поля", и "fieldValue" недопустимы. FieldName не может быть нулем. "имя поля =" заставит значение быть нулем. Если сбои конструкции дескриптора по какой-либо причине, это исключение будет выдано.
- Деталь метода
  - getFieldValue
```
public Object getFieldValue(String fieldName)
                     throws RuntimeOperationsException
```
    Описание скопировало с интерфейса: Descriptor
    
    Возвращает значение для определенного имени поля, или нуль, если никакое значение не присутствует для того имени.
    
    Определенный:
    
    getFieldValue в интерфейсе Descriptor
    
    Параметры:
    
    fieldName - имя поля.
    
    Возвраты:
    
    соответствующее значение, или нуль, если поле не присутствует.
    
    Броски:
    
    RuntimeOperationsException - если имя поля недопустимо.
  - setField
```
public void setField(String fieldName,
                     Object fieldValue)
              throws RuntimeOperationsException
```
    Описание скопировало с интерфейса: Descriptor
    
    Устанавливает значение для определенного имени поля. Это изменит существующее поле или добавит новое поле.
    
    Значение поля будет проверено прежде, чем оно будет установлено. Если это не будет допустимо, то исключение будет выдано. Значение законности зависит от реализации дескриптора.
    
    Определенный:
    
    setField в интерфейсе Descriptor
    
    Параметры:
    
    fieldName - Имя поля, которое будет установлено. Не может быть нуль или пустой.
    
    fieldValue - Значение поля, которое будет установлено для имени поля. Может быть нуль, если это - допустимое значение для поля.
    
    Броски:
    
    RuntimeOperationsException - если имя поля или значение поля недопустимы (обернутое исключение IllegalArgumentException); или если дескриптор является неизменным (обернутое исключение UnsupportedOperationException).
  - getFields
```
public String[] getFields()
```
    Описание скопировало с интерфейса: Descriptor
    
    Возвраты все поля, содержавшиеся в этом дескрипторе как строковый массив.
    
    Определенный:
    
    getFields в интерфейсе Descriptor
    
    Возвраты:
    
    Строковый массив полей в формате fieldName=fieldValue
    Если значением поля не будет Строка, то toString () метод вызовут на нем и возвращенное значение, включенное в круглые скобки, используемые в качестве значения для поля в возвращенном массиве. Если значение поля будет нулем, то значение поля в возвращенном массиве будет пусто. Если дескриптор будет пуст, то Вы получите пустой массив.
    
    См. Также:
    
    Descriptor.setFields(java.lang.String[], java.lang.Object[])
  - getFieldNames
```
public String[] getFieldNames()
```
    Описание скопировало с интерфейса: Descriptor
    
    Возвраты все имена полей в дескрипторе.
    
    Определенный:
    
    getFieldNames в интерфейсе Descriptor
    
    Возвраты:
    
    Строковый массив имен полей. Если дескриптор будет пуст, то Вы получите пустой массив.
  - getFieldValues
```
public Object[] getFieldValues(String... fieldNames)
```
    Описание скопировало с интерфейса: Descriptor
    
    Возвраты все значения полей в дескрипторе как массив Объектов. Возвращенные значения находятся в том же самом порядке как fieldNames Строковый параметр массива.
    
    Определенный:
    
    getFieldValues в интерфейсе Descriptor
    
    Параметры:
    
    fieldNames - Строковый массив имен полей, для которых должны быть возвращены значения. Если массив будет пуст тогда будет возвращен, то пустой массив. Если массив будет нулем тогда, то все значения будут возвращены, как будто параметр был массивом, возвращенным Descriptor.getFieldNames(). Если имя поля в массиве не существует, включая случай, где это - нуль или пустая строка, то нуль возвращается для соответствующего возвращаемого элемента массива.
    
    Возвраты:
    
    Объектный массив значений полей. Если список fieldNames пусто, Вы получите пустой массив.
  - setFields
```
public void setFields(String[] fieldNames,
                      Object[] fieldValues)
               throws RuntimeOperationsException
```
    Описание скопировало с интерфейса: Descriptor
    
    Наборы все поля в массиве имен полей к новому значению с тем же самым индексируют в массиве значений полей. Размеры массива должны соответствовать.
    
    Значение поля будет проверено прежде, чем оно будет установлено. Если это не будет допустимо, то исключение будет выдано. Если массивы будут пусты, то никакое изменение не вступит в силу.
    
    Определенный:
    
    setFields в интерфейсе Descriptor
    
    Параметры:
    
    fieldNames - Строковый массив имен полей. Элементы массива и массива не могут быть нулем.
    
    fieldValues - Объектный массив соответствующих значений полей. Массив не может быть нулем. Элементы массива могут быть нулем.
    
    Броски:
    
    RuntimeOperationsException - если изменение перестало работать по какой-либо причине. Обернутое исключение IllegalArgumentException если fieldNames или fieldValues нуль, или если массивы имеют различные длины, или если есть недопустимое значение в одном из них. Обернутое исключение UnsupportedOperationException если бы дескриптор является неизменным, и вызов изменил бы свое содержание.
    
    См. Также:
    
    Descriptor.getFields()
  - клон
```
public Object clone()
             throws RuntimeOperationsException
```
    Возвращает новый Дескриптор, который является копией Дескриптора.
    
    Определенный:
    
    clone в интерфейсе Descriptor
    
    Переопределения:
    
    clone в class Object
    
    Возвраты:
    
    клон этого экземпляра.
    
    Броски:
    
    RuntimeOperationsException - для недопустимого значения для имен полей или значений полей. Если сбои конструкции дескриптора по какой-либо причине, это исключение будет выдано.
    
    См. Также:
    
    Cloneable
  - removeField
```
public void removeField(String fieldName)
```
    Описание скопировало с интерфейса: Descriptor
    
    Удаляет поле из дескриптора.
    
    Определенный:
    
    removeField в интерфейсе Descriptor
    
    Параметры:
    
    fieldName - Имя строки поля, которое будет удалено. Если имя поля недопустимо, или поле не находится, никакое исключение не выдается.
  - равняется
```
public boolean equals(Object o)
```
    Сравнивает этот дескриптор с данным объектом. Объекты равны, если данным объектом является также Дескриптор, и если у этих двух Дескрипторов есть те же самые имена полей (возможно отличающийся в случае, если) и те же самые присваиваемые значения. Соответствующие значения для поля в этих двух Дескрипторах равны, если следующие условия содержат:
    - Если одно значение является нулем тогда другой, должен быть также.
    - Если одно значение является примитивным массивом тогда другой, должен быть примитивный массив того же самого типа с теми же самыми элементами.
    - Если одно значение является объектным массивом тогда другой, должен быть также и Arrays.deepEquals должен возвратить true.
    - Иначе Object.equals(Object) должен возвратить true.
    Определенный:
    
    equals в интерфейсе Descriptor
    
    Переопределения:
    
    equals в class Object
    
    Параметры:
    
    o - объект сравниться с.
    
    Возвраты:
    
    true если объекты являются тем же самым; false иначе.
    
    См. Также:
    
    Object.hashCode(), HashMap
  - хэш-код
```
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().
    Определенный:
    
    hashCode в интерфейсе Descriptor
    
    Переопределения:
    
    hashCode в class Object
    
    Возвраты:
    
    Значение хэш-кода для этого объекта.
    
    См. Также:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - isValid
```
public boolean isValid()
                throws RuntimeOperationsException
```
    Возвращает true, если у всех полей есть юридические значения, данные их имена.
    Эта реализация не поддерживает взаимодействие со службой поиска или каталогом. Таким образом, соответствуя спецификации, никакая проверка не делается на поле "экспорта".
    Иначе эта реализация возвращает false если:
    - имя и descriptorType имена полей не определяются, или нуль, или пустые, или не Строка
    - class, роль, getMethod, setMethod имена полей, если определено, является нулем или не Строкой
    - persistPeriod, currencyTimeLimit, lastUpdatedTimeStamp, lastReturnedTimeStamp если определено, являются нулем, или не Числовой Строкой или не Числовым значением> =-1
    - зарегистрируйте имя поля, если определено, нуль, или не Булево или не Строка со значением "t", "f", "истина", "ложь". Эти Строковые значения не должны быть чувствительными к регистру.
    - имя поля видимости, если определено, является нулем, или не Числовой Строкой или не Числовым значением> = 1 и <= 4
    - имя поля серьезности, если определено, является нулем, или не Числовой Строкой или не Числовым значением> = 0 и <= 6
    - имя поля persistPolicy, если определено, является нулем, или не одной из следующих строк:
      "OnUpdate", "OnTimer", "NoMoreOftenThan", "OnUnregister", "Всегда", "Никогда". Эти Строковые значения не должны быть чувствительными к регистру.
    Определенный:
    
    isValid в интерфейсе Descriptor
    
    Возвраты:
    
    истина, если значения являются законными.
    
    Броски:
    
    RuntimeOperationsException - Если сбои проверки законности по какой-либо причине, это исключение будет выдано.
  - toXMLString
```
public String toXMLString()
```
    Возвращает XML Строка, представляющая дескриптор.
    
    Формат не определяется, но реализация должна гарантировать, что строка, возвращенная этим методом, может использоваться, чтобы создать эквивалентный дескриптор, инстанцировано используя конструктора DescriptorSupport(String inStr).
    
    У полей, которые не являются Строковыми объектами, будет toString (), обращался к ним с просьбой создавать стоимость. Значение будет включено в круглые скобки. Не гарантируется, что можно восстановить эти объекты, если они не были определенно установлены, чтобы поддерживать toString () в значимом формате и иметь соответствующего конструктора, который принимает Строку в том же самом формате.
    
    Если дескриптор пуст, следующая Строка возвращается: <Дескриптор> </Дескриптор>
    
    Возвраты:
    
    строка XML.
    
    Броски:
    
    RuntimeOperationsException - для недопустимого значения для имен полей или значений полей. Если XML отформатированные строковые сбои конструкции по какой-либо причине, это исключение будет выдано.
  - toString
```
public String toString()
```
    Возвращает удобочитаемую строку, представляющую дескриптор. Строка будет в формате "fieldName=fieldValue,fieldName2=fieldValue2..."
    Если нет никаких полей в дескрипторе, то пустая Строка возвращается.
    Если fieldValue является объектом тогда toString (), метод вызывают на этом, и его возвращенное значение используется в качестве значения для поля, включенного в круглую скобку.
    
    Переопределения:
    
    toString в class Object
    
    Возвраты:
    
    строковое представление объекта.
    
    Броски:
    
    RuntimeOperationsException - для недопустимого значения для имен полей или значений полей. Если строковые сбои дескриптора по какой-либо причине, это исключение будет выдано.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Класс DescriptorSupport

Сводка конструктора

Сводка метода

Методы, наследованные от class java.lang. Объект

Деталь конструктора

DescriptorSupport

DescriptorSupport

DescriptorSupport

DescriptorSupport

DescriptorSupport

DescriptorSupport

Деталь метода

getFieldValue

setField

getFields

getFieldNames

getFieldValues

setFields

клон

removeField

равняется

хэш-код

isValid

toXMLString

toString