Интерфейс TabularData

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

public interface TabularData

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

С тех пор:: 1.5

Краткое описание методов

Модификатор и тип	Метод	Описание
`Object[]`	`calculateIndex(CompositeData value)`	Вычисляет индекс, который будет использоваться в этом экземпляре `TabularData` для ссылки на указанный составной параметр данных `value`, если он был добавлен в этот экземпляр.
`void`	`clear()`	Удаляет все значения `CompositeData` (т.е. строки) из этого экземпляра `TabularData`.
`boolean`	`containsKey(Object[] key)`	Возвращает `true` тогда и только тогда, когда этот экземпляр `TabularData` содержит значение `CompositeData` (т.е. строку), индекс которого является заданным `key`.
`boolean`	`containsValue(CompositeData value)`	Возвращает `true` тогда и только тогда, когда этот экземпляр `TabularData` содержит указанное значение `CompositeData`.
`boolean`	`equals(Object obj)`	Сравнивает указанный параметр `obj` с этим экземпляром `TabularData` на равенство.
`CompositeData`	`get(Object[] key)`	Возвращает значение `CompositeData`, индекс которого равен `key`, или `null`, если в этом экземпляре `TabularData` нет значения, сопоставленного с `key`.
`TabularType`	`getTabularType()`	Возвращает тип таблицы, описывающий этот экземпляр `TabularData`.
`int`	`hashCode()`	Возвращает значение хэш-кода для этого экземпляра `TabularData`.
`boolean`	`isEmpty()`	Возвращает `true`, если количество значений `CompositeData` (т.е. количество строк) в этом экземпляре `TabularData` равно нулю.
`Set<?>`	`keySet()`	Возвращает представление набора ключей (т.е. значений индексов) значений `CompositeData` (т.е. строк), содержащихся в этом экземпляре `TabularData`.
`void`	`put(CompositeData value)`	Добавляет `value` в этот экземпляр `TabularData`.
`void`	`putAll(CompositeData[] values)`	Добавляет все элементы в `values` в этот экземпляр `TabularData`.
`CompositeData`	`remove(Object[] key)`	Удаляет значение `CompositeData`, индекс которого равен `key`, из этого экземпляра `TabularData` и возвращает удаленное значение, или возвращает `null`, если нет значения, индекс которого равен `key`.
`int`	`size()`	Возвращает количество значений `CompositeData` (т.е. количество строк) в этом экземпляре `TabularData`.
`String`	`toString()`	Возвращает строковое представление этого экземпляра `TabularData`.
`Collection<?>`	`values()`	Возвращает коллекцию представлений значений `CompositeData` (т.е. строк), содержащихся в этом экземпляре `TabularData`.

Подробное описание методов

getTabularType

TabularType getTabularType()

Возвращает описывающий этот TabularData экземпляр тип таблицы.

Возвращает:: тип таблицы.

calculateIndex

Object[] calculateIndex(CompositeData value)

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

Параметры:: value - значение составных данных, индекс которого в этом TabularData экземпляре нужно вычислить; должен быть того же составного типа, что и тип строки этого экземпляра; не должно быть null.
Возвращает:: индекс, который имел бы указанное значение в этом TabularData экземпляре.
Исключения:: NullPointerException - если значение null; InvalidOpenTypeException - если значение не соответствует определению типа строки этого TabularData экземпляра.

size

int size()

Возвращает количество CompositeData значений (то есть количество строк) содержащихся в этом TabularData экземпляре.

Возвращает:: количество содержащихся значений.

isEmpty

boolean isEmpty()

Возвращает true если количество CompositeData значений (т. е. количество строк), содержащихся в этом TabularData экземпляре, равно нулю.

Возвращает:: true, если этот TabularData пуст.

containsKey

boolean containsKey(Object[] key)

Возвращает true тогда и только тогда, когда этот TabularData экземпляр содержит CompositeData значение (т. е. строку), индекс которого является указанным ключ. Если ключ null или не соответствует определению TabularData экземпляра, этот метод просто возвращает false.

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

containsValue

boolean containsValue(CompositeData value)

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

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

get

CompositeData get(Object[] key)

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

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

put

void put(CompositeData value)

