Guava Multimap接口

Multimap接口扩展了Map，使得可以一次将一个键映射到多个值。

接口声明

以下是 com.google.common.collect.Multimap <K,V> 接口的声明 −

@GwtCompatible
public interface Multimap<K,V>

接口方法

序号	方法与描述
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)` 在此多重映射中为每个值存储键值对，所有键值对都使用相同的键。
15	`boolean putAll(Multimap <? extends K,? extends V> multimap)` 将multimap中的所有key-value对存储在该multimap中，按照multimap.entries()返回的顺序。
16	`boolean remove(Object key, Object value)` 如果存在，则从该multimap中移除具有指定key和value的单个key-value对。
17	`Collection <V> removeAll(Object key)` 移除与指定key关联的所有值。
18	`Collection <V> replaceValues(K key, Iterable<? extends V> values)` 使用相同的key存储一组值，替换该key的所有现有值。
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]