javax.management.openmbean
인터페이스 CompositeData

기존의 구현 클래스의 일람:

CompositeDataSupport

public interface CompositeData

CompositeData 인터페이스는, 「복합 데이터」구조를 표현하는 특정의 형태의 복합 「공개 데이터」객체의 동작을 지정합니다.

도입된 버젼:

1.5

메소드의 개요

boolean	containsKey (String key) 이 CompositeData 인스턴스에 key 라는 이름의 항목이 포함되는 경우에 한정해,true 를 돌려줍니다.
boolean	containsValue (Object value) 이 CompositeData 인스턴스에 value 라고 하는 값의 항목이 포함되는 경우에 한정해,true 를 돌려줍니다.
boolean	equals (Object obj) 지정된 obj 파라미터와 이 CompositeData 인스턴스가 동일한지 어떤지를 비교합니다.
Object	get (String key) key 라는 이름의 항목의 값을 돌려줍니다.
Object []	getAll (String [] keys) keys 에 의해,keys 와 같은 차례로 이름이 지정된 항목의 값으로부터 완성되는 배열을 돌려줍니다.
CompositeType	getCompositeType () 이 「복합 데이터」인스턴스의 「복합형」을 돌려줍니다.
int	hashCode () 이 CompositeData 인스턴스의 해시 코드값를 돌려줍니다.
String	toString () 이 CompositeData 인스턴스의 캐릭터 라인 표현을 돌려줍니다.
Collection <? >	values () 이 CompositeData 인스턴스에 포함되는 항목치의 변경 불능인 Collection 뷰를 돌려줍니다.

메소드의 상세

getCompositeType

CompositeType  getCompositeType()

이 「복합 데이터」인스턴스의 「복합형」을 돌려줍니다.

반환값:

이 CompositeData 의 형태

get

Object  get(String  key)

key 라는 이름의 항목의 값을 돌려줍니다.

파라미터:

key - 항목의 이름

반환값:

이 키에 관련한 값

예외:

IllegalArgumentException - key 가 null 또는 빈 상태(empty)의 String 의 경우

InvalidKeyException - key 가 이 CompositeData 인스턴스의 기존의 항목명이 아닌 경우

getAll

Object [] getAll(String [] keys)

keys 에 의해,keys 와 같은 차례로 이름이 지정된 항목의 값으로부터 완성되는 배열을 돌려줍니다.

파라미터:

keys - 항목의 이름

반환값:

키에 대응하는 값

예외:

IllegalArgumentException - keys 내의 요소가 null 또는 빈 상태(empty)의 String 의 경우

InvalidKeyException - keys 내의 요소가 이 CompositeData 인스턴스의 기존의 항목명이 아닌 경우

containsKey

boolean containsKey(String  key)

이 CompositeData 인스턴스에 key 라는 이름의 항목이 포함되는 경우에 한정해,true 를 돌려줍니다. key 가 null 또는 빈 상태(empty)의 String 의 경우, 이 메소드는 false 를 돌려줍니다.

파라미터:

key - 판정되는 키

반환값:

이 CompositeData 에 키가 포함되는 경우는 true

containsValue

boolean containsValue(Object  value)

이 CompositeData 인스턴스에 value 라고 하는 값의 항목이 포함되는 경우에 한정해,true 를 돌려줍니다.

파라미터:

value - 판정되는 값

반환값:

이 CompositeData 에 값이 포함되는 경우는 true

values

Collection <? > values()

이 CompositeData 인스턴스에 포함되는 항목치의 변경 불능인 Collection 뷰를 돌려줍니다. 반환된 컬렉션의 반복자는, 대응하는 항목명의 값을 알파벳의 승순으로 돌려줍니다.

반환값:

치

equals

boolean equals(Object  obj)

지정된 obj 파라미터와 이 CompositeData 인스턴스가 동일한지 어떤지를 비교합니다.

다음의 모든 조건이 채워지고 있는 경우에 한정해,true 를 돌려줍니다.

• obj 가 null 가 아니다.
• obj 가 CompositeData 인터페이스를 구현하고 있다.
• 복합형이 동일하다.
• 내용, 즉 이름과 값의 페어가 동일하다. 내용에 포함되는 값이 배열인 경우, 객체 참조형의 배열에 대해서 deepEquals 메소드를 호출하는지, 또는 원시형의 배열에 대해서 Arrays.equals(e1, e2) 의 적절한 overload를 호출하는 것과 같게, 값의 비교가 실행됩니다.

이러한 조건이 채워지고 있는 경우, 이 equals 메소드는,CompositeData 인터페이스가 다른 구현인 obj 파라미터에 대해서 정상적으로 동작합니다. 다만,java.util.Collection 인터페이스의 equals 메소드의 제약이 부과됩니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

obj - 이 CompositeData 인스턴스와 동일한지 어떤지를 비교하는 객체

반환값:

지정된 객체가 이 CompositeData 인스턴스와 동일한 경우는 true

관련 항목:

Object.hashCode() , Hashtable

hashCode

int hashCode()

이 CompositeData 인스턴스의 해시 코드값를 돌려줍니다.

CompositeData 인스턴스의 해시 코드는,equals 의 비교로 사용되는 모든 정보 요소 (복합형 및 모든 항목치)의 해시 코드의 합계입니다.

이것에 의해,Object.hashCode() 메소드의 일반 규약에 의해 요구되는, 임의의 2 개의 CompositeData 인스턴스 t1 와 t2 로,t1.equals(t2) 이면 t1.hashCode() ==t2.hashCode() 가 되는 것이 보증됩니다.

각 항목치의 해시 코드는, 반환된 해시 코드에 추가됩니다. 항목치가 배열인 경우, 객체 참조형의 배열에 대해서 deepHashCode 메소드를 호출하는지, 또는 원시형의 배열에 대해서 Arrays.hashCode(e) 의 적절한 overload를 호출하는 것과 같게, 값의 비교가 실행됩니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 CompositeData 인스턴스의 해시 코드값

관련 항목:

Object.equals(java.lang.Object) , Hashtable

toString

String  toString()

이 CompositeData 인스턴스의 캐릭터 라인 표현을 돌려줍니다.

이 캐릭터 라인 표현은, 구현 클래스의 이름, 이 인터페이스의 복합형의 캐릭터 라인 표현, 및 내용 (itemName=itemValue 의 매핑의 리스트)의 캐릭터 라인 표현으로 구성됩니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 CompositeData 인스턴스의 캐릭터 라인 표현