ImmutableDescriptor (Платформа Java SE 7)

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

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

Сериализуемый, Cloneable, Дескриптор
```
public class ImmutableDescriptor
extends Object
implements Descriptor
```
Неизменный дескриптор.

С тех пор:

1.6

См. Также:
Сериализированная Форма

Полевая Сводка

Поля
Модификатор и Тип Поле и Описание

static ImmutableDescriptor EMPTY_DESCRIPTOR
Пустой дескриптор.

Поля
Модификатор и Тип	Поле и Описание
`static ImmutableDescriptor`	`EMPTY_DESCRIPTOR` Пустой дескриптор.

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

Конструкторы
Конструктор и Описание
`ImmutableDescriptor(Map<String,?> fields)` Создайте дескриптор, где имена и значения полей являются ключами и значениями данной Карты.
`ImmutableDescriptor(String... fields)` Создайте дескриптор, содержащий данные поля.
`ImmutableDescriptor(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()` Возвращает строковое представление объекта.
`static ImmutableDescriptor`	`union(Descriptor... descriptors)` Возвратитесь `ImmutableDescriptor` чье содержание является объединением данных дескрипторов.

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

- Полевая Деталь
  - EMPTY_DESCRIPTOR
```
public static final ImmutableDescriptor EMPTY_DESCRIPTOR
```
    Пустой дескриптор.
- Деталь конструктора
  - ImmutableDescriptor
```
public ImmutableDescriptor(String[] fieldNames,
                   Object[] fieldValues)
```
    Создайте дескриптор, содержащий данные поля и значения.
    
    Броски:
    
    IllegalArgumentException - если или массив является нулем, или если у массивов есть различные размеры, или если имя поля является нулем или пустой, или если то же самое имя поля появляется не раз.
  - ImmutableDescriptor
```
public ImmutableDescriptor(String... fields)
```
    Создайте дескриптор, содержащий данные поля. Каждая Строка должна иметь форму fieldName=fieldValue. Имя поля заканчивается в первом = символ; например, если Строка a=b=c тогда имя поля a и его значение b=c.
    
    Броски:
    
    IllegalArgumentException - если параметр является нулем, или если имя поля пусто, или если то же самое имя поля появляется не раз, или если одна из строк не содержит = символ.
  - ImmutableDescriptor
```
public ImmutableDescriptor(Map<String,?> fields)
```
    Создайте дескриптор, где имена и значения полей являются ключами и значениями данной Карты.
    
    Броски:
    
    IllegalArgumentException - если параметр является нулем, или если имя поля является нулем или пустой, или если то же самое имя поля появляется не раз (который может произойти, потому что имена полей не являются чувствительными к регистру).
- Деталь метода
  - объединение
```
public static ImmutableDescriptor union(Descriptor... descriptors)
```
    Возвратитесь ImmutableDescriptor чье содержание является объединением данных дескрипторов. Каждое имя поля, которое появляется в любом из дескрипторов, появится в результате со значением, которое это имеет, когда метод вызывают. Последующие изменения к любому из дескрипторов не влияют на ImmutableDescriptor, возвращенный здесь.
    
    В самом простом случае есть только один дескриптор и возвращенный ImmutableDescriptor копия его полей в то время, когда этот метод вызывают:
```
 Descriptor d = something();
 ImmutableDescriptor copy = ImmutableDescriptor.union(d);
 
```
    Параметры:
    descriptors - дескрипторы, которые будут объединены. Любой из дескрипторов может быть нулем, когда он пропускается.
    
    Возвраты:
    ImmutableDescriptor это - объединение данных дескрипторов. Возвращенный объект может быть идентичным одному из входных дескрипторов, если это - ImmutableDescriptor, который содержит все обязательные поля.
    
    Броски:
    
    IllegalArgumentException - если два Дескриптора содержат то же самое имя поля с различными присваиваемыми значениями. Примитивные значения массива считают тем же самым, если они имеют тот же самый тип с теми же самыми элементами. Объектные значения массива считают тем же самым если Arrays.deepEquals(Object[],Object[]) возвращает true.
  - getFieldValue
