compact3

javax.management

Класс ImmutableDescriptor

java.lang. Объект

javax.management. ImmutableDescriptor

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

Сериализуемый, Cloneable, Дескриптор

public class ImmutableDescriptor
extends Object
implements Descriptor

Неизменный дескриптор.

С тех пор:

1.6

См. Также:

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

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

Поля

Модификатор и Тип	Поле и Описание
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) Эта работа неподдерживается, так как этот class неизменный.
void	setFields(String[] fieldNames, Object[] fieldValues) Эта работа неподдерживается, так как этот class неизменный.
Строка	toString() Возвращает строковое представление объекта.
static ImmutableDescriptor	union(Descriptor... descriptors) Возвратитесь ImmutableDescriptor чье содержание является объединением данных дескрипторов.

Методы, наследованные от class 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 в 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(Object[]).
• Иначе h v.hashCode().

Определенный:

hashCode в интерфейсе Descriptor

Переопределения:

hashCode в class Object

Возвраты:

Значение хэш-кода для этого объекта.

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

public String toString()

Описание скопировало с class: Object

Возвращает строковое представление объекта. Вообще, toString метод возвращает строку, которая "дословно представляет" этот объект. Результатом должно быть краткое, но информативное представление, которое легко для человека читать. Рекомендуется, чтобы все подклассы переопределили этот метод.

toString метод для class Object возвращает строку, состоящую из имени class, которого объект является экземпляром, символ знака at-sign`@', и шестнадцатеричное представление без знака хэш-кода объекта. Другими словами этот метод возвращает строку, равную значению:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

Переопределения:

toString в class Object

Возвраты:

строковое представление объекта.

isValid

public boolean isValid()

Возвращает true, если у всех полей есть юридические значения, данные их имена. Этот метод всегда возвращает true, но подкласс может переопределить это, чтобы возвратить false когда приспособлено.

Определенный:

isValid в интерфейсе Descriptor

Возвраты:

истина, если значения являются законными.

Броски:

RuntimeOperationsException - если проверка законности перестала работать. Метод возвращает false, если дескриптор не допустим, но выдает это исключение, если попытка определить законность перестала работать.

клон

public Descriptor clone()

Возвращает дескриптор, который равен этому дескриптору. Изменения к возвращенному дескриптору не будут иметь никакого эффекта на этот дескриптор, и наоборот.

Этот метод возвращает объект, на котором его вызывают. Подкласс может переопределить это, чтобы возвратить другой объект, если контракт уважают.

Определенный:

clone в интерфейсе Descriptor

Переопределения:

clone в class Object

Возвраты:

клон этого экземпляра.

Броски:

RuntimeOperationsException - для недопустимого значения для имен полей или значений полей. Если сбои конструкции дескриптора по какой-либо причине, это исключение будет выдано.

См. Также:

Cloneable

setFields

public final void setFields(String[] fieldNames,
                            Object[] fieldValues)
                     throws RuntimeOperationsException

Эта работа неподдерживается, так как этот class неизменный. Если этот вызов изменил бы изменчивый дескриптор с тем же самым содержанием, то 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

Эта работа неподдерживается, так как этот class неизменный. Если этот вызов изменил бы изменчивый дескриптор с тем же самым содержанием, то a RuntimeOperationsException обертывание UnsupportedOperationException бросается. Иначе, поведение является тем же самым, как это было бы для изменчивого дескриптора: или исключение выдается из-за недопустимых параметров, или нет никакого эффекта.

Определенный:

setField в интерфейсе Descriptor

Параметры:

fieldName - Имя поля, которое будет установлено. Не может быть нуль или пустой.

fieldValue - Значение поля, которое будет установлено для имени поля. Может быть нуль, если это - допустимое значение для поля.

Броски:

RuntimeOperationsException - если имя поля или значение поля недопустимы (обернутое исключение IllegalArgumentException); или если дескриптор является неизменным (обернутое исключение UnsupportedOperationException).

removeField

public final void removeField(String fieldName)

Удаляет поле из дескриптора.

Определенный:

removeField в интерфейсе Descriptor

Параметры:

fieldName - Имя строки поля, которое будет удалено. Если имя поля недопустимо, или поле не находится, никакое исключение не выдается.

Броски:

RuntimeOperationsException - если поле имени существует, и дескриптор является неизменным. Обернутое исключение будет UnsupportedOperationException.