Map
Map 是一个键值对(key-value)映射接口。Map映射中不能包含重复的键;每个键最多只能映射到一个值。
Map 接口提供三种collection 视图,允许以键集、值集或键-值映射关系集的形式查看某个映射的内容。
Map 映射顺序。有些实现类,可以明确保证其顺序,如 TreeMap;另一些映射实现则不保证顺序,如 HashMap 类。
Map 的实现类应该提供2个“标准的”构造方法:第一个,void(无参数)构造方法,用于创建空映射;第二个,带有单个 Map 类型参数的构造方法,用于创建一个与其参数具有相同键-值映射关系的新映射。
定义
public interface Map { }
Map所有API
abstract void clear()
abstract boolean containsKey(Object key)
abstract boolean containsValue(Object value)
abstract Set> entrySet()
abstract boolean equals(Object object)
abstract V get(Object key)
abstract int hashCode()
abstract boolean isEmpty()
abstract Set keySet()
abstract V put(K key, V value)
abstract void putAll(Map extends K, ? extends V> map)
abstract V remove(Object key)
abstract int size()
abstract Collection values()
entrySet()用于返回键-值集的Set集合
keySet()用于返回键集的Set集合
values()用户返回值集的Collection集合
Map.Entry
是Map中内部的一个接口,Map.Entry是键值对,Map通过 entrySet() 获取Map.Entry的键值对集合,从而通过该集合实现对键值对的操作。
定义
interface Entry { }
Map.Entry所有API
abstract boolean equals(Object object)
abstract K getKey()
abstract V getValue()
abstract int hashCode()
abstract V setValue(V object)
AbstractMap
定义
public abstract class AbstractMap implements Map {}
AbstractMap类提供 Map 接口的骨干实现,减少此接口的实现工作。
AbstractMap的所有API
abstract Set> entrySet()
void clear()
boolean containsKey(Object key)
boolean containsValue(Object value)
boolean equals(Object object)
V get(Object key)
int hashCode()
boolean isEmpty()
Set keySet()
V put(K key, V value)
void putAll(Map extends K, ? extends V> map)
V remove(Object key)
int size()
String toString()
Collection values()
Object clone()
SortedMap
定义
public interface SortedMap extends Map { }
SortedMap的排序方式有两种:自然排序 或者 用户指定比较器。 插入有序 SortedMap 的所有元素都必须实现 Comparable 接口(或者被指定的比较器所接受)。
另外,所有SortedMap 实现类都应该提供 4 个“标准”构造方法:
(01) void(无参数)构造方法,它创建一个空的有序映射,按照键的自然顺序进行排序。
(02) 带有一个 Comparator 类型参数的构造方法,它创建一个空的有序映射,根据指定的比较器进行排序。
(03) 带有一个 Map 类型参数的构造方法,它创建一个新的有序映射,其键-值映射关系与参数相同,按照键的自然顺序进行排序。
(04) 带有一个 SortedMap 类型参数的构造方法,它创建一个新的有序映射,其键-值映射关系和排序方法与输入的有序映射相同。无法保证强制实施此建议,因为接口不能包含构造方法。
SortedMap的所有API
// 继承于Map的API
abstract void clear()
abstract boolean containsKey(Object key)
abstract boolean containsValue(Object value)
abstract Set> entrySet()
abstract boolean equals(Object object)
abstract V get(Object key)
abstract int hashCode()
abstract boolean isEmpty()
abstract Set keySet()
abstract V put(K key, V value)
abstract void putAll(Map extends K, ? extends V> map)
abstract V remove(Object key)
abstract int size()
abstract Collection values()
// SortedMap新增的API
abstract Comparator super K> comparator()
abstract K firstKey()
abstract SortedMap headMap(K endKey)
abstract K lastKey()
abstract SortedMap subMap(K startKey, K endKey)
abstract SortedMap tailMap(K startKey)
NavigableMap
定义
public interface NavigableMap extends SortedMap { }
NavigableMap的所有API
abstract Entry ceilingEntry(K key)
abstract Entry firstEntry()
abstract Entry floorEntry(K key)
abstract Entry higherEntry(K key)
abstract Entry lastEntry()
abstract Entry lowerEntry(K key)
abstract Entry pollFirstEntry()
abstract Entry pollLastEntry()
abstract K ceilingKey(K key)
abstract K floorKey(K key)
abstract K higherKey(K key)
abstract K lowerKey(K key)
abstract NavigableSet descendingKeySet()
abstract NavigableSet navigableKeySet()
abstract NavigableMap descendingMap()
abstract NavigableMap headMap(K toKey, boolean inclusive)
abstract SortedMap headMap(K toKey)
abstract SortedMap subMap(K fromKey, K toKey)
abstract NavigableMap subMap(K fromKey, boolean fromInclusive, K toKey, boolean toInclusive)
abstract SortedMap tailMap(K fromKey)
abstract NavigableMap tailMap(K fromKey, boolean inclusive)
NavigableMap除了继承SortedMap的特性外,它的提供的功能可以分为4类:
第1类,提供操作键-值对的方法。
lowerEntry、floorEntry、ceilingEntry 和 higherEntry 方法,它们分别返回与小于、小于等于、大于等于、大于给定键的键关联的 Map.Entry 对象。
firstEntry、pollFirstEntry、lastEntry 和 pollLastEntry 方法,它们返回和/或移除最小和最大的映射关系(如果存在),否则返回 null。
第2类,提供操作键的方法。这个和第1类比较类似
lowerKey、floorKey、ceilingKey 和 higherKey 方法,它们分别返回与小于、小于等于、大于等于、大于给定键的键。
第3类,获取键集。
navigableKeySet、descendingKeySet分别获取正序/反序的键集。
第4类,获取键-值对的子集。