```
public final Object getFieldValue(String fieldName)
```
    Описание скопировало с интерфейса: Descriptor
    
    Возвращает значение для определенного имени поля, или нуль, если никакое значение не присутствует для того имени.
    
    Определенный:
    
    getFieldValue в интерфейсе Descriptor
    
    Параметры:
    fieldName - имя поля.
    
    Возвраты:
    соответствующее значение, или нуль, если поле не присутствует.
  - getFields
```
public final String[] getFields()
```
    Описание скопировало с интерфейса: Descriptor
    
    Возвраты все поля, содержавшиеся в этом дескрипторе как строковый массив.
    
    Определенный:
    
    getFields в интерфейсе Descriptor
    
    Возвраты:
    Строковый массив полей в формате fieldName=fieldValue
    Если значением поля не будет Строка, то toString () метод вызовут на нем и возвращенное значение, включенное в круглые скобки, используемые в качестве значения для поля в возвращенном массиве. Если значение поля будет нулем, то значение поля в возвращенном массиве будет пусто. Если дескриптор будет пуст, то Вы получите пустой массив.
    См. Также:
    Descriptor.setFields(java.lang.String[], java.lang.Object[])
  - getFieldValues
```
public final Object[] getFieldValues(String... fieldNames)
```
    Описание скопировало с интерфейса: Descriptor
    
    Возвраты все значения полей в дескрипторе как массив Объектов. Возвращенные значения находятся в том же самом порядке как fieldNames Строковый параметр массива.
    
    Определенный:
    
    getFieldValues в интерфейсе Descriptor
    
    Параметры:
    fieldNames - Строковый массив имен полей, для которых должны быть возвращены значения. Если массив будет пуст тогда будет возвращен, то пустой массив. Если массив будет нулем тогда, то все значения будут возвращены, как будто параметр был массивом, возвращенным Descriptor.getFieldNames(). Если имя поля в массиве не существует, включая случай, где это - нуль или пустая строка, то нуль возвращается для соответствующего возвращаемого элемента массива.
    
    Возвраты:
    Объектный массив значений полей. Если список fieldNames пусто, Вы получите пустой массив.
  - getFieldNames
```
public final String[] getFieldNames()
```
    Описание скопировало с интерфейса: Descriptor
    
    Возвраты все имена полей в дескрипторе.
    
    Определенный:
    
    getFieldNames в интерфейсе Descriptor
    
    Возвраты:
    Строковый массив имен полей. Если дескриптор будет пуст, то Вы получите пустой массив.
  - равняется
```
public boolean equals(Object o)
```
    Сравнивает этот дескриптор с данным объектом. Объекты равны, если данным объектом является также Дескриптор, и если у этих двух Дескрипторов есть те же самые имена полей (возможно отличающийся в случае, если) и те же самые присваиваемые значения. Соответствующие значения для поля в этих двух Дескрипторах равны, если следующие условия содержат:
    - Если одно значение является нулем тогда другой, должен быть также.
    - Если одно значение является примитивным массивом тогда другой, должен быть примитивный массив того же самого типа с теми же самыми элементами.
    - Если одно значение является объектным массивом тогда другой, должен быть также и Arrays.deepEquals(Object[],Object[]) должен возвратить true.
    - Иначе Object.equals(Object) должен возвратить true.
    Определенный:
    
    equals в интерфейсе Descriptor
    
    Переопределения:
    
    equals в классе 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(Object[]).
    - Иначе h v.hashCode().
    Определенный:
    
    hashCode в интерфейсе Descriptor
    
    Переопределения:
    
    hashCode в классе Object
    
    Возвраты:
    Значение хэш-кода для этого объекта.
    См. Также:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    Описание скопировало с класса: Object
    Возвращает строковое представление объекта. Вообще, toString метод возвращает строку, которая "дословно представляет" этот объект. Результатом должно быть краткое, но информативное представление, которое легко для человека читать. Рекомендуется, чтобы все подклассы переопределили этот метод.
    toString метод для класса Object возвращает строку, состоящую из имени класса, которого объект является экземпляром, символ знака at-sign`@', и шестнадцатеричное представление без знака хэш-кода объекта. Другими словами этот метод возвращает строку, равную значению:
    getClass().getName() + '@' + Integer.toHexString(hashCode())
    Переопределения:
    
    toString в классе Object
    
    Возвраты:
    строковое представление объекта.
  - isValid
```
public boolean isValid()
```
    Возвращает true, если у всех полей есть юридические значения, данные их имена. Этот метод всегда возвращает true, но подкласс может переопределить это, чтобы возвратить false когда приспособлено.
    
    Определенный:
    
    isValid в интерфейсе Descriptor
    
    Возвраты:
    истина, если значения являются законными.
    
    Броски:
    
    RuntimeOperationsException - если проверка законности перестала работать. Метод возвращает false, если дескриптор не допустим, но выдает это исключение, если попытка определить законность перестала работать.
  - клон
```
public Descriptor clone()
```
    Возвращает дескриптор, который равен этому дескриптору. Изменения к возвращенному дескриптору не будут иметь никакого эффекта на этот дескриптор, и наоборот.
    
    Этот метод возвращает объект, на котором его вызывают. Подкласс может переопределить это, чтобы возвратить другой объект, если контракт уважают.
    
    Определенный:
    
    clone в интерфейсе Descriptor
    
    Переопределения:
    
    clone в классе Object
    
    Возвраты:
    клон этого экземпляра.
    
    Броски:
    
    RuntimeOperationsException - для недопустимого значения для имен полей или значений полей. Если сбои конструкции дескриптора по какой-либо причине, это исключение будет выдано.
    См. Также:
    Cloneable
  - setFields
```
public final void setFields(String[] fieldNames,
             Object[] fieldValues)
                     throws RuntimeOperationsException
