Интерфейс 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)

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

equals в классе Object

Параметры:

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

Возвращает:

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

См. также:

Object.hashCode(), HashMap

hashCode

int hashCode()

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

hashCode в классе Object

Возвращает:

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

См. также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

String toString()

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

toString в классе Object

Возвращает:

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