java.util
클래스 AbstractMap

java.lang.Object 
  |
  +--java.util.AbstractMap

모든 구현 인터페이스:

Map

직계의 기존의 서브 클래스:

HashMap , IdentityHashMap , TreeMap , WeakHashMap

public abstract class AbstractMap

extends Object

implements Map

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

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

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

Map 인터페이스의 사양으로 추천 되고 있게, 통상은 인수 없음의 void constructor , 및 인수에 MAP를 취하는 constructor를 제공해 주세요.

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

도입된 버젼:

1.2

관련 항목:

Map , Collection

중첩된 클래스의 개요

클래스 java.util. Map 을 상속받은 중첩된 클래스

Map.Entry

생성자의 개요

protected

AbstractMap () 유일한 constructor 입니다.

메소드의 개요

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

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

AbstractMap

protected AbstractMap()

유일한 constructor 입니다. 서브 클래스의 constructor 에 의한 호출은 통상은 암묵적인 호출입니다.

메소드의 상세

size

public int size()

MAP내의 키와 값의 매핑의 수를 돌려줍니다. MAP에 Integer.MAX_VALUE 보다 많은 요소가 있는 경우는 Integer.MAX_VALUE 를 돌려줍니다.

이 구현은 entrySet(). size() 를 돌려줍니다.

정의:

인터페이스 Map 내의 size

반환값:

MAP내의 키치 매핑의 수

isEmpty

public boolean isEmpty()

MAP가 키와 값의 매핑을 보관 유지하지 않는 경우에 true 를 돌려줍니다.

이 구현은 size() == 0 의 결과를 돌려줍니다.

정의:

인터페이스 Map 내의 isEmpty

반환값:

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

containsValue

public boolean containsValue(Object  value)

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

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

정의:

인터페이스 Map 내의 containsValue

파라미터:

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

반환값:

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

containsKey

public boolean containsKey(Object  key)

MAP가 지정의 키의 매핑을 보관 유지하는 경우에 true 를 돌려줍니다.

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

정의:

인터페이스 Map 내의 containsKey

파라미터:

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

반환값:

MAP가 지정의 키의 매핑을 보관 유지하는 경우는 true

예외:

NullPointerException - 키가 null 때에, MAP가 null 키를 허가하지 않는 경우

get

public Object  get(Object  key)

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

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

정의:

인터페이스 Map 내의 get

파라미터:

key - 관련지을 수 있었던 값이 돌려주어지는 키

반환값:

MAP가 지정된 키를 MAP 하는 값

예외:

NullPointerException - 키가 null 때에, MAP가 null 키를 허가하지 않는 경우

관련 항목:

containsKey(Object)

put

public Object  put(Object  key,
                  Object  value)

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

이 구현은 항상 UnsupportedOperationException 를 슬로우 합니다.

정의:

인터페이스 Map 내의 put

파라미터:

key - 지정되는 값을 관련지을 수 있는 키

value - 지정되는 키에 관련지을 수 있는 값

반환값:

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

예외:

UnsupportedOperationException - put 오퍼레이션이 MAP에 의해 서포트되어 있지 않은 경우

ClassCastException - 지정된 키 또는 값의 클래스가 원인으로, MAP에 저장할 수 없는 경우

IllegalArgumentException - 이 키 또는 값 * 의 특성이 원인으로, MAP에 저장할 수 없는 경우

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

remove

public Object  remove(Object  key)

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

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

entrySet 반복자가 remove 메소드를 서포트하지 않고 이 MAP가 지정된 키의 매핑을 보관 유지하는 경우는 이 구현은 UnsupportedOperationException 를 슬로우 합니다.

정의:

인터페이스 Map 내의 remove

파라미터:

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

반환값:

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

예외:

UnsupportedOperationException - 이 MAP가 remove 오퍼레이션을 서포트하지 않는 경우

putAll

public void putAll(Map  t)

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

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

이 MAP가 put 오퍼레이션을 서포트하지 않고 지정 MAP가 하늘이 아닌 경우, 이 구현은 UnsupportedOperationException 를 슬로우 합니다.

정의:

인터페이스 Map 내의 putAll

파라미터:

t - MAP에 저장되는 매핑

예외:

UnsupportedOperationException - 이 MAP가 putAll 오퍼레이션을 서포트하고 있지 않는 경우

ClassCastException - 지정된 MAP내의 키 또는 값의 클래스가 원인으로, MAP에 저장할 수 없는 경우

IllegalArgumentException - 지정된 MAP내의 키 또는 값의 특성이 원인으로, MAP에 저장할 수 없는 경우

NullPointerException - 지정된 MAP가 null 인지 또는 이 MAP가 null 키나 null 치를 허가하지 않고 지정된 MAP에 null 키나 값이 있는 경우

clear

public void clear()

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

이 구현은 entrySet(). clear() 를 호출합니다. 이 구현은 entrySet 가clear 오퍼레이션을 서포트하지 않는 경우에,UnsupportedOperationException 를 슬로우 합니다.

정의:

인터페이스 Map 내의 clear

예외:

UnsupportedOperationException - clear 가 MAP에 의해 서포트되어 있지 않은 경우

keySet

public Set  keySet()

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

이 구현은 AbstractSet 를 서브 클래스화하는 Set 를 돌려줍니다. 이 서브 클래스의 iterator 메소드는 이 MAP의 entrySet() 반복자의 「래퍼 오브젝트」를 돌려줍니다. size 메소드는 이 MAP의 size 메소드에 delegate 해, contains 메소드는 이 MAP의 containsKey 메소드에 delegate 합니다.

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

정의:

인터페이스 Map 내의 keySet

반환값:

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

values

public Collection  values()

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

이 구현은 추상 콜렉션을 서브 클래스화하는 콜렉션을 돌려줍니다. 이 서브 클래스의 iterator 메소드는 이 MAP의 entrySet() 반복자의 「래퍼 오브젝트」를 돌려줍니다. size 메소드는 이 MAP의 size 메소드에 delegate 해, contains 메소드는 이 MAP의 containsValue 메소드에 delegate 합니다.

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

정의:

인터페이스 Map 내의 values

반환값:

MAP내에 보관 유지되고 있는 값의 코레크션뷰

entrySet

public abstract Set  entrySet()

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

정의:

인터페이스 Map 내의 entrySet

반환값:

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

equals

public boolean equals(Object  o)

지정된 오브젝트와 이 MAP가 동일한지 어떤지를 비교합니다. 지정된 오브젝트가 MAP이며, 2 개의 MAP가 같은 매핑을 나타내는 경우에 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 개의 MAP t1 및 t2 는 같은 매핑을 나타냅니다. 이것에 의해,equals 메소드는 MAP 인터페이스가 다른 구현간에 올바르게 동작하는 것이 프로텍션됩니다.

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

정의:

인터페이스 Map 내의 equals

오버라이드(override):

클래스 Object 내의 equals

파라미터:

o - MAP와 동일한지 어떤지를 비교하는 오브젝트

반환값:

지정된 오브젝트가 MAP와 동일한 경우는 true

hashCode

public int hashCode()

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

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

정의:

인터페이스 Map 내의 hashCode

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

MAP의 해시 코드치

관련 항목:

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

toString

public String  toString()

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

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

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 MAP의 캐릭터 라인 표현

clone

protected Object  clone()
                throws CloneNotSupportedException 

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

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 MAP의 샤로코피

예외:

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

관련 항목:

Cloneable