Добавляет значение в этот TabularData экземпляр. Составной тип значение должен быть таким же, как тип строки этого экземпляра (т. е. составной тип, возвращаемый this.getTabularType().getRowType()), и не должно уже быть существующего значения в этом TabularData экземпляре, индекс которого совпадает с индексом вычисленного для значение, которое нужно добавить. Индекс для значение вычисляется в соответствии с определением TabularData экземпляра TabularType (см. TabularType.getIndexNames()).

Параметры:: value - значение составных данных, которое должно быть добавлено в качестве новой строки в этот TabularData экземпляр; должен быть того же составного типа, что и тип строки этого экземпляра; не должно быть null.
Исключения:: NullPointerException - если значение null; InvalidOpenTypeException - если значение не соответствует определению типа строки этого TabularData экземпляра.; KeyAlreadyExistsException - если индекс для значение, вычисленный в соответствии с определением этого TabularData экземпляра TabularType уже сопоставлен с существующим значением в базовом HashMap.

remove

CompositeData remove(Object[] key)

Удаляет CompositeData значение, индекс которого ключ, из этого TabularData экземпляра и возвращает удаленное значение или возвращает null если нет значения с индексом ключ.

Параметры:: key - индекс значения, которое нужно получить в этом TabularData экземпляре; должен быть допустимым для определения типа строки этого TabularData экземпляра; не должно быть null.
Возвращает:: предыдущее значение, связанное с указанным ключом, или null если для ключа не было сопоставления.
Исключения:: NullPointerException - если ключ null; InvalidKeyException - если ключ не соответствует определению типа TabularType этого TabularData экземпляра

putAll

void putAll(CompositeData[] values)

Добавляет все элементы в значения в этот TabularData экземпляр. Если какой-либо элемент в значения не удовлетворяет ограничениям, определённым в put, или если какие-либо два элемента в значения имеют одинаковый индекс, вычисленный в соответствии с определением TabularData экземпляра TabularType, тогда выбрасывается исключение, описывающее ошибку, и ни один элемент из значения не добавляется, оставляя этот TabularData экземпляр неизменным.

Параметры:: values - массив значений составных данных, которые должны быть добавлены в качестве новых строк в этот TabularData экземпляр; если значения null или пустой, этот метод возвращается без выполнения каких-либо действий.
Исключения:: NullPointerException - если элемент из значения null; InvalidOpenTypeException - если элемент из значения не соответствует определению типа строки этого TabularData экземпляра; KeyAlreadyExistsException - если индекс для элемента из значения, рассчитанный в соответствии с определением этого TabularData экземпляра TabularType уже сопоставлен с существующим значением в этом экземпляре, или два элемента из значения имеют одинаковый индекс.

clear

void clear()

Удаляет все CompositeData значения (т. е. строки) из этого TabularData экземпляра.

keySet

Set<?> keySet()

Возвращает представление набора ключей (т. е. значений индекса) CompositeData значений (т. е. строк), содержащихся в этом TabularData экземпляре. Возвращаемый Set является Set<List<?>>, но объявлен как Set<?> по соображениям совместимости. Возвращаемый набор можно использовать для итерации по ключам.

Возвращает:: представление набора (Set<List<?>>) значений индексов, используемых в этом TabularData экземпляре.

values

Collection<?> values()

Возвращает представление коллекции CompositeData значений (т. е. строк), содержащихся в этом TabularData экземпляре. Возвращаемая Collection коллекция является Collection<CompositeData>, но объявлена как Collection<?> по соображениям совместимости. Возвращаемая коллекция может быть использована для итерации по значениям.

Возвращает:: представление коллекции (Collection<CompositeData>) строк, содержащихся в этом TabularData экземпляре.

equals

boolean equals(Object obj)

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

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

obj не null,
obj также реализует интерфейс TabularData,
их типы строк равны
их содержимое (т. е. сопоставления индекс-значение) равны

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

Overrides:

equals в классе Object

Параметры:

obj - объект, подлежащий сравнению на равенство с этим TabularData экземпляром;

Возвращает:

true если указанный объект равен этому TabularData экземпляру.

См. также:

hashCode

int hashCode()

Возвращает значение хэш-кода для этого TabularData объекта.

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

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

Overrides:

hashCode в классе Object

Returns:

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

См. также:

toString

String toString()

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

Строковое представление состоит из имени реализующего класса и типа таблицы этого объекта.

Overrides:: toString в классе Object
Returns:: строковое представление этого объекта TabularData

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.management/javax/management/openmbean/TabularData.html