Интерфейс CompositeData

Все известные реализующие классы:: CompositeDataSupport, GcInfo

public interface CompositeData

Интерфейс CompositeData определяет поведение объектов сложных типов, представляющих структуры составных данных.

С момента:: 1.5

Методы

Модификатор и тип	Метод	Описание
`boolean`	`containsKey(String key)`	Возвращает `true`, если и только если этот экземпляр `CompositeData` содержит элемент с именем `key`.
`boolean`	`containsValue(Object value)`	Возвращает `true`, если и только если этот экземпляр `CompositeData` содержит элемент со значением `value`.
`boolean`	`equals(Object obj)`	Сравнивает указанный параметр `obj` с этим экземпляром `CompositeData` на равенство.
`Object`	`get(String key)`	Возвращает значение элемента с именем `key`.
`Object[]`	`getAll(String[] keys)`	Возвращает массив значений элементов, имена которых заданы в `keys`, в том же порядке, что и в `keys`.
`CompositeType`	`getCompositeType()`	Возвращает тип составного объекта этого экземпляра составных данных.
`int`	`hashCode()`	Возвращает значение хэш-кода для этого экземпляра `CompositeData`.
`String`	`toString()`	Возвращает строковое представление этого экземпляра `CompositeData`.
`Collection<?>`	`values()`	Возвращает неизменяемый вид коллекции значений элементов, содержащихся в этом экземпляре `CompositeData`.

Методы

getCompositeType

CompositeType getCompositeType()

Возвращает тип составного объекта этого экземпляра составных данных.

Возвращает:: тип этого CompositeData.

get

Object get(String key)

Возвращает значение элемента с именем key.

Параметры:: key - имя элемента.
Возвращает:: значение, связанное с этим ключом.
Исключения:: IllegalArgumentException - если key является пустой или нулевой строкой.; InvalidKeyException - если key не является существующим именем элемента для этого экземпляра CompositeData.

getAll

Object[] getAll(String[] keys)

Возвращает массив значений элементов, имена которых заданы в keys, в том же порядке, что и в keys.

Параметры:: keys - имена элементов.
Возвращает:: значения, соответствующие ключам.
Исключения:: IllegalArgumentException - если элемент в keys является пустой или нулевой строкой.; InvalidKeyException - если элемент в keys не является существующим именем элемента для этого экземпляра CompositeData.

containsKey

boolean containsKey(String key)

Возвращает true, если и только если этот экземпляр CompositeData содержит элемент с именем key . Если key является пустой или нулевой строкой, метод просто возвращает false.

Параметры:: key - ключ для проверки.
Возвращает:: true, если этот CompositeData содержит ключ.

containsValue

boolean containsValue(Object value)

Возвращает true, если и только если этот экземпляр CompositeData содержит элемент со значением value.

Параметры:: value - значение для проверки.
Возвращает:: true, если этот CompositeData содержит значение.

values

Collection<?> values()

Возвращает неизменяемый вид коллекции значений элементов, содержащихся в этом экземпляре CompositeData . Итератор возвращенной коллекции будет возвращать значения в возрастающем лексикографическом порядке соответствующих имён элементов.

Возвращает:: значения.

equals

boolean equals(Object obj)

Сравнивает указанный параметр obj с этим экземпляром CompositeData на равенство.

Возвращает true, если и только если все следующие утверждения истинны:

obj не равен null,
obj также реализует интерфейс CompositeData,
их типы составных объектов равны,
их содержимое, т.е. пары (имя, значение), равны. Если значение, содержащееся в содержимом, является массивом, сравнение значений выполняется так, как если бы вызывали метод deepEquals для массивов ссылочных типов объектов или соответствующее перегрузка Arrays.equals(e1,e2) для массивов примитивных типов

Это гарантирует, что этот метод equals корректно работает для параметров obj, которые являются различными реализациями интерфейса CompositeData, с ограничениями, указанными в методе equals интерфейса java.util.Collection.

Переопределяет:: equals в классе Object
Параметры:: obj - объект для сравнения на равенство с этим экземпляром CompositeData.
Возвращает:: true если указанный объект равен этому экземпляру CompositeData.
См. также:: Object.hashCode(), HashMap

hashCode

int hashCode()

Возвращает хэш-код для этого экземпляра CompositeData.

Хэш-код экземпляра CompositeData — это сумма хэш-кодов всех элементов информации, используемых в сравнениях equals (т.е. его тип составного объекта и все значения элементов).

Это гарантирует, что t1.equals(t2) подразумевает t1.hashCode()==t2.hashCode() для любых двух экземпляров CompositeData t1 и t2, как того требует общее соглашение метода Object.hashCode().

Хэш-код каждого значения элемента добавляется к возвращаемому хэш-коду. Если значение элемента является массивом, его хэш-код вычисляется как если бы вызывался метод deepHashCode для массивов ссылочных типов объектов или соответствующее перегрузка Arrays.hashCode(e) для массивов примитивных типов.

Переопределяет:: hashCode в классе Object
Возвращает:: значение хэш-кода для этого экземпляра CompositeData
См. также:: Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

String toString()

Возвращает строковое представление этого экземпляра CompositeData.

Строковое представление состоит из имени реализующего класса, строкового представления типа составного объекта этого экземпляра и строкового представления содержимого (т.е. список сопоставлений itemName=itemValue).

Переопределяет:: toString в классе Object
Возвращает:: строковое представление этого экземпляра CompositeData