```
    Эта работа неподдерживается, так как этот класс неизменный. Если этот вызов изменил бы изменчивый дескриптор с тем же самым содержанием, то a RuntimeOperationsException обертывание UnsupportedOperationException бросается. Иначе, поведение является тем же самым, как это было бы для изменчивого дескриптора: или исключение выдается из-за недопустимых параметров, или нет никакого эффекта.
    
    Определенный:
    
    setFields в интерфейсе Descriptor
    
    Параметры:
    fieldNames - Строковый массив имен полей. Элементы массива и массива не могут быть нулем.
    fieldValues - Объектный массив соответствующих значений полей. Массив не может быть нулем. Элементы массива могут быть нулем.
    
    Броски:
    
    RuntimeOperationsException - если изменение перестало работать по какой-либо причине. Обернутое исключение IllegalArgumentException если fieldNames или fieldValues нуль, или если массивы имеют различные длины, или если есть недопустимое значение в одном из них. Обернутое исключение UnsupportedOperationException если бы дескриптор является неизменным, и вызов изменил бы свое содержание.
    См. Также:
    Descriptor.getFields()
  - setField
```
public final void setField(String fieldName,
            Object fieldValue)
                    throws RuntimeOperationsException
```
    Эта работа неподдерживается, так как этот класс неизменный. Если этот вызов изменил бы изменчивый дескриптор с тем же самым содержанием, то a RuntimeOperationsException обертывание UnsupportedOperationException бросается. Иначе, поведение является тем же самым, как это было бы для изменчивого дескриптора: или исключение выдается из-за недопустимых параметров, или нет никакого эффекта.
    
    Определенный:
    
    setField в интерфейсе Descriptor
    
    Параметры:
    fieldName - Имя поля, которое будет установлено. Не может быть нуль или пустой.
    fieldValue - Значение поля, которое будет установлено для имени поля. Может быть нуль, если это - допустимое значение для поля.
    
    Броски:
    
    RuntimeOperationsException - если имя поля или значение поля недопустимы (обернутое исключение IllegalArgumentException); или если дескриптор является неизменным (обернутое исключение UnsupportedOperationException).
  - removeField
```
public final void removeField(String fieldName)
```
    Удаляет поле из дескриптора.
    
    Определенный:
    
    removeField в интерфейсе Descriptor
    
    Параметры:
    fieldName - Имя строки поля, которое будет удалено. Если имя поля недопустимо, или поле не находится, никакое исключение не выдается.
    
    Броски:
    
    RuntimeOperationsException - если поле имени существует, и дескриптор является неизменным. Обернутое исключение будет UnsupportedOperationException.

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

Класс ImmutableDescriptor

Полевая Сводка

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

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

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

Полевая Деталь

EMPTY_DESCRIPTOR

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

ImmutableDescriptor

ImmutableDescriptor

ImmutableDescriptor

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

объединение

getFieldValue

getFields

getFieldValues

getFieldNames

равняется

хэш-код

toString

isValid

клон

setFields

setField

removeField