java.util
클래스 AbstractMap<K, V>

java.lang.Object 
  java.util.AbstractMap<K, V>

모든 구현된 인터페이스:

Map <K, V>

알려진 직계 서브 클래스:

ConcurrentHashMap, EnumMap, HashMap, IdentityHashMap, TreeMap, WeakHashMap

public abstract class AbstractMap<K, V>
extends Object 
implements Map <K, V>

이 클래스는 Map 인터페이스의 스켈레톤 구현을 제공해, 이 인터페이스를 구현하는데 필요한 작업량을 최소한으로 억제합니다.

변경 불가능한 맵을 구현하려면, 이 클래스를 확장해, 맵의 매핑의 셋트뷰를 돌려주는 entrySet 메서드를 구현할 필요가 있습니다. 보통, 리턴된 세트는 AbstractSet 위에 구현됩니다. 이 세트에서는 add 메서드와 remove 메서드를 지원 해야 하지는 않습니다. 또, 세트의 반복자에서는 remove 메서드를 지원 해야 하지는 않습니다.

변경 가능한 맵을 구현하려면, 상기에 가세해, 이 클래스의 put 메서드를 오버라이드(override) 합니다 (오버라이드(override) 하지 않았던 경우는 UnsupportedOperationException이 발생 됩니다). 또, 상기에 가세해, entrySet(). iterator()로 리턴된 반복자에게 remove 메서드를 구현할 필요가 있습니다.

Map 인터페이스의 사양으로 추천 되고 있도록, 일반적으로 인수 없음의 void 생성자 및 인수에 맵을 취하는 생성자를 제공해 주세요.

구현의 상세한 것에 대하여는 이 클래스의 abstract 메서드 이외의 각 메서드의 문서를 참조하십시오. 보다 효율적인 구현을 할 수 있는 맵의 경우는 이러한 메서드를 오버라이드(override) 해도 괜찮습니다.

이 클래스는 Java Collections Framework 멤버입니다.

도입된 버전 :

1.2

관련 항목:

Map, Collection

중첩(Nested) 클래스 개요

인터페이스 java.util. Map 로부터 상속된 중첩(Nested) 클래스/인터페이스

Map.Entry <K, V >

생성자 개요

protected

AbstractMap () 유일한 생성자 입니다.

메서드 개요

void	clear () 맵으로부터 매핑을 모두 삭제합니다 (임의의 오퍼레이션).
protected Object	clone () AbstractMap 인스턴스의 샤로코피를 리턴합니다.
boolean	containsKey (Object key) 맵이 지정된 키의 매핑을 보관 유지하는 경우에 true를 리턴합니다.
boolean	containsValue (Object value) 이 맵이 이 값에 1개 이상의 키를 매핑 하는 경우에 true를 리턴합니다.
abstract Set <Map.Entry <K, V >>	entrySet () 이 맵에 포함되고 있는 매핑의 셋트뷰를 리턴합니다.
boolean	equals (Object o) 지정된 객체와 이 맵이 동일한지 어떤지를 비교합니다.
V	get (Object key) 이 맵에 한 지정된 키의 매핑처가 되는 값을 리턴합니다.
int	hashCode () 이 맵의 해시 코드값을 리턴합니다.
boolean	isEmpty () 맵이 키와 값의 매핑을 보관 유지하지 않는 경우에 true를 리턴합니다.
Set <K >	keySet () 이 맵에 포함되고 있는 키의 Set 뷰를 리턴합니다.
V	put (K key, V value) 지정된 값과 지정된 키를 이 맵에 관련짓습니다 (임의의 오퍼레이션).
void	putAll (Map <? extends K, ? extends V > t) 지정된 맵의 모든 매핑을 이 맵에 카피합니다 (임의의 오퍼레이션).
V	remove (Object key) 이 키에 매핑이 있는 경우에 그 매핑을 맵으로부터 삭제합니다 (임의의 오퍼레이션).
int	size () 맵내의 키와 값의 매핑의 수를 리턴합니다.
String	toString () 이 맵의 캐릭터 라인 표현을 리턴합니다.
Collection <V >	values () 이 맵에 포함되고 있는 값의 코레크션뷰를 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드

finalize, getClass, notify, notifyAll, wait, wait, wait

생성자 상세

AbstractMap

protected AbstractMap()

유일한 생성자 입니다. 서브 클래스의 생성자에 한 호출용으로 일반적으로 암묵적으로 호출합니다.

메서드의 상세

