javax.management.openmbean
클래스 CompositeDataSupport

java.lang.Object 
  javax.management.openmbean.CompositeDataSupport

모든 구현된 인터페이스:

Serializable, CompositeData

public class CompositeDataSupport
extends Object 
implements CompositeData,
 Serializable 

CompositeDataSupport 클래스는 CompositeData 인터페이스를 구현하는 「공개 데이터」클래스입니다.

도입된 버전 :

1.5

관련 항목:

직렬화 된 형식

생성자 개요

CompositeDataSupport (CompositeType compositeType, Map items)
지정된 compositeType로 CompositeDataSupport 인스턴스를 구축합니다.

CompositeDataSupport (CompositeType compositeType, String [] itemNames, Object [] itemValues)
지정된 compositeType로 CompositeDataSupport 인스턴스를 구축합니다.

메서드 개요

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

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

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

생성자 상세

CompositeDataSupport

public CompositeDataSupport(CompositeType  compositeType,
                            String [] itemNames,
                            Object [] itemValues)
                     throws OpenDataException 

지정된 compositeType로 CompositeDataSupport 인스턴스를 구축합니다. compositeType 항목의 값은, itemValues[]에 의해 itemNames[]와 같은 차례로 지정됩니다. CompositeType는 그 항목의 차례를 지정하지 않기 때문에 itemValues[]에 값을 건네주는 차례의 지정에는 itemNames[] 파라미터가 사용됩니다. 이 CompositeDataSupport 인스턴스에 포함되는 항목은 내부에서 TreeMap에 포함됩니다. 개개의 항목은 값을 고속으로 취득할 수 있도록, 알파벳의 승순으로 소트 됩니다.

생성자는 각 파라미터가 아래의 모든 제약을 채우고 있는 것을 확인해, 채워지지 않은 제약이 있는 경우는 적절한 예외를 Throw 합니다.

파라미터:

compositeType - 이 「복합 데이터」인스턴스의 「복합형」. null 이외

itemNames - itemNames는 compositeType에 정의된 모든 항목명을 임의의 차례로 나란해질 수 있을 필요가 있다. 이 차례로 itemValues[] 내의 값의 매칭을 한다. null 또는 공문자열 이외

itemValues - 항목의 값. itemNames 내의 이름과 같은 차례로 나란해질 수 있다. 항목의 값은 null 여도 괜찮지만, null이 아닌 경우, 대응하는 항목의 compositeType에 정의된 공개형에 대해서 유효한 값이 아니면 안된다. itemNames와 같은 사이즈로 null 또는 공문자열 이외

예외:

IllegalArgumentException - compositeType가 null인 경우, itemNames[] 또는 itemValues[]가 null 또는 공문자열의 경우, itemNames[] 내에 null 또는 비어있는 요소가 포함되는 경우, 또는 itemNames[]와 itemValues[] 사이즈가 다른 경우

OpenDataException - itemNames[] 또는 itemValues[] 사이즈가 compositeType에 정의된 항목수와 다른 경우, itemNames[] 내의 몇개의 요소가 compositeType에 정의된 항목명으로 일치하고 있지 않는 경우, 또는 itemValues[] 내의 몇개의 요소가 compositeType에 정의되고 있도록 대응하는 항목에 대해서 유효한 값이 아닌 경우

CompositeDataSupport

public CompositeDataSupport(CompositeType  compositeType,
                            Map  items)
                     throws OpenDataException 

지정된 compositeType로 CompositeDataSupport 인스턴스를 구축합니다. compositeType 항목명으로 대응하는 값은 맵 items 내의 매핑에 의해 지정됩니다. 이 생성자는 문자 배열의 키와 값을 객체 배열로 변환해, CompositeDataSupport(javax.management.openmbean.CompositeType, java.lang.String[], java.lang.Object[])를 호출합니다.

파라미터:

