Интерфейс 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 , если в этом 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 вычисляется в соответствии с определением 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.

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

hashCode

int hashCode()

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

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

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

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

toString

String toString()

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

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

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

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