size

public int size()

맵내의 키와 값의 매핑의 수를 리턴합니다. 맵에 Integer.MAX_VALUE 보다 많은 요소가 있는 경우는 Integer.MAX_VALUE를 리턴합니다.

이 구현은 entrySet(). size()를 리턴합니다.

정의:

인터페이스 Map <K, V > 내의 size

반환값:

맵내의 키와 값의 매핑의 수

isEmpty

public boolean isEmpty()

맵이 키와 값의 매핑을 보관 유지하지 않는 경우에 true를 리턴합니다.

이 구현은 size() == 0 결과를 리턴합니다.

정의:

인터페이스 Map <K, V > 내의 isEmpty

반환값:

맵이 키와 값의 매핑을 보관 유지하지 않는 경우는 true

containsValue

public boolean containsValue(Object  value)

이 맵이 이 값에 1개 이상의 키를 매핑 하는 경우에 true를 리턴합니다. 보다 엄밀하게 말하면, 이 맵에 (value==null ? v==null : value.equals(v))가 되는 것 같은 값 v에 의 매핑이 1개 이상 있는 경우에 한해서 true를 리턴합니다. 대부분의 맵의 구현에서는 이 오퍼레이션은 맵의 사이즈에 정비례 한 시간이 걸린다고 생각됩니다.

이 구현은 entrySet()의 내용을 차례차례 조사해 지정된 값을 가지는 엔트리를 검색합니다. 그러한 엔트리가 발견되었을 경우는 true를 리턴합니다. 목적의 엔트리가 발견되지 않고 반복이 종료했을 경우는 false를 리턴합니다. 이 구현에서는 맵의 사이즈에 정비례 한 시간이 필요한 일로 주의해 주세요.

정의:

인터페이스 Map <K, V > 내의 containsValue

파라미터:

value - 맵에 있을지 어떨지를 판정되는 값

반환값:

이 맵이 1개 이상의 키에 이 값을 매핑 하는 경우는 true

containsKey

public boolean containsKey(Object  key)

맵이 지정된 키의 매핑을 보관 유지하는 경우에 true를 리턴합니다.

이 구현은 entrySet() 내용을 차례차례 조사해 지정된 키를 가지는 엔트리를 검색합니다. 그러한 엔트리가 발견되었을 경우는 true를 리턴합니다. 목적의 엔트리가 발견되지 않고 반복이 종료했을 경우는 false를 리턴합니다. 이 구현에서는 맵의 사이즈에 정비례 한 시간이 필요한 일로 주의해 주세요. 많은 구현은 이 메서드를 오버라이드(override) 합니다.

정의:

인터페이스 Map <K, V > 내의 containsKey

파라미터:

key - 맵에 있을지 어떨지가 판정되는 키

반환값:

맵이 지정된 키의 매핑을 보관 유지하는 경우는 true

예외:

NullPointerException - 키가 null 때에 맵이 null 키를 허가하지 않는 경우

get

public V  get(Object  key)

이 맵에 한 지정된 키의 매핑처가 되는 값을 리턴합니다. 이 키의 매핑을 맵이 포함하지 않는 경우는 null을 리턴합니다. 반환값이 null인 경우에서도, 키의 매핑이 맵에 없다고는 할 수 없습니다. 맵이 명시적으로 키를 null에 매핑 하고 있을 가능성도 있습니다. containsKey 오퍼레이션을 사용하면, 이 2개의 경우를 구별할 수 있습니다.

이 구현은 entrySet() 내용을 차례차례 조사해 지정된 키를 가지는 엔트리를 검색합니다. 그러한 엔트리가 발견되었을 경우는 엔트리의 값을 리턴합니다. 목적의 엔트리가 발견되지 않고 반복이 종료했을 경우는 null을 리턴합니다. 이 구현에서는 맵의 사이즈에 정비례 한 시간이 필요한 일로 주의해 주세요. 많은 구현은 이 메서드를 오버라이드(override) 합니다.

정의:

인터페이스 Map <K, V > 내의 get

파라미터:

key - 관련된 값이 리턴된 키

반환값:

맵이 지정된 키를 맵 하는 값

예외:

NullPointerException - 키가 null 때에 맵이 null 키를 허가하지 않는 경우

관련 항목:

containsKey(Object)

put

public V  put(K  key,
             V  value)

지정된 값과 지정된 키를 이 맵에 관련짓습니다 (임의의 오퍼레이션). 맵에 이미 이 키에 대한 매핑이 있는 경우, 낡은 값은 옮겨놓을 수 있습니다.

