嵌套类摘要 | |
---|---|
static interface | Map.Entry<K,V> 映射项(键-值对)。 |
方法摘要 | |
---|---|
void | clear() 从此映射中移除所有映射关系(可选操作)。 |
boolean | containsKey(Object key) 如果此映射包含指定键的映射关系,则返回 true。 |
boolean | containsValue(Object value) 如果此映射将一个或多个键映射到指定值,则返回 true。 |
Set<Map.Entry<K,V>> | entrySet() 返回此映射中包含的映射关系的 Set 视图。 |
boolean | equals(Object o) 比较指定的对象与此映射是否相等。 |
V | get(Object key) 返回指定键所映射的值;如果此映射不包含该键的映射关系,则返回 null 。 |
int | hashCode() 返回此映射的哈希码值。 |
boolean | isEmpty() 如果此映射未包含键-值映射关系,则返回 true。 |
Set<K> | keySet() 返回此映射中包含的键的 Set 视图。 |
V | put(K key, V value) 将指定的值与此映射中的指定键关联(可选操作)。 |
void | putAll(Map<? extends K,? extends V> m) 从指定映射中将所有映射关系复制到此映射中(可选操作)。 |
V | remove(Object key) 如果存在一个键的映射关系,则将其从此映射中移除(可选操作)。 |
int | size() 返回此映射中的键-值映射关系数。 |
Collection<V> | values() 返回此映射中包含的值的 Collection 视图。 |
方法详细信息 |
---|
size
int size()
- 返回此映射中的键-值映射关系数。如果该映射包含的元素大于 Integer.MAX_VALUE,则返回 Integer.MAX_VALUE。
-
-
返回:
- 此映射中的键-值映射关系数
isEmpty
boolean isEmpty()
- 如果此映射未包含键-值映射关系,则返回 true。
-
-
返回:
- 如果此映射未包含键-值映射关系,则返回 true
containsKey
boolean containsKey(Object key)
- 如果此映射包含指定键的映射关系,则返回 true。更确切地讲,当且仅当此映射包含针对满足 (key==null ? k==null : key.equals(k)) 的键 k 的映射关系时,返回 true。(最多只能有一个这样的映射关系)。
-
-
参数:
-
key
- 测试是否存在于此映射中的键
返回:
- 如果此映射包含指定键的映射关系,则返回 true 抛出:
-
ClassCastException
- 如果该键对于此映射是不合适的类型(可选) -
NullPointerException
- 如果指定键为 null 并且此映射不允许 null 键(可选)
-
containsValue
boolean containsValue(Object value)
- 如果此映射将一个或多个键映射到指定值,则返回 true。更确切地讲,当且仅当此映射至少包含一个对满足 (value==null ? v==null : value.equals(v)) 的值 v 的映射关系时,返回 true。对于大多数 Map 接口的实现而言,此操作需要的时间可能与映射大小呈线性关系。
-
-
参数:
-
value
- 测试是否存在于此映射中的值
返回:
- 如果此映射将一个或多个键映射到指定值,则返回 true 抛出:
-
ClassCastException
- 如果该值对于此映射是不合适的类型(可选) -
NullPointerException
- 如果指定值为 null 并且此映射不允许 null 值(可选)
-
get
V get(Object key)
-
返回指定键所映射的值;如果此映射不包含该键的映射关系,则返回
null
。更确切地讲,如果此映射包含满足
(key==null ? k==null : key.equals(k))
的键k
到值v
的映射关系,则此方法返回v
;否则返回null
。(最多只能有一个这样的映射关系)。如果此映射允许 null 值,则返回
null
值并不一定 表示该映射不包含该键的映射关系;也可能该映射将该键显示地映射到null
。使用containsKey
操作可区分这两种情况。 -
-
参数:
-
key
- 要返回其关联值的键
返回:
-
指定键所映射的值;如果此映射不包含该键的映射关系,则返回
null
抛出:
-
ClassCastException
- 如果该键对于此映射是不合适的类型(可选) -
NullPointerException
- 如果指定键为 null 并且此映射不允许 null 键(可选)
-
put
V put(K key, V value)
-
将指定的值与此映射中的指定键关联(可选操作)。如果此映射以前包含一个该键的映射关系,则用指定值替换旧值(当且仅当
m.containsKey(k)
返回 true 时,才能说映射 m 包含键 k 的映射关系)。 -
-
参数:
-
key
- 与指定值关联的键 -
value
- 与指定键关联的值
返回:
- 以前与 key 关联的值,如果没有针对 key 的映射关系,则返回 null。(如果该实现支持 null 值,则返回 null 也可能表示此映射以前将 null 与 key 关联)。 抛出:
-
UnsupportedOperationException
- 如果此映射不支持 put 操作 -
ClassCastException
- 如果指定键或值的类不允许将其存储在此映射中 -
NullPointerException
- 如果指定键或值为 null,并且此映射不允许 null 键或值 -
IllegalArgumentException
- 如果指定键或值的某些属性不允许将其存储在此映射中
-
remove
V remove(Object key)
-
如果存在一个键的映射关系,则将其从此映射中移除(可选操作)。更确切地讲,如果此映射包含从满足
(key==null ? k==null :key.equals(k))
的键 k 到值 v 的映射关系,则移除该映射关系。(该映射最多只能包含一个这样的映射关系。)返回此映射中以前关联该键的值,如果此映射不包含该键的映射关系,则返回 null。
如果此映射允许 null 值,则返回 null 值并不一定 表示该映射不包含该键的映射关系;也可能该映射将该键显示地映射到 null。
调用返回后,此映射将不再包含指定键的映射关系。
-
-
参数:
-
key
- 从映射中移除其映射关系的键
返回:
- 以前与 key 关联的值;如果没有 key 的映射关系,则返回 null。 抛出:
-
UnsupportedOperationException
- 如果此映射不支持 remove 操作 -
ClassCastException
- 如果该键对于此映射是不合适的类型(可选) -
NullPointerException
- 如果指定键为 null 并且此映射不允许 null 键(可选)
-
putAll
void putAll(Map<? extends K,? extends V> m)
-
从指定映射中将所有映射关系复制到此映射中(可选操作)。对于指定映射中的每个键
k 到值
v 的映射关系,此调用等效于对此映射调用一次
put(k, v)
。如果正在进行此操作的同时修改了指定的映射,则此操作的行为是不确定的。 -
-
参数:
-
m
- 要存储在此映射中的映射关系
抛出:
-
UnsupportedOperationException
- 如果此映射不支持 putAll 操作 -
ClassCastException
- 如果指定映射中的键或值的类不允许将其存储在此映射中 -
NullPointerException
- 如果指定映射为 null,或者此映射不允许 null 键或值,并且指定的映射包含 null 键或值 -
IllegalArgumentException
- 如果指定映射中的键或值的某些属性不允许将其存储在此映射中
-
clear
void clear()
- 从此映射中移除所有映射关系(可选操作)。此调用返回后,该映射将为空。
-
-
抛出:
-
UnsupportedOperationException
- 如果此映射不支持 clear 操作
-
keySet
Set<K> keySet()
-
返回此映射中包含的键的
Set
视图。该 set 受映射支持,所以对映射的更改可在此 set 中反映出来,反之亦然。如果对该 set 进行迭代的同时修改了映射(通过迭代器自己的 remove 操作除外),则迭代结果是不确定的。set 支持元素移除,通过 Iterator.remove、 Set.remove、 removeAll、 retainAll 和 clear 操作可从映射中移除相应的映射关系。它不支持 add 或 addAll 操作。 -
-
返回:
- 此映射中包含的键的 set 视图
values
Collection<V> values()
-
返回此映射中包含的值的
Collection
视图。该 collection 受映射支持,所以对映射的更改可在此 collection 中反映出来,反之亦然。如果对该 collection 进行迭代的同时修改了映射(通过迭代器自己的 remove 操作除外),则迭代结果是不确定的。collection 支持元素移除,通过 Iterator.remove、 Collection.remove、 removeAll、 retainAll 和 clear 操作可从映射中移除相应的映射关系。它不支持 add 或 addAll 操作。 -
-
返回:
- 此映射中包含的值的 collection 视图
entrySet
Set<Map.Entry<K,V>> entrySet()
-
返回此映射中包含的映射关系的
Set
视图。该 set 受映射支持,所以对映射的更改可在此 set 中反映出来,反之亦然。如果对该 set 进行迭代的同时修改了映射(通过迭代器自己的 remove 操作,或者通过对迭代器返回的映射项执行 setValue 操作除外),则迭代结果是不确定的。set 支持元素移除,通过 Iterator.remove、 Set.remove、 removeAll、 retainAll 和 clear 操作可从映射中移除相应的映射关系。它不支持 add 或 addAll 操作。 -
-
返回:
- 此映射中包含的映射关系的 set 视图
equals
boolean equals(Object o)
- 比较指定的对象与此映射是否相等。如果给定的对象也是一个映射,并且这两个映射表示相同的映射关系,则返回 true。更确切地讲,如果 m1.entrySet().equals(m2.entrySet()),则两个映射 m1 和 m2 表示相同的映射关系。这可以确保 equals 方法在不同的 Map 接口实现间运行正常。
-
-
参数:
-
o
- 要与此映射进行相等性比较的对象
返回:
- 如果指定的对象等于此映射,则返回 true 另请参见:
-
Object.hashCode()
,Hashtable
-
hashCode
int hashCode()
-
返回此映射的哈希码值。映射的哈希码定义为此映射
entrySet() 视图中每个项的哈希码之和。这确保
m1.equals(m2) 对于任意两个映射
m1 和
m2 而言,都意味着
m1.hashCode()==m2.hashCode(),正如
Object.hashCode()
常规协定的要求。 -
-
返回:
此映射的哈希码值
具体实例:
/* 每个学生都有对应的归属地; 学生是student,归属地是String 学生的属性:姓名和年龄 保证学生的唯一性 1.描述学生 2.定义map容器,将学生作为键,地址作为值存入 3.获取map集合元素 */ import java.util.*; class maptest { public static void main(String[] args) { Map<student,String> map = new HashMap<student,String>();//定义map容器,将学生作为键,地址作为值存入 map.put(new student("a1",24),"xian"); map.put(new student("a2",26),"beijing"); map.put(new student("a1",24),"beijing"); map.put(new student("a1",24),"xian"); //第一种取出方法 Set<student> keyset = map.keySet(); for(Iterator<student> it = keyset.iterator();it.hasNext();) { student student = it.next(); String address = map.get(student); sop(student+","+address); } //第二种取出方式 Set<Map.Entry<student,String>> entryset = map.entrySet(); for(Iterator<Map.Entry<student,String>> iter = entryset.iterator();iter.hasNext();) { Map.Entry<student,String> stu = iter.next(); student student1 = stu.getKey(); String address = stu.getValue(); sop(student1+","+address); } } public static void sop(Object obj) { System.out.println(obj); } } class student implements Comparable<student>//描述学生,可能存入二叉树,接入Comparable接口判断顺序 { private String name; private int age; student(String name,int age) { this.name = name; this.age = age; } public int compareTo(student s)//按姓名排序判断 { int num = new Integer(this.age).compareTo(new Integer(s.age)); if(num==0) return this.name.compareTo(s.name); return num; } public int hashCode()//有可能存到HashSet集合里,需要复写hasCode方法 { return name.hashCode()+age*3; } public boolean equal(Object obj) { if(!(obj instanceof student)) throw new ClassCastException("不是学生");//不是学生,抛出异常 student s = (student)obj; return this.name.equals(s.name)&&this.age==s.age; } public String getName() { return name; } public int getAge() { return age; } public String toString() { return name+","+age; } }