Class ImmutableTable.Builder<R,C,V>
- java.lang.Object
-
- com.google.common.collect.ImmutableTable.Builder<R,C,V>
-
- Enclosing class:
- ImmutableTable<R,C,V>
@Deprecated(since="2022-12-01") public static final class ImmutableTable.Builder<R,C,V> extends java.lang.Object
Deprecated.The Google Guava Core Libraries are deprecated and will not be part of the AEM SDK after April 2023A builder for creating immutable table instances, especiallypublic static final
tables ("constant tables"). Example:static final ImmutableTable<Integer, Character, String> SPREADSHEET = new ImmutableTable.Builder<Integer, Character, String>() .put(1, 'A', "foo") .put(1, 'B', "bar") .put(2, 'A', "baz") .build();
By default, the order in which cells are added to the builder determines the iteration ordering of all views in the returned table, with
putAll(com.google.common.collect.Table<? extends R, ? extends C, ? extends V>)
following theTable.cellSet()
iteration order. However, iforderRowsBy(java.util.Comparator<? super R>)
ororderColumnsBy(java.util.Comparator<? super C>)
is called, the views are sorted by the supplied comparators. For empty or single-cell immutable tables,ImmutableTable.of()
andImmutableTable.of(Object, Object, Object)
are even more convenient.Builder instances can be reused - it is safe to call
build()
multiple times to build multiple tables in series. Each table is a superset of the tables created before it.- Since:
- 11.0
-
-
Constructor Summary
Constructors Constructor Description Builder()
Deprecated.Creates a new builder.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description ImmutableTable<R,C,V>
build()
Deprecated.Returns a newly-created immutable table.ImmutableTable.Builder<R,C,V>
orderColumnsBy(java.util.Comparator<? super C> columnComparator)
Deprecated.Specifies the ordering of the generated table's columns.ImmutableTable.Builder<R,C,V>
orderRowsBy(java.util.Comparator<? super R> rowComparator)
Deprecated.Specifies the ordering of the generated table's rows.ImmutableTable.Builder<R,C,V>
put(Table.Cell<? extends R,? extends C,? extends V> cell)
Deprecated.Adds the givencell
to the table, making it immutable if necessary.ImmutableTable.Builder<R,C,V>
put(R rowKey, C columnKey, V value)
Deprecated.Associates the (rowKey
,columnKey
) pair withvalue
in the built table.ImmutableTable.Builder<R,C,V>
putAll(Table<? extends R,? extends C,? extends V> table)
Deprecated.Associates all of the given table's keys and values in the built table.
-
-
-
Constructor Detail
-
Builder
public Builder()
Deprecated.Creates a new builder. The returned builder is equivalent to the builder generated byImmutableTable.builder()
.
-
-
Method Detail
-
orderRowsBy
public ImmutableTable.Builder<R,C,V> orderRowsBy(java.util.Comparator<? super R> rowComparator)
Deprecated.Specifies the ordering of the generated table's rows.
-
orderColumnsBy
public ImmutableTable.Builder<R,C,V> orderColumnsBy(java.util.Comparator<? super C> columnComparator)
Deprecated.Specifies the ordering of the generated table's columns.
-
put
public ImmutableTable.Builder<R,C,V> put(R rowKey, C columnKey, V value)
Deprecated.Associates the (rowKey
,columnKey
) pair withvalue
in the built table. Duplicate key pairs are not allowed and will causebuild()
to fail.
-
put
public ImmutableTable.Builder<R,C,V> put(Table.Cell<? extends R,? extends C,? extends V> cell)
Deprecated.Adds the givencell
to the table, making it immutable if necessary. Duplicate key pairs are not allowed and will causebuild()
to fail.
-
putAll
public ImmutableTable.Builder<R,C,V> putAll(Table<? extends R,? extends C,? extends V> table)
Deprecated.Associates all of the given table's keys and values in the built table. Duplicate row key column key pairs are not allowed, and will causebuild()
to fail.- Throws:
java.lang.NullPointerException
- if any key or value intable
is null
-
build
public ImmutableTable<R,C,V> build()
Deprecated.Returns a newly-created immutable table.- Throws:
java.lang.IllegalArgumentException
- if duplicate key pairs were added
-
-