Guava - Multimap 接口
Multimap 接口扩展了 Map,使其键可以一次映射到多个值。
接口声明
以下是 com.google.common.collect.Multimap<K,V> 接口的声明 −
@GwtCompatible public interface Multimap<K,V>
接口方法
Sr.No | 方法及描述 |
---|---|
1 |
Map<K,Collection<V>> asMap() 返回此多重映射的视图,作为从每个不同键到该键关联值的非空集合的映射。 |
2 |
void clear() 从多重映射中删除所有键值对,将其留空。 |
3 |
boolean containsEntry(Object key, Object value) 如果此多重映射包含至少一个包含键和值的键值对,则返回 true。 |
4 |
boolean containsKey(Object key) 如果此多重映射至少包含一个键值对,则返回 true。 |
5 | boolean containsValue(Object value) 如果此多重映射包含至少一个带有值的键值对,则返回 true。 |
6 |
Collection<Map.Entry<K,V>> entries() 返回此多重映射中包含的所有键值对的视图集合,作为 Map.Entry 实例。 |
7 |
boolean equals(Object obj) 比较指定对象与此多重映射是否相等。 |
8 |
Collection<V> get(K key) 返回与此多重映射中的键关联的值的视图集合(如果有)。 |
9 |
int hashCode() 返回此多重映射的哈希代码。 |
10 |
boolean isEmpty() 如果此多重映射不包含键值对,则返回 true。 |
11 |
Multiset<K> keys() 返回一个视图集合,其中包含此多重映射中每个键值对的键,而不折叠重复项。 |
12 |
Set<K> keySet() 返回此多重映射中包含的所有不同键的视图集合。 |
13 |
boolean put(K key, V value) 在此多重映射中存储键值对。 |
14 |
boolean putAll(K key, Iterable<? extends V> values) 在此多重映射中为每个值存储一个键值对,所有值都使用相同的键 key。 |
15 |
boolean putAll(Multimap<? extends K,? extends V> multimap) 按照 multimap.entries() 返回的顺序,存储此 multimap 中 multimap 的所有键值对。 |
16 |
boolean remove(Object key, Object value) 从该多重映射中删除带有键和值的单个键值对(如果存在)。 |
17 |
Collection<V> removeAll(Object key) 删除与该键关联的所有值。 |
18 |
Collection<V> replaceValues(K key, Iterable<? extends V> values) 使用相同的键存储值的集合,替换该键的任何现有值。 |
19 |
int size() 返回此多重映射中键值对的数量。 |
20 |
Collection<V> values() 返回一个视图集合,其中包含此多重映射中包含的每个键值对的值,而不折叠重复项(因此values().size() == size())。 |
多重映射示例
使用您在 C:/> Guava 中选择的任何编辑器创建以下 java 程序。
GuavaTester.java
import java.util.Collection; import java.util.List; import java.util.Map; import java.util.Set; import com.google.common.collect.ArrayListMultimap; import com.google.common.collect.Multimap; public class GuavaTester { public static void main(String args[]) { GuavaTester tester = new GuavaTester(); Multimap<String,String> multimap = tester.getMultimap(); List<String> lowerList = (List<String>)multimap.get("lower"); System.out.println("Initial lower case list"); System.out.println(lowerList.toString()); lowerList.add("f"); System.out.println("Modified lower case list"); System.out.println(lowerList.toString()); List<String> upperList = (List<String>)multimap.get("upper"); System.out.println("Initial upper case list"); System.out.println(upperList.toString()); upperList.remove("D"); System.out.println("Modified upper case list"); System.out.println(upperList.toString()); Map<String, Collection<String>> map = multimap.asMap(); System.out.println("Multimap as a map"); for (Map.Entry<String, Collection<String>> entry : map.entrySet()) { String key = entry.getKey(); Collection<String> value = multimap.get("lower"); System.out.println(key + ":" + value); } System.out.println("Keys of Multimap"); Set<String> keys = multimap.keySet(); for(String key:keys) { System.out.println(key); } System.out.println("Values of Multimap"); Collection<String> values = multimap.values(); System.out.println(values); } private Multimap<String,String> getMultimap() { //Map<String, List<String>> // lower -> a, b, c, d, e // upper -> A, B, C, D Multimap<String,String> multimap = ArrayListMultimap.create(); multimap.put("lower", "a"); multimap.put("lower", "b"); multimap.put("lower", "c"); multimap.put("lower", "d"); multimap.put("lower", "e"); multimap.put("upper", "A"); multimap.put("upper", "B"); multimap.put("upper", "C"); multimap.put("upper", "D"); return multimap; } }
验证结果
使用javac编译器编译类,如下所示 −
C:\Guava>javac GuavaTester.java
现在运行 GuavaTester 查看结果。
C:\Guava>java GuavaTester
查看结果。
Initial lower case list [a, b, c, d, e] Modified lower case list [a, b, c, d, e, f] Initial upper case list [A, B, C, D] Modified upper case list [A, B, C] Multimap as a map upper:[a, b, c, d, e, f] lower:[a, b, c, d, e, f] Keys of Multimap upper lower Values of Multimap [a, b, c, d, e, f, A, B, C]
guava_collections_utilities.html