Table 类 - Google Guava

一、Table简介

Table 代表一个特殊的映射，其中两个键可以在组合的方式被指定为单个值。它类似于创建映射的映射。

通常来说，当你想使用多个键做索引的时候，你可能会用类似 Map<FirstName, Map<LastName, Person>> 的实现，这种方式很丑陋，使用上也不友好。

Guava为此提供了新集合类型 Table，它有两个支持所有类型的键：”行”和”列”，类似效果：Map --> Table --> rowKey+columnKye+value

 

1. 子接口

RowSortedTable

 

2. 实现类

Table 有如下几种实现：

• HashBasedTable：本质上用 HashMap<R, HashMap<C, V>> 实现；

• TreeBasedTable：本质上用 TreeMap<R, TreeMap<C,V>> 实现；

• ImmutableTable：本质上用 ImmutableMap<R, ImmutableMap<C, V>> 实现；注：ImmutableTable对稀疏或密集的数据集都有优化。

• ArrayTable：要求在构造时就指定行和列的大小，本质上由一个二维数组实现，以提升访问速度和密集Table的内存利用率。ArrayTable与其他Table的工作原理有点不同，请参见Javadoc了解详情。

 

二、常用方法

官方文档：https://google.github.io/guava/releases/27.0.1-jre/api/docs/src-html/com/google/common/collect/Table.html

修饰符和类型	方法描述
Set<Table.Cell<R,C,V>>	cellSet()  返回以 Table.Cell 为元素的Set集合，类似于 Map.entrySet.
void	clear()  删除Table中所有的行列映射关系.
Map<R,V>	column(C columnKey)  返回指定columnKey下的所有rowKey与value映射.
Set<C>	columnKeySet()  返回所有的columnKey.
Map<C,Map<R,V>>	columnMap()  返回已columnKey为外层map键值的Map<r，map>.
boolean	contains(@Nullable Object rowKey, @Nullable Object columnKey)  判断Table中是否存在指定行列值的映射关系.
boolean	containsColumn(@Nullable Object columnKey)  判断Table中是否存在列值.
boolean	containsRow(@Nullable Object rowKey)  判断Table中是否存在行值.
boolean	containsValue(@Nullable Object value)  判断Table中是否包含指定的value值.
boolean	equals(@Nullable Object obj)  Compares the specified object with this table for equality.
V	get(@Nullable Object rowKey, @Nullable Object columnKey)  根据行值和列值获取value值.
int	hashCode()  返回此表的哈希码.
boolean	isEmpty()  如果表不包含映射，则返回true.
V	put(R rowKey, C columnKey, V value)  在指定row和column处放入value值.
void	putAll(Table<? extends R,? extends C,? extends V> table)  将指定表中的所有映射复制到此表.
V	remove(@Nullable Object rowKey, @Nullable Object columnKey)  删除指定行列的value值.
Map<C,V>	row(R rowKey)  返回指定rowKey下的所有columnKey与value映射.
Set<R>	rowKeySet()  返回所有的rowKey.
Map<R,Map<C,V>>	rowMap()  返回以rowkey为外层map键值的Map<r，map>.
int	size()  返回表中的行键/列键/值映射的数量.
Collection<V>	values()  返回各行各列中所有的value值.

Table<String, String, String> table = HashBasedTable.create();

// 使用员工详细信息初始化表
table.put("cas", "101", "zhangsan");
table.put("cas", "102", "lisi");
table.put("cas", "103", "wangwu");