java.util
인터페이스 Map.Entry

포함되어 있는 인터페이스:

Map

public static interface Map.Entry

MAP의 엔트리 (키와 값의 페어)입니다. Map.entrySet 메소드는 이 클래스에 속하는 요소를 가지는 MAP의 코레크션뷰를 돌려줍니다. MAP 엔트리에의 참조를 취득하는 유일한 방법은 이 코레크션뷰의 반복자로부터 취득하는 방법입니다. 이러한 Map.Entry 오브젝트는 반복 처리중에만 유효합니다. 즉, 반복자 자신의 remove 오퍼레이션인가, 반복자에 의해 돌려주어지는 MAP 엔트리의 setValue 오퍼레이션 이외 방법으로 엔트리가 반복자에 의해 돌려주어진 뒤에, 기본으로 되어 있는 MAP가 변경되었을 경우에는 MAP 엔트리의 동작은 프로텍션되지 않습니다.

도입된 버젼:

1.2

관련 항목:

Map.entrySet()

메소드의 개요

boolean	equals (Object o) 지정된 오브젝트가 엔트리와 동일한지 어떤지를 비교합니다.
Object	getKey () 엔트리에 대응하는 키를 돌려줍니다.
Object	getValue () 엔트리에 대응하는 값을 돌려줍니다.
int	hashCode () MAP 엔트리의 해시 코드치를 돌려줍니다.
Object	setValue (Object value) 엔트리에 대응하는 값을, 지정된 값에 옮겨놓습니다 (임의의 오퍼레이션).

메소드의 상세

getKey

public Object  getKey()

엔트리에 대응하는 키를 돌려줍니다.

반환값:

엔트리에 대응하는 키

getValue

public Object  getValue()

엔트리에 대응하는 값을 돌려줍니다. 매핑이 (반복자의 remove 오퍼레이션에 의해) 기본으로 되어 있는 MAP로부터 삭제되고 있는 경우는 이 호출의 결과는 프로텍션되지 않습니다.

반환값:

엔트리에 대응하는 값

setValue

public Object  setValue(Object  value)

엔트리에 대응하는 값을, 지정된 값에 옮겨놓습니다 (임의의 오퍼레이션). MAP에 기입합니다. 매핑이 (반복자의 remove 오퍼레이션에 의해) 벌써 MAP로부터 삭제되고 있는 경우는 이 호출의 결과는 프로텍션되지 않습니다.

파라미터:

value - 엔트리에 저장되고 있는 새로운 값

반환값:

엔트리에 대응하기 이전의 값

예외:

UnsupportedOperationException - 기본으로 되어 있는 MAP가 put 오퍼레이션을 서포트하지 않는 경우

ClassCastException - 지정된 값의 클래스가 원인으로, 기본으로 되어 있는 MAP에 값을 저장할 수 없는 경우

IllegalArgumentException - 이 값의 일부의 특성이 원인으로, 기본으로 되어 있는 MAP에 값을 저장할 수 없는 경우

NullPointerException - 기본으로 되어 있는 MAP가 null 치를 허가하지 않을 때에, 지정된 값이 null 의 경우

equals

public boolean equals(Object  o)

지정된 오브젝트가 엔트리와 동일한지 어떤지를 비교합니다. 지정된 오브젝트도 MAP 엔트리이며, 2 개의 엔트리가 같은 매핑을 나타내는 경우는 true 를 돌려줍니다. 즉, 2 개의 엔트리 e1 와 e2 는 이하와 같이 되는 경우에 같은 매핑을 나타냅니다.

     (e1.getKey() ==null ?
      e2.getKey() ==null : e1.getKey(). equals(e2.getKey()))  &&
     (e1.getValue() ==null ?
      e2.getValue() ==null : e1.getValue(). equals(e2.getValue()))
 

이것에 의해,Map.Entry 인터페이스의 구현이 다른 경우에서도, equals 메소드가 정상적으로 동작하는 것이 프로텍션됩니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

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

반환값:

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

hashCode

public int hashCode()

MAP 엔트리의 해시 코드치를 돌려줍니다. MAP 엔트리 e 의 해시 코드는 다음과 같이 정의됩니다.

     (e.getKey() ==null   ?  0 : e.getKey(). hashCode()) ^
     (e.getValue() ==null ?  0 : e.getValue(). hashCode())
 

이것에 의해,Object.hashCode 의 일반 규약에 의해 요구되는 임의의 2 개의 엔트리 e1 와 e2 로,e1.equals(e2) 이면 e1.hashCode() ==e2.hashCode() 가 되는 것이 프로텍션됩니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

MAP 엔트리의 해시 코드치

관련 항목:

Object.hashCode() , Object.equals(Object) , equals(Object)