MapList 维护了一个key对一个列表的映射关系

package nc.vo.pubapp.pattern.pub;

import java.io.Serializable;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Map.Entry;
import java.util.Set;

/**
 * MapList维护了一个key对一个列表的映射关系。每次放入一个键值对时， 会将值放在该键对应的列表中，如果列表不存
 * 在则创建列表
 * 
 * @param <K> 键的类型
 * @param <V> 值的类型
 */
public class MapList<K, V> implements Serializable {
  private static final long serialVersionUID = -4970977770408734801L;

  /**
   * 存放key和列表映射关系的数据集合
   */
  private Map<K, List<V>> map = new HashMap<K, List<V>>();

  /**
   * 是否包含当前键
   * 
   * @param key 键
   * @return 当前MapList包含此键时，返回true
   */
  public boolean containsKey(K key) {
    return this.map.containsKey(key);
  }

  /**
   * 根据键获取列表
   * 
   * @param key 键
   * @return 键对应的列表
   */
  public List<V> get(K key) {
    return this.map.get(key);
  }
  
  
  /**
   * 根据键移除值
   * 
   * @param key 键
   * @return 键对应的列表
   */
  public List<V> remove(K key) {
    return this.map.remove(key);
  }

  /**
   * 获取键的集合
   * 
   * @return 键的集合
   */
  public Set<K> keySet() {
    return this.map.keySet();
  }

  /**
   * 获取当前MapList的视图，用来快速访问里面存储的元素
   * 
   * @return 当前MapList的视图
   */
  public Set<Entry<K, List<V>>> entrySet() {
    return this.map.entrySet();
  }

  /**
   * 加入一个键值对。当前键不存在时，会自动创建列表。否则，将值加入到对应的列表中
   * 
   * @param key 键
   * @param value 值
   */
  public void put(K key, V value) {
    List<V> l = this.map.get(key);
    if (l == null) {
      l = new ArrayList<V>();
      this.map.put(key, l);
    }
    l.add(value);
  }

  /**
   * 将一个值列表全部加入到键值对中
   * 
   * @param key 键
   * @param valueList 值的列表
   */
  public void putAll(K key, List<V> valueList) {
    List<V> l = this.map.get(key);
    if (l == null) {
      l = new ArrayList<V>();
      this.map.put(key, l);
    }
    l.addAll(valueList);
  }

  /**
   * 得到键的数量
   * 
   * @return 当前MapList的大小
   */
  public int size() {
    return this.map.size();
  }

  /**
   * 转化为原始的Map对象
   * 
   * @return JDK基本数据结构形式
   */
  public Map<K, List<V>> toMap() {
    return this.map;
  }
}