Guava Multimap類
多重映射接口擴展映射，使得其鍵一次可被映射到多個值。
接口聲明
以下是com.google.common.collect.Multimap<K，V>接口的聲明：
@GwtCompatible
public interface Multimap<K,V>
接口方法
S.N.
方法及說明
1
Map<K,Collection
返回此multimap中的視圖，從每個不同的鍵在鍵的關聯值的非空集合映射。
2
void clear()
將刪除所有multimap中的鍵值對，留下空。
3
boolean containsEntry(Object key, Object value)
返回true如果此多重映射包含至少一個鍵 - 值對用鍵鍵和值value。
4
boolean containsKey(Object key)
返回true，如果這個multimap中至少包含一個鍵值對的鍵key。
5
boolean containsValue(Object value)
返回true，如果這個multimap至少包含一個鍵值對的值值。
6
Collection<Map.Entry<K,V>> entries()
返回包含在此multimap中，爲Map.Entry的情況下，所有的鍵 - 值對的視圖集合。
7
boolean equals(Object obj)
比較指定對象與此多重映射是否相等。
8
Collection
返回，如果有的話，在這個multimap中鍵關聯的值的視圖集合。
9
int hashCode()
返回此多重映射的哈希碼。
10
boolean isEmpty()
返回true，如果這個multimap中未包含鍵 - 值對。
11
Multiset
返回一個視圖集合包含從每個鍵值對這個multimap中的關鍵，沒有摺疊重複。
12
Set
Returns a view collection of all distinct keys contained in this multimap.
13
boolean put(K key, V value)
存儲鍵 - 值對在這個multimap中。
14
boolean putAll(K key, Iterable<? extends V> values)
存儲一個鍵 - 值對在此multimap中的每個值，都使用相同的鍵 key。
15
boolean putAll(Multimap<? extends K,? extends V> multimap)
存儲了所有鍵 - 值對多重映射在這個multimap中，通過返回 multimap.entries() 的順序.
16
boolean remove(Object key, Object value)
刪除一個鍵 - 值對用鍵鍵，並從該多重映射的值的值，如果這樣的存在。
17
Collection
刪除與鍵鍵關聯的所有值。
18
Collection
存儲與相同的鍵值，替換任何現有值的鍵的集合。
19
int size()
返回此多重映射鍵 - 值對的數量。
20
Collection
返回一個視圖集合包含從包含在該multimap中的每個鍵 - 值對的值，而不發生重複 (so values().size() == size()).
Multimap 示例
使用所選擇的任何編輯器創建下面的java程序 C:/> Guava
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
// 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, a, b, c, d, e, f]