Интерфейс 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`, если нет значения, сопоставленного с `key`, в этом `TabularData` экземпляре.
`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 если нет значения, сопоставленного с key в этом TabularData экземпляре.

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

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

Параметры:

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

Возвращает:

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

См. также:

toString

String toString()

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

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

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

© 1993, 2023, 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/21/docs/api/java.management/javax/management/openmbean/TabularData.html