教程 > Guava 教程 > Guava 基础 阅读：17

Guava Multimap 接口

返回 Guava Collections 实用程序

Multimap 接口扩展了 Map，因此它的键可以一次映射到多个值。

接口声明

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

@GwtCompatible
public interface Multimap<K,V>

接口方法

序号 方法 说明
1 Map<K,Collection<V>> asMap() 返回此 multimap 的视图作为从每个不同键到该键关联值的非空集合的 Map。
2 void clear() 从 multimap 中删除所有键值对，将其留空。
3 boolean containsEntry(Object key, Object value) 如果此 multimap 包含至少一对具有键和值的键值对，则返回 true。
4 boolean containsKey(Object key) 如果此 multimap 包含至少一个带有键的键值对，则返回 true。
5 boolean containsValue(Object value) 如果此 multimap 包含至少一个具有该值的键值对，则返回 true。
6 Collection<Map.Entry<K,V>> entries() 返回此 multimap 中包含的所有键值对的视图集合，作为 Map.Entry 实例。
7 boolean equals(Object obj) 比较指定对象与此 multimap 是否相等。
8 Collection<V> get(K key) 返回与此 multimap 中的键关联的值的视图集合（如果有）。
9 int hashCode() 返回此 multimap 的哈希码。
10 boolean isEmpty() 如果此 multimap 不包含键值对，则返回 true。
11 Multiset<K> keys() 返回一个视图集合，其中包含此 multimap 中每个键值对的键，不折叠重复项。
12 Set<K> keySet() 返回此 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.entries() 返回的顺序存储此 multimap 中 multimap 的所有键值对。
16 boolean remove(Object key, Object value) 如果存在，则从该 multimap 中删除具有键和值的单个键值对。
17 Collection<V> removeAll(Object key) 删除与键关联的所有值。
18 Collection<V> replaceValues(K key, Iterable<? extends V> values) 存储具有相同键的值集合，替换该键的任何现有值。
19 int size() 返回此 multimap 中键值对的数量。
20 Collection<V> values() 返回一个视图集合，其中包含此 multimap 中包含的每个键值对的值，不折叠重复项（因此 values().size() == size()）。

Multimap 的例子

在 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 实用程序

查看笔记

扫码一下
查看教程更方便