Класс TabularDataSupport

Конструкторы

TabularDataSupport

public TabularDataSupport(TabularType tabularType)

Параметры:

tabularType - табулированный тип, описывающий этот экземпляр TabularData; не может быть null.

Исключения:

IllegalArgumentException - если табулированный тип равен null.

TabularDataSupport

public TabularDataSupport(TabularType tabularType,
                          int initialCapacity,
                          float loadFactor)

Создает пустой экземпляр TabularDataSupport, открытый тип которого — tabularType, а базовый HashMap имеет указанную начальную емкость и коэффициент заполнения.

Параметры:

tabularType - табулированный тип, описывающий этот экземпляр TabularData; не может быть null.

initialCapacity - начальная емкость HashMap.

loadFactor - коэффициент заполнения HashMap.

Исключения:

IllegalArgumentException - если начальная емкость меньше нуля, или коэффициент заполнения неположительный, или табулированный тип равен null.

Методы

getTabularType

public TabularType getTabularType()

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

Указано в:

getTabularType в интерфейсе TabularData

Возвращает:

табулированный тип.

calculateIndex

public Object[] calculateIndex(CompositeData value)

Вычисляет индекс, который будет использоваться в этом экземпляре TabularData для ссылки на указанный параметр составных данных value, если бы он был добавлен в этот экземпляр. Этот метод проверяет допустимость типа указанного value, но не проверяет, используется ли вычисленный индекс уже для ссылки на значение в этом экземпляре TabularData.

Указано в:

calculateIndex в интерфейсе TabularData

Параметры:

value - значение составных данных, индекс которого в этом экземпляре TabularData необходимо вычислить; должно быть того же составного типа, что и тип строки этого экземпляра; не должно быть null.

Возвращает:

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

Исключения:

NullPointerException - если value является null.

InvalidOpenTypeException - если value не соответствует определению типа строки этого экземпляра TabularData.

containsKey

public boolean containsKey(Object key)

Возвращает true тогда и только тогда, когда этот экземпляр TabularData содержит значение CompositeData (т. е. строку), индекс которого является указанным key. Если key не может быть преобразован в одномерный массив экземпляров Object, этот метод просто возвращает false; в противном случае он возвращает результат вызова this.containsKey((Object[]) key).

Указано в:

containsKey в интерфейсе Map<Object,Object>

Параметры:

key - значение индекса, наличие которого в этом экземпляре TabularData необходимо проверить.

Возвращает:

true если этот TabularData индексирует значение строки с указанным ключом.

containsKey

public boolean containsKey(Object[] key)

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

Указано в:

containsKey в интерфейсе TabularData

Параметры:

key - значение индекса, наличие которого в этом экземпляре TabularData необходимо проверить.

Возвращает:

true если этот TabularData индексирует значение строки с указанным ключом.

containsValue

public boolean containsValue(CompositeData value)

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

Указано в:

containsValue в интерфейсе TabularData

Параметры:

value - значение строки, наличие которого в этом экземпляре TabularData необходимо проверить.

Возвращает:

true если этот экземпляр TabularData содержит указанное значение строки.

containsValue

public boolean containsValue(Object value)

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

Указано в:

containsValue в интерфейсе Map<Object,Object>

Параметры:

value - значение строки, наличие которого в этом экземпляре TabularData необходимо проверить.

Возвращает:

true если этот экземпляр TabularData содержит указанное значение строки.

get

public Object get(Object key)

Этот метод просто вызывает get((Object[]) key).

Указано в:

get в интерфейсе Map<Object,Object>

Параметры:

key - ключ, связанное с которым значение должно быть возвращено.

Возвращает:

значение, которому сопоставлен указанный ключ, или null, если эта карта не содержит сопоставления для ключа.

Исключения:

NullPointerException - если key является null

ClassCastException - если key не имеет типа Object[]

InvalidKeyException - если key не соответствует определению TabularData этого экземпляра TabularType

get

public CompositeData get(Object[] key)

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

Указано в:

get в интерфейсе TabularData

Параметры:

key - индекс значения, которое нужно получить в этом экземпляре TabularData; * должно быть допустимым с определением типа строки этого экземпляра TabularData; * не должно быть null.

Возвращает:

значение, соответствующее key.

Исключения:

