Class StandardTable<R,C,V>
- All Implemented Interfaces:
Table<R,,C, V> Serializable
- Direct Known Subclasses:
HashBasedTable,StandardRowSortedTable
Table implementation backed by a map that associates row keys with column key / value
secondary maps. This class provides rapid access to records by the row key alone or by both keys,
but not by just the column key.
The views returned by column(C), columnKeySet(), and columnMap() have
iterators that don't support remove(). Otherwise, all optional operations are supported.
Null row keys, columns keys, and values are not supported.
Lookups by row key are often faster than lookups by column key, because the data is stored in
a Map<R, Map<C, V>>. A method call like column(columnKey).get(rowKey) still runs
quickly, since the row key is provided. However, column(columnKey).size() takes longer,
since an iteration across all row keys occurs.
Note that this implementation is not synchronized. If multiple threads access this table concurrently and one of the threads modifies the table, it must be synchronized externally.
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionprivate classprivate classprivate classprivate classprivate class(package private) class(package private) classprivate classAbstract set whoseisEmpty()returns whether the table is empty and whoseclear()clears all table mappings.Nested classes/interfaces inherited from class com.google.common.collect.AbstractTable
AbstractTable.CellSet, AbstractTable.ValuesNested classes/interfaces inherited from interface com.google.common.collect.Table
Table.Cell<R,C, V> -
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescription(package private) Iterator<Table.Cell<R, C, V>> Set<Table.Cell<R, C, V>> cellSet()Returns a set of all row key / column key / value triplets.(package private) Spliterator<Table.Cell<R, C, V>> voidclear()Removes all mappings from the table.Returns a view of all mappings that have the given column key.Returns a set of column keys that have one or more values in the table.Returns a view that associates each column key with the corresponding map from row keys to values.booleanReturnstrueif the table contains a mapping with the specified row and column keys.booleancontainsColumn(Object columnKey) Returnstrueif the table contains a mapping with the specified column.private booleancontainsMapping(Object rowKey, Object columnKey, Object value) booleancontainsRow(Object rowKey) Returnstrueif the table contains a mapping with the specified row key.booleancontainsValue(Object value) Returnstrueif the table contains a mapping with the specified value.Creates an iterator that returns each column value with duplicates omitted.Returns the value corresponding to the given row and column keys, ornullif no such mapping exists.getOrCreate(R rowKey) booleanisEmpty()Returnstrueif the table contains no mappings.Associates the specified value with the specified keys.Removes the mapping, if any, associated with the given keys.removeColumn(Object column) private booleanremoveMapping(Object rowKey, Object columnKey, Object value) Remove a row key / column key / value mapping, if present.Returns a view of all mappings that have the given row key.Returns a set of row keys that have one or more values in the table.rowMap()Returns a view that associates each row key with the corresponding map from column keys to values.intsize()Returns the number of row key / column key / value mappings in the table.values()Returns a collection of all values, which may contain duplicates.Methods inherited from class com.google.common.collect.AbstractTable
createCellSet, createValues, equals, hashCode, putAll, toString, valuesIterator, valuesSpliterator
-
Field Details
-
backingMap
-
factory
-
columnKeySet
-
rowMap
-
columnMap
-
serialVersionUID
private static final long serialVersionUID- See Also:
-
-
Constructor Details
-
StandardTable
-
-
Method Details
-
contains
Description copied from interface:TableReturnstrueif the table contains a mapping with the specified row and column keys. -
containsColumn
Description copied from interface:TableReturnstrueif the table contains a mapping with the specified column.- Specified by:
containsColumnin interfaceTable<R,C, V> - Overrides:
containsColumnin classAbstractTable<R,C, V> - Parameters:
columnKey- key of column to search for
-
containsRow
Description copied from interface:TableReturnstrueif the table contains a mapping with the specified row key.- Specified by:
containsRowin interfaceTable<R,C, V> - Overrides:
containsRowin classAbstractTable<R,C, V> - Parameters:
rowKey- key of row to search for
-
containsValue
Description copied from interface:TableReturnstrueif the table contains a mapping with the specified value.- Specified by:
containsValuein interfaceTable<R,C, V> - Overrides:
containsValuein classAbstractTable<R,C, V> - Parameters:
value- value to search for
-
get
Description copied from interface:TableReturns the value corresponding to the given row and column keys, ornullif no such mapping exists. -
isEmpty
public boolean isEmpty()Description copied from interface:TableReturnstrueif the table contains no mappings. -
size
public int size()Description copied from interface:TableReturns the number of row key / column key / value mappings in the table. -
clear
public void clear()Description copied from interface:TableRemoves all mappings from the table. -
getOrCreate
-
put
Description copied from interface:TableAssociates the specified value with the specified keys. If the table already contained a mapping for those keys, the old value is replaced with the specified value.- Specified by:
putin interfaceTable<R,C, V> - Overrides:
putin classAbstractTable<R,C, V> - Parameters:
rowKey- row key that the value should be associated withcolumnKey- column key that the value should be associated withvalue- value to be associated with the specified keys- Returns:
- the value previously associated with the keys, or
nullif no mapping existed for the keys
-
remove
Description copied from interface:TableRemoves the mapping, if any, associated with the given keys. -
removeColumn
-
containsMapping
-
removeMapping
private boolean removeMapping(@CheckForNull Object rowKey, @CheckForNull Object columnKey, @CheckForNull Object value) Remove a row key / column key / value mapping, if present. -
cellSet
Returns a set of all row key / column key / value triplets. Changes to the returned set will update the underlying table, and vice versa. The cell set does not support theaddoraddAllmethods.The set's iterator traverses the mappings for the first row, the mappings for the second row, and so on.
Each cell is an immutable snapshot of a row key / column key / value mapping, taken at the time the cell is returned by a method call to the set or its iterator.
-
cellIterator
Iterator<Table.Cell<R,C, cellIterator()V>> - Specified by:
cellIteratorin classAbstractTable<R,C, V>
-
cellSpliterator
Spliterator<Table.Cell<R,C, cellSpliterator()V>> - Specified by:
cellSpliteratorin classAbstractTable<R,C, V>
-
row
Description copied from interface:TableReturns a view of all mappings that have the given row key. For each row key / column key / value mapping in the table with that row key, the returned map associates the column key with the value. If no mappings in the table have the provided row key, an empty map is returned.Changes to the returned map will update the underlying table, and vice versa.
-
column
Returns a view of all mappings that have the given column key. For each row key / column key / value mapping in the table with that column key, the returned map associates the row key with the value. If no mappings in the table have the provided column key, an empty map is returned.Changes to the returned map will update the underlying table, and vice versa.
The returned map's views have iterators that don't support
remove(). -
rowKeySet
Description copied from interface:TableReturns a set of row keys that have one or more values in the table. Changes to the set will update the underlying table, and vice versa. -
columnKeySet
Returns a set of column keys that have one or more values in the table. Changes to the set will update the underlying table, and vice versa.The returned set has an iterator that does not support
remove().The set's iterator traverses the columns of the first row, the columns of the second row, etc., skipping any columns that have appeared previously.
- Specified by:
columnKeySetin interfaceTable<R,C, V> - Overrides:
columnKeySetin classAbstractTable<R,C, V> - Returns:
- set of column keys
-
createColumnKeyIterator
Creates an iterator that returns each column value with duplicates omitted. -
values
Returns a collection of all values, which may contain duplicates. Changes to the returned collection will update the underlying table, and vice versa.The collection's iterator traverses the values for the first row, the values for the second row, and so on.
-
rowMap
Description copied from interface:TableReturns a view that associates each row key with the corresponding map from column keys to values. Changes to the returned map will update this table. The returned map does not supportput()orputAll(), orsetValue()on its entries.In contrast, the maps returned by
rowMap().get()have the same behavior as those returned byTable.row(R). Those maps may supportsetValue(),put(), andputAll(). -
createRowMap
-
columnMap
Description copied from interface:TableReturns a view that associates each column key with the corresponding map from row keys to values. Changes to the returned map will update this table. The returned map does not supportput()orputAll(), orsetValue()on its entries.In contrast, the maps returned by
columnMap().get()have the same behavior as those returned byTable.column(C). Those maps may supportsetValue(),put(), andputAll().
-