Интерфейс 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 экземпляре для ссылки на указанные составные данные value, если бы они были добавлены в этот экземпляр. Этот метод проверяет корректность типа указанных value, но не проверяет, используется ли вычисленный индекс для ссылки на значение в этом TabularData экземпляре.

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

size

int size()

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

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

isEmpty

boolean isEmpty()

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

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

containsKey

boolean containsKey(Object[] key)

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

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

containsValue

boolean containsValue(CompositeData value)

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

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

get

CompositeData get(Object[] key)

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

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

put

void put(CompositeData value)

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

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

remove

CompositeData remove(Object[] key)

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

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

putAll

void putAll(CompositeData[] values)

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

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

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

Parameters:

obj - объект, который нужно сравнить на равенство с этим TabularData объектом;

Returns:

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

See Also:

hashCode

int hashCode()

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

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

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

Overrides:

hashCode в классе Object

Returns:

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

See Also:

toString

String toString()

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

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

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

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.management/javax/management/openmbean/TabularData.html