이 구현은 항상 UnsupportedOperationException을 Throw 합니다.

정의:

인터페이스 Map <K, V > 내의 put

파라미터:

key - 지정되는 값을 관련된 키

value - 지정되는 키에 관련된 값

반환값:

지정된 키에 관련한 이전의 값. 키에 매핑이 없었던 경우는 null. (null 반환값은 구현이 null 치를 지원 하고 있는 경우, 지정된 키와 null을 이전 관련짓고 있던 맵을 나타내는 경우도 있다)

예외:

UnsupportedOperationException - put 오퍼레이션이 맵에 의해 지원 되어 있지 않은 경우

ClassCastException - 지정된 키 또는 값의 클래스가 원인으로 맵에 포함할 수 없는 경우

IllegalArgumentException - 이 키 또는 값 * 특성이 원인으로 맵에 포함할 수 없는 경우

NullPointerException - 맵이 null 키나 null 치를 허가하지 않을 때에 지정된 키 또는 값이 null인 경우

remove

public V  remove(Object  key)

이 키에 매핑이 있는 경우에 그 매핑을 맵으로부터 삭제합니다 (임의의 오퍼레이션).

이 구현은 entrySet() 내용을 차례차례 조사해 지정된 키를 가지는 엔트리를 검색합니다. 그러한 엔트리가 발견되었을 경우는 엔트리의 값을 구현의 getValue 오퍼레이션으로 취득해, 엔트리를 Collection와 그 기본으로 되는 맵으로부터 삭제합니다. 삭제는 반복자의 remove 오퍼레이션을 사용해, 보존된 값이 리턴됩니다 . 목적의 엔트리가 발견되지 않고 반복이 종료했을 경우는 null을 리턴합니다. 이 구현에서는 맵의 사이즈에 정비례 한 시간이 필요한 일로 주의해 주세요. 많은 구현은 이 메서드를 오버라이드(override) 합니다.

entrySet 반복자가 remove 메서드를 지원 하지 않고, 이 맵이 지정된 키의 매핑을 보관 유지하는 경우는 이 구현은 UnsupportedOperationException을 Throw 합니다.

정의:

인터페이스 Map <K, V > 내의 remove

파라미터:

key - 매핑이 맵으로부터 삭제되는 키

반환값:

지정된 키에 관련한 이전의 값. 키에 엔트리가 없었던 경우는 null. (null 반환값은 구현이 null 치를 지원 하고 있는 경우, 지정된 키와 null을 이전 관련짓고 있던 맵을 나타내는 경우도 있다)

예외:

UnsupportedOperationException - 이 맵이 remove 오퍼레이션을 지원 하지 않는 경우

putAll

public void putAll(Map <?  extends K,
?  extends V > t)

지정된 맵의 모든 매핑을 이 맵에 카피합니다 (임의의 오퍼레이션). 지정된 맵에 현재 있는 모든 키에 대해서 이 맵이 가지고 있던 모든 매핑은 카피되는 매핑에 의해 옮겨놓을 수 있습니다.

이 구현은 지정된 맵의 entrySet() 컬렉션의 내용을 차례차례 조사해 반복에 의해 각 엔트리가 돌려주고질 때 마다, 이 맵의 put 오퍼레이션을 1회 호출합니다.

이 맵이 put 오퍼레이션을 지원 하지 않고, 지정 맵이 비어있지 않은 경우, 이 구현은 UnsupportedOperationException을 Throw 합니다.

정의:

인터페이스 Map <K, V > 내의 putAll

파라미터:

t - 맵에 포함되는 매핑

예외:

UnsupportedOperationException - 이 맵이 putAll 오퍼레이션을 지원 하고 있지 않는 경우

ClassCastException - 지정된 맵내의 키 또는 값의 클래스가 원인으로 맵에 포함할 수 없는 경우

IllegalArgumentException - 지정된 맵내의 키 또는 값의 특성이 원인으로 맵에 포함할 수 없는 경우

NullPointerException - 지정된 맵이 null 인지, 이 맵이 null 키나 null 치를 허가하지 않는 상태로 지정된 맵에 null 키나 null 값이 포함되는 경우

clear

public void clear()

맵으로부터 매핑을 모두 삭제합니다 (임의의 오퍼레이션).

이 구현은, entrySet(). clear()를 호출합니다. entrySet가 clear 오퍼레이션을 지원 하지 않는 경우, 이 구현은 UnsupportedOperationException을 Throw 합니다.