NullPointerException - если key является null

InvalidKeyException - если key не соответствует определению типа TabularData этого экземпляра TabularType.

put

public Object put(Object key,
                  Object value)

Этот метод просто вызывает put((CompositeData) value) и поэтому игнорирует свой параметр key, который может быть null.

Указано в:

put в интерфейсе Map<Object,Object>

Параметры:

key - игнорируемый параметр.

value - CompositeData для добавления.

Возвращает:

добавленное значение

Исключения:

NullPointerException - если value является null

ClassCastException - если value не имеет типа CompositeData

InvalidOpenTypeException - если value не соответствует определению TabularData этого экземпляра TabularType

KeyAlreadyExistsException - если ключ для параметра value, вычисленный в соответствии с определением TabularData этого экземпляра TabularType, уже отображается на существующее значение.

put

public void put(CompositeData value)

Описание скопировано из интерфейса: TabularData

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

Указано в:

put в интерфейсе TabularData

Параметры:

value - значение составных данных, которое должно быть добавлено как новая строка в этот экземпляр TabularData; должно быть того же составного типа, что и тип строки этого экземпляра; не должно быть null.

remove

public Object remove(Object key)

Этот метод просто вызывает remove((Object[]) key).

Указано в:

remove в интерфейсе Map<Object,Object>

Параметры:

key - Object[], представляющий ключ для удаления.

Возвращает:

предыдущее значение, связанное с указанным ключом, или null, если для ключа не было сопоставления.

Исключения:

NullPointerException - если key является null

ClassCastException - если key не имеет типа Object[]

InvalidKeyException - если key не соответствует определению TabularData этого экземпляра TabularType

remove

public CompositeData remove(Object[] key)

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

Указано в:

remove в интерфейсе TabularData

Параметры:

key - индекс значения, которое нужно получить в этой TabularData инстанции; должен быть валидным для определения типа строки этой TabularData инстанции; не должен быть null.

Возвращает:

предыдущее значение, связанное с указанным ключом, или null, если для ключа не было сопоставления.

Выбрасывает:

NullPointerException - если ключ key является null

InvalidKeyException - если ключ key не соответствует определению типа строки этой TabularData инстанции

putAll

public void putAll(Map<?,?> t)

Добавляет все значения, содержащиеся в указанной карте t, в эту TabularData инстанцию. Этот метод преобразует коллекцию значений, содержащихся в этой карте, в массив значений CompositeData, если это возможно, а затем вызывает метод putAll(CompositeData[]). Обратите внимание, что ключи, используемые в указанной карте t, игнорируются. Этот метод позволяет, например, добавить содержимое другой TabularData инстанции с тем же типом строки (но, возможно, с другими именами индексов) в эту инстанцию.

Указано в:

putAll в интерфейсе Map<Object,Object>

Параметры:

t - карта, значения которой должны быть добавлены в виде новых строк в эту TabularData инстанцию; если t пуста или пустая, этот метод возвращается без выполнения каких-либо действий.

Выбрасывает:

NullPointerException - если значение в t является null.

ClassCastException - если значение в t не является экземпляром CompositeData.

InvalidOpenTypeException - если значение в t не соответствует определению типа строки этой TabularData инстанции.

KeyAlreadyExistsException - если индекс значения в t, вычисленный в соответствии с определением типа строки этой TabularData инстанции, уже сопоставлен с существующим значением в этой инстанции, или два значения в t имеют одинаковый индекс.

putAll

public void putAll(CompositeData[] values)

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

Указано в:

putAll в интерфейсе TabularData

Параметры:

values - массив значений составных данных, которые должны быть добавлены в виде новых строк в эту TabularData инстанцию; если values пуст или пустой, этот метод возвращается без выполнения каких-либо действий.

Выбрасывает:

NullPointerException - если элемент из values является null

InvalidOpenTypeException - если элемент из values не соответствует определению типа строки этой TabularData инстанции (т.е. его определению TabularType)

KeyAlreadyExistsException - если индекс элемента из values, рассчитанный в соответствии с определением типа строки этой TabularData инстанции, уже сопоставлен с существующим значением в этой инстанции, или два элемента из values имеют одинаковый индекс

clear

public void clear()

Удаляет все строки из этой TabularDataSupport инстанции.

Указано в:

