MultiValueMap

在日常的开发中经常用到键值对，也就是Map啦，我们知道Map是一个接口，它的特点是一个Key对应一个Value，也就是一个键对应一个值，但是往往我们需要一个Key对应多个Value，这种时候系统的API就无法满足我们的需要了，因此今天介绍一个我封装的一个Key对应多个Value，既一个键对应多个值的MultiValueMap。  　　第二个，我们的MultiValueMap要想什么Key-Value都可以放，就要用到泛型，泛型不好的同学也不用担心，只要你用过Map、HashMap我保准你看得懂。

用过Map的人都知道，Map是一个接口（interface），所以我们这里也把MultiValueMap定义成一个接口。那么需要那些方法呢，我们来列个表：

添加一个Key对应一个Value的：void add(K, V);

添加一个Key对应多个Value的：void add(K, List);

设置一个Key对应一个Value的：void set(K, V);

设置一个Key对应多个Value的：void set(K, List);

移除一个Key和它对应的Value：List remove(K);

清除所有Value的：void clear();

拿到所有Key的集合：Set keySet();

拿到所有的值：List values();

拿到一个Key对应的某个值：V getValue(K, index);

拿到一个Key对应的所有Value：List getValues(K);

拿到MultiValueMap的大小：int size();

判断是否为空MultiValueMap：boolean isEmpty();

判断是否包含某个Key：boolean containKey(K);

下面我们根据分析先把MultiValueMap接口定义出来，其实这个封装是我的开源项目NoHttp中提出来的，有兴趣的看官光顾下NoHttp，废话不多说，上代码：

import java.util.List;import java.util.Map;import java.util.Set;/** *

Can save multiple the value of the map.

* Created in Jan 10, 2016 5:00:07 PM. * * @authorYan Zhenjie; */public interfaceMultiValueMap { /** * 添加Key-Value。 * * @paramkey key. * @paramvalue value. */ void add(K key, V value);

    /**    * 添加Key-List。    *    * @paramkey    key.    * @paramvalues values.    */    void add(K key, List values);

    /**    * 设置一个Key-Value，如果这个Key存在就被替换，不存在则被添加。    *    * @paramkey  key.    * @paramvalue values.    */    void set(K key, V value);

    /**    * 设置Key-List，如果这个Key存在就被替换，不存在则被添加。    * @paramkey    key.    * @paramvalues values.    * @see#set(Object, Object)    */    void set(K key, List values);

    /**    * 替换所有的Key-List。    *    * @paramvalues values.    */    void set(Map> values);

    /**    * 移除某一个Key，对应的所有值也将被移除。    *    * @paramkey key.    * @returnvalue.    */    List remove(K key);

    /**

    * 移除所有的值。

    * Remove all key-value.

    */    void clear();

    /**    * 拿到Key的集合。    * @returnSet.    */    Set keySet();

    /**    * 拿到所有的值的集合。    *    * @returnList.    */    List values();

    /**    * 拿到某一个Key下的某一个值。    *    * @paramkey  key.    * @paramindex index value.    * @returnThe value.    */    V getValue(K key, int index);

    /**    * 拿到某一个Key的所有值。    *    * @paramkey key.    * @returnvalues.    */    List getValues(K key);

    /**    * 拿到MultiValueMap的大小.    *    * @returnsize.    */    int size();

    /**    * 判断MultiValueMap是否为null.    *    * @returnTrue: empty, false: not empty.    */    boolean isEmpty();

    /**    * 判断MultiValueMap是否包含某个Key.    *    * @paramkey key.    * @returnTrue: contain, false: none.    */    boolean containsKey(K key);

}

MultiValueMap接口的实现类LinkedMultiValueMap

例子：

public static void main(String[] args) {

    MultiValueMap stringMultiValueMap = new LinkedMultiValueMap<>();

    // 添加Key为name的    stringMultiValueMap.add("name", "yolanda");

    stringMultiValueMap.add("name", "yanzhenjie");

    stringMultiValueMap.add("name", "严振杰");

    stringMultiValueMap.add("name", "尤兰达");

    // 添加Key为domain的    stringMultiValueMap.add("domain", "http://www.yanzhenjie.com");

    stringMultiValueMap.add("domain", "http://www.nohttp.net");

    // 拿到某个key的某个值    System.out.println("name的第三个值：" + stringMultiValueMap.getValue("name", 3));

    // 打印所有值    Set keySet = stringMultiValueMap.keySet();

    for (String key : keySet) {

        List values = stringMultiValueMap.getValues(key);

        for (String value : values) {

            System.out.println(key + ": " + value);

        }

    }

}