정의:

인터페이스 Map <K, V > 내의 clear

예외:

UnsupportedOperationException - clear가 맵에 의해 지원 되어 있지 않은 경우

keySet

public Set <K > keySet()

이 맵에 포함되고 있는 키의 Set 뷰를 리턴합니다. Set는 이 맵을 기본으로 하고 있으므로 맵에의 변경 및 Set 에의 변경은 반영됩니다. Set 에서의 반복 처리가 진행중으로 맵이 변경되었을 경우, 반복의 결과는 정의되지 않습니다. Set는 요소의 삭제를 지원 하고 있어, 대응하는 엔트리를 맵으로부터 삭제할 수 있습니다 . 삭제는 Iterator.remove, Set.remove, removeAll, retainAll 및 clear 각 오퍼레이션을 통해 실시합니다. add 오퍼레이션과 addAll 오퍼레이션은 지원 되지 않습니다.

이 구현은 AbstractSet를 상속하는 Set를 리턴합니다. 이 서브 클래스의 iterator 메서드는 이 맵의 entrySet() 반복자의 「래퍼 객체」를 리턴합니다. size 메서드는 이 맵의 size 메서드에 위양 해, contains 메서드는 이 맵의 containsKey 메서드에 위양 합니다.

Set는 이 메서드가 최초로 불려 갔을 때에 작성되어 거기에 계속되는 모든 호출에 응해 리턴됩니다 . 동기는 일절 행해지지 않습니다. 이 때문에 적지만, 이 메서드에의 복수의 호출에 대해서 같은 Set가 돌려주고지지 않을 가능성이 있습니다.

정의:

인터페이스 Map <K, V > 내의 keySet

반환값:

맵에 포함되어 있는 키의 셋트뷰

values

public Collection <V > values()

이 맵에 포함되고 있는 값의 코레크션뷰를 리턴합니다. 컬렉션은 맵을 기본으로 하고 있으므로 맵에의 변경 및 컬렉션에의 변경은 반영됩니다. 컬렉션에서의 반복 처리가 진행중으로 맵이 변경되었을 경우, 반복의 결과는 정의되지 않습니다. 컬렉션은 요소의 삭제를 지원 하고 있어, 대응하는 엔트리를 맵으로부터 삭제할 수 있습니다 . 삭제는 Iterator.remove, Collection.remove, removeAll, retainAll 및 clear 각 오퍼레이션을 통해 실시합니다. add 오퍼레이션과 addAll 오퍼레이션은 지원 되지 않습니다.

이 구현은 추상 컬렉션을 상속하는 컬렉션을 리턴합니다. 이 서브 클래스의 iterator 메서드는 이 맵의 entrySet() 반복자의 「래퍼 객체」를 리턴합니다. size 메서드는 이 맵의 size 메서드에 위양 해, contains 메서드는 이 맵의 containsValue 메서드에 위양 합니다.

컬렉션은 이 메서드가 최초로 불려 갔을 때에 작성되어 거기에 계속되는 모든 호출에 응해 리턴됩니다 . 동기는 일절 행해지지 않습니다. 이 때문에 적지만, 이 메서드에의 복수의 호출에 대해서 같은 Collection가 돌려주고지지 않을 가능성이 있습니다.

정의:

인터페이스 Map <K, V > 내의 values

반환값:

맵내에 포함되어 있는 값의 코레크션뷰

entrySet

public abstract Set <Map.Entry <K,
V >> entrySet()

이 맵에 포함되고 있는 매핑의 셋트뷰를 리턴합니다. 이 세트의 각 요소는 Map.Entry 입니다. 세트는 이 맵을 기본으로 하고 있으므로 맵에의 변경 및 세트에의 변경은 서로 반영됩니다. 세트에서의 반복 처리가 진행중으로 맵이 변경되었을 경우, 반복의 결과는 보증되지 않습니다. 세트는 요소의 삭제를 지원 하고 있어, 대응하는 엔트리를 맵으로부터 삭제할 수 있습니다 . 삭제에는 Iterator.remove, Set.remove, removeAll, retainAll 및 clear 오퍼레이션을 사용할 수 있습니다. add 또는 addAll 오퍼레이션은 지원 되지 않습니다.

정의:

인터페이스 Map <K, V > 내의 entrySet

반환값:

맵내에 보관 유지되고 있는 매핑의 셋트뷰