clear в интерфейсе Map<Object,Object>

Указано в:

clear в интерфейсе TabularData

size

public int size()

Возвращает количество строк в этой TabularDataSupport инстанции.

Указано в:

size в интерфейсе Map<Object,Object>

Указано в:

size в интерфейсе TabularData

Возвращает:

количество строк в этой TabularDataSupport инстанции.

isEmpty

public boolean isEmpty()

Возвращает true, если эта TabularDataSupport инстанция не содержит строк.

Указано в:

isEmpty в интерфейсе Map<Object,Object>

Указано в:

isEmpty в интерфейсе TabularData

Возвращает:

true, если эта TabularDataSupport инстанция не содержит строк.

keySet

public Set<Object> keySet()

Возвращает представление в виде множества ключей, содержащихся в базовой карте этой TabularDataSupport инстанции, используемой для индексации строк. Каждый ключ, содержащийся в этой Set, является неизменяемым List<?>, поэтому возвращаемое представление множества — это Set<List<?>>, но объявлено как Set<Object> по причинам совместимости. Множество поддерживается базовой картой этой TabularDataSupport инстанции, поэтому изменения в TabularDataSupport инстанции отражаются в множестве, и наоборот. Множество поддерживает удаление элементов, которое удаляет соответствующую строку из этой TabularDataSupport инстанции, через операции Iterator.remove(), Set.remove(java.lang.Object), Set.removeAll(java.util.Collection<?>), Set.retainAll(java.util.Collection<?>) и Set.clear(). Оно не поддерживает операции Set.add(E) или Set.addAll(java.util.Collection<? extends E>).

Указано в:

keySet в интерфейсе Map<Object,Object>

Указано в:

keySet в интерфейсе TabularData

Возвращает:

множество (Set<List<?>>) ключей, используемых для индексации строк этой TabularDataSupport инстанции.

values

public Collection<Object> values()

Возвращает представление в виде коллекции строк, содержащихся в этой TabularDataSupport инстанции. Возвращаемая Collection коллекция — это Collection<CompositeData>, но объявлена как Collection<Object> для совместимости. Возвращаемую коллекцию можно использовать для итерации по значениям. Коллекция поддерживается базовой картой, поэтому изменения в TabularDataSupport инстанции отражаются в коллекции, и наоборот. Коллекция поддерживает удаление элементов, которое удаляет соответствующее отображение индекса на строку из этой TabularDataSupport инстанции, через операции Iterator.remove(), Collection.remove(java.lang.Object), Collection.removeAll(java.util.Collection<?>), Collection.retainAll(java.util.Collection<?>) и Collection.clear(). Оно не поддерживает операции Collection.add(E) или Collection.addAll(java.util.Collection<? extends E>).

Указано в:

values в интерфейсе Map<Object,Object>

Указано в:

values в интерфейсе TabularData

Возвращает:

представление в виде коллекции (Collection<CompositeData>) значений, содержащихся в этой TabularDataSupport инстанции.

entrySet

public Set<Map.Entry<Object,Object>> entrySet()

Указано в:

entrySet в интерфейсе Map<Object,Object>

Возвращает:

представление в виде коллекции (Set<Map.Entry<List<?>,CompositeData>>) отображений, содержащихся в этой карте.

См. также:

Map.Entry

clone

public Object clone()

Возвращает клон этой TabularDataSupport инстанции: клон получается путём вызова super.clone(), а затем клонирования базовой карты. Создаётся только поверхностный клон базовой карты, т.е. клонирование индексов и значений строк не происходит, так как они неизменяемы.

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

clone в классе Object

Возвращает:

клон этой инстанции.

См. также:

Cloneable

equals

public boolean equals(Object obj)

Указано в:

equals в интерфейсе Map<Object,Object>

Указано в:

equals в интерфейсе TabularData

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

equals в классе Object

Параметры:

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

Возвращает:

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

См. также:

Object.hashCode(), HashMap

hashCode

public int hashCode()

Указано в:

hashCode в интерфейсе Map<Object,Object>

Указано в:

hashCode в интерфейсе TabularData

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

hashCode в классе Object

Возвращает:

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

См. также:

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

toString

public String toString()

Указано в:

toString в интерфейсе TabularData

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

toString в классе Object

Возвращает:

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