Интерфейс 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 или не соответствует определению TabularType этого экземпляра 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 не соответствует определению * TabularType этого экземпляра TabularData

put

void put(CompositeData value)

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

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

remove

CompositeData remove(Object[] key)

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

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

putAll

void putAll(CompositeData[] values)

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

Параметры:: values — массив значений составных данных, добавляемых в качестве новых строк в этот экземпляр TabularData; если values равен null или пуст, метод завершается, ничего не выполняя.
Вызывает:: NullPointerException — если элемент values равен null; InvalidOpenTypeException — если элемент values не соответствует определению типа строк этого экземпляра TabularData; KeyAlreadyExistsException — если индекс элемента values, вычисленный согласно определению TabularType этого экземпляра TabularData, уже соответствует существующему значению в этом экземпляре или два элемента 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.

Переопределяет:

equals в классе Object

Параметры:

obj — объект, который необходимо сравнить на равенство с этим экземпляром TabularData;

Возвращает:

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

См. также:

hashCode

int hashCode()

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

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

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

Переопределяет:

hashCode в классе Object

Возвращает:

значение хеш-кода для этого экземпляра TabularDataSupport

См. также:

toString

String toString()

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

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

Переопределяет:: toString в классе Object
Возвращает:: строковое представление этого экземпляра 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://docs.oracle.com/en/java/javase/25/docs/api/java.management/javax/management/openmbean/TabularData.html