equals

public boolean equals(Object  o)

지정된 객체와 이 맵이 동일한지 어떤지를 비교합니다. 지정된 객체가 맵이며, 2개의 맵이 같은 매핑을 나타내는 경우에 true를 리턴합니다. 보다 엄밀하게 말하면, t1.keySet(). equals(t2.keySet()) 이며, t1.keySet()에 있는 모든 키 k에 대해 (t1.get(k) ==null ? t2.get(k) ==null : t1.get(k). equals(t2.get(k))) 일 때, 2개의 맵 t1 및 t2는 같은 매핑을 나타냅니다. 이것에 의해 equals 메서드는 맵 인터페이스가 다른 구현간에 올바르게 동작하는 것이 보증됩니다.

이 구현은 지정된 객체가 이 맵 자신일지 어떨지를 최초로 조사합니다. 이 맵인 경우, 구현은 true를 돌려주고, 지정된 객체에 대해, 이 세트와 같은 사이즈의 맵일지 어떨지를 조사합니다. 지정된 객체가 이 맵이 아닌 경우는 false를 돌려주고, 이 맵의 entrySet 컬렉션의 내용을 차례차례 조사해, 지정된 맵에 이 맵이 포함하고 있는 각 매핑이 포함되어 있는지를 조사합니다. 지정된 맵에 그러한 매핑이 없는 경우는 false가 리턴됩니다 . 반복이 완료했을 경우에 true가 리턴됩니다 .

정의:

인터페이스 Map <K, V > 내의 equals

오버라이드(override):

클래스 Object 내의 equals

파라미터:

o - 맵과 동일한지 어떤지를 비교하는 객체

반환값:

지정된 객체가 맵과 동일한 경우는 true

관련 항목:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

이 맵의 해시 코드값을 리턴합니다. 맵의 해시 코드는 맵의 entrySet() 뷰에 있는 각 엔트리의 해시 코드의 합계입니다. 이것에 의해 Object.hashCode 일반적인 규약으로 요구되는 대로 임의의 2개의 맵 t1와 t2에 대해, t1.equals(t2)인 경우 t1.hashCode() ==t2.hashCode()가 됩니다.

이 구현은 Collection 각 요소 (엔트리)의 hashCode를 호출해, entrySet() 내용을 차례차례 조사해 결과를 가산해 갈 것입니다.

정의:

인터페이스 Map <K, V > 내의 hashCode

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

맵의 해시 코드값

관련 항목:

Map.Entry.hashCode(), Object.hashCode(), Object.equals(Object), Set.equals(Object)

toString

public String  toString()

이 맵의 캐릭터 라인 표현을 리턴합니다. 캐릭터 라인 표현은 키와 값의 매핑을 맵의 entrySet 뷰의 반복자가 돌려준 순서에 안괄호 ("{}")로 둘러싸 가리키는 리스트입니다. 인접하는 매핑은 문자 ", " (콤마와 공백 문자)에 의해 단락지어집니다. 각 키와 값의 매핑은 키의 뒤에 등호 ("=")가 계속되어, 그 다음에 키와 관련된 값이 계속된다고 하는 형태로 표현됩니다. 키와 값은, String.valueOf(Object)와 같게의해 캐릭터 라인에 변환됩니다.

이 구현은 비어있는 캐릭터 라인 버퍼를 작성해, 왼쪽안괄호를 부가하고 나서, 맵의 entrySet 뷰를 반복해 조사해, 각 map.entry 캐릭터 라인 표현을 순서에 부가해 갈 것입니다. 각 요소의 뒤에는 캐릭터 라인 ", " 이 부가됩니다. 다만, 마지막 요소의 뒤에는 ", "는 아니고 오른쪽안괄호가 부가됩니다. 마지막에 캐릭터 라인 버퍼로부터 캐릭터 라인을 취득해 리턴합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 맵의 캐릭터 라인 표현

clone

protected Object  clone()
                throws CloneNotSupportedException 

AbstractMap 인스턴스의 샤로코피를 리턴합니다. 키와 값은 그 자체는 복제되지 않습니다.

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 맵의 샤로코피

예외:

CloneNotSupportedException - 객체의 클래스가 Cloneable인터페이스를 지원 하고 있지 않는 경우. clone 메서드를 오버라이드(override) 한 서브 클래스도, 인스턴스를 복제할 수 없는 것을 나타내기 위해서 이 예외를 Throw 하는 일이 있는

관련 항목:

Cloneable