com.jianggujin.http.util.JMultiValueMap Maven / Gradle / Ivy

Go to download
package com.jianggujin.http.util;

import java.util.List;
import java.util.Map;

/**
 * 多值Map
 * 
 * @author jianggujin
 *
 * @param 
 * @param 
 */
public interface JMultiValueMap extends Map> {

   /**
    * 获得指定键对应的第一个值
    * 
    * @param key
    *           the key
    * @return
    */
   public V getFirst(K key);

   /**
    * 获得指定键对应的最后一个值
    * 
    * @param key
    *           the key
    * @return
    */
   public V getLast(K key);

   /**
    * 获得指定键的制定索引位置的值，索引不合法时返回null
    * 
    * @param key
    * @param index
    * @return
    */
   public V at(K key, int index);

   /**
    * 获得指定键的制定索引位置的值
    * 
    * @param key
    * @param index
    * @return
    */
   public V atThrow(K key, int index);

   /**
    * 添加值到指定键的集合中
    * 
    * @param key
    *           the key
    * @param value
    *           the value to be added
    */
   public void add(K key, V value);

   /**
    * 设置指定键的值
    * 
    * @param key
    *           the key
    * @param value
    *           the value to set
    */
   void set(K key, V value);

   /**
    * 通过Map设置键值
    * 
    * @param values
    *           the values.
    */
   void setAll(Map values);

   /**
    * 转换成具有单值的Map，值取第一个值
    * 
    * @return a single value representation of this map
    */
   Map toSingleValueMap();

}