compositeType - 이 「복합 데이터」인스턴스의 「복합형」. null 이외

items - 모든 항목명과 그 값의 매핑. items에는 compositeType에 정의된 모든 항목명이 포함되지 않으면 안 된다. null 또는 공문자열 이외

예외:

IllegalArgumentException - compositeType가 null인 경우, items가 null 또는 공문자열의 경우, items 내의 몇개의 키가 null 또는 공문자열의 경우, 또는 items 몇개의 값이 null인 경우

OpenDataException - items 사이즈가 compositeType에 정의된 항목수와 다른 경우, items 내의 몇개의 키가 compositeType에 정의된 항목명으로 일치하고 있지 않는 경우, 또는 items 내의 몇개의 값이 compositeType에 정의되고 있도록 대응하는 항목에 대해서 유효한 값이 아닌 경우

ArrayStoreException - items 내의 1개 이상의 키가 java.lang.String 클래스가 아닌 경우

메서드의 상세

getCompositeType

public CompositeType  getCompositeType()

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

정의:

인터페이스 CompositeData 내의 getCompositeType

반환값:

이 CompositeData 형태

get

public Object  get(String  key)

key 라는 이름의 항목의 값을 리턴합니다.

정의:

인터페이스 CompositeData 내의 get

파라미터:

key - 항목의 이름

반환값:

이 키에 관련한 값

예외:

IllegalArgumentException - key가 null 또는 비어있는 String인 경우

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

getAll

public Object [] getAll(String [] keys)

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

정의:

인터페이스 CompositeData 내의 getAll

파라미터:

keys - 항목의 이름

반환값:

키에 대응하는 값

예외:

IllegalArgumentException - keys 내의 요소가 null 또는 비어있는 String인 경우

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

containsKey

public boolean containsKey(String  key)

이 CompositeData 인스턴스에 key 라는 이름의 항목이 포함되는 경우에 한정해, true를 리턴합니다. key가 null 또는 비어있는 String인 경우, 이 메서드는 false를 리턴합니다.

정의:

인터페이스 CompositeData 내의 containsKey

파라미터:

key - 판정되는 키

반환값:

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

containsValue

public boolean containsValue(Object  value)

이 CompositeData 인스턴스에 value 라는 이름의 항목이 포함되는 경우에 한정해, true를 리턴합니다.

정의:

인터페이스 CompositeData 내의 containsValue

파라미터:

value - 판정되는 값

반환값:

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

values

public Collection  values()

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

정의:

인터페이스 CompositeData 내의 values

반환값:

치

equals

public boolean equals(Object  obj)

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

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

• obj가 null이 아니다
• obj가 CompositeData인터페이스를 구현하고 있다
• 복합형이 동일하다
• 내용, 즉 이름과 값의 페어가 동일하다

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

정의:

인터페이스 CompositeData 내의 equals

오버라이드(override):

클래스 Object 내의 equals

파라미터:

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

반환값:

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

관련 항목:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

이 CompositeDataSupport인스턴스의 해시 코드값을 리턴합니다.

CompositeDataSupport인스턴스의 해시 코드는 equals 비교로 사용된 모든 정보 요소 ( 「복합형」이라고 모든 항목치)의 해시 코드의 합계입니다.

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

CompositeData인터페이스를 구현하는 다른 클래스 인스턴스가equals(java.lang.Object) 로 정의되고 있도록, 이 CompositeDataSupport인스턴스와 동일해지는 경우도 있습니다. 그러나, 계산방법이 차이가 나기 때문에 해시 코드도 차이가 날 가능성이 있습니다.

정의:

인터페이스 CompositeData 내의 hashCode

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

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

관련 항목:

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

toString

public String  toString()

이 CompositeDataSupport인스턴스의 캐릭터 라인 표현을 리턴합니다.

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

정의:

인터페이스 CompositeData 내의 toString

오버라이드(override):

클래스 Object 내의 toString

반환값:

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