public class HashBasedTable<R,C,V> extends StandardTable<R,C,V>
Table
using linked hash tables. This guarantees predictable iteration
order of the various views.
The views returned by StandardTable.column(C)
, StandardTable.columnKeySet()
, and StandardTable.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.
See the Guava User Guide article on Table
.
Modifier and Type | Class and Description |
---|---|
private static class |
HashBasedTable.Factory<C,V> |
StandardTable.Row, StandardTable.RowMap
AbstractTable.CellSet, AbstractTable.Values
Table.Cell<R,C,V>
Modifier and Type | Field and Description |
---|---|
private static long |
serialVersionUID |
backingMap, factory
Constructor and Description |
---|
HashBasedTable(java.util.Map<R,java.util.Map<C,V>> backingMap,
HashBasedTable.Factory<C,V> factory) |
Modifier and Type | Method and Description |
---|---|
static <R,C,V> HashBasedTable<R,C,V> |
create()
Creates an empty
HashBasedTable . |
static <R,C,V> HashBasedTable<R,C,V> |
create(int expectedRows,
int expectedCellsPerRow)
Creates an empty
HashBasedTable with the specified map sizes. |
static <R,C,V> HashBasedTable<R,C,V> |
create(Table<? extends R,? extends C,? extends V> table)
Creates a
HashBasedTable with the same mappings as the specified table. |
cellIterator, cellSet, cellSpliterator, clear, column, columnKeySet, columnMap, contains, containsColumn, containsRow, containsValue, createColumnKeyIterator, createRowMap, get, isEmpty, put, remove, row, rowKeySet, rowMap, size, values
createCellSet, createValues, equals, hashCode, putAll, toString, valuesIterator, valuesSpliterator
private static final long serialVersionUID
public static <R,C,V> HashBasedTable<R,C,V> create()
HashBasedTable
.public static <R,C,V> HashBasedTable<R,C,V> create(int expectedRows, int expectedCellsPerRow)
HashBasedTable
with the specified map sizes.expectedRows
- the expected number of distinct row keysexpectedCellsPerRow
- the expected number of column key / value mappings in each rowjava.lang.IllegalArgumentException
- if expectedRows
or expectedCellsPerRow
is
negativepublic static <R,C,V> HashBasedTable<R,C,V> create(Table<? extends R,? extends C,? extends V> table)
HashBasedTable
with the same mappings as the specified table.table
- the table to copyjava.lang.NullPointerException
- if any of the row keys, column keys, or values in table
is
null