javax.management.openmbean
인터페이스 TabularData

알려진 구현 클래스 목록:

TabularDataSupport

public interface TabularData

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

도입된 버전 :

1.5

메서드 개요

Object []	calculateIndex (CompositeData value) 이 TabularData 인스턴스에 지정된 복합 데이터 value 파라미터를 참조하기 위해서 사용되는 인덱스가 추가되고 있는 경우, 이 인덱스를 계산합니다.
void	clear () 이 TabularData 인스턴스로부터 모든 CompositeData 치 (행)를 삭제합니다.
boolean	containsKey (Object [] key) 이 TabularData 인스턴스에 인덱스가 지정된 key가 되어 있는 CompositeData 치 (행)가 포함되는 경우에 한정해 true를 리턴합니다.
boolean	containsValue (CompositeData value) 이 TabularData 인스턴스에 지정된 CompositeData 값이 포함되는 경우에 한정해 true를 리턴합니다.
boolean	equals (Object obj) 지정된 obj 파라미터와 이 TabularData인스턴스가 동일한지 어떤지를 비교합니다.
CompositeData	get (Object [] key) 이 TabularData 인스턴스내의, 인덱스가 key CompositeData 치, 또는 null (key에 일치하는 값이 없는 경우)를 리턴합니다.
TabularType	getTabularType () 이 TabularData 인스턴스를 기술하는 「표 형」을 리턴합니다.
int	hashCode () 이 TabularData인스턴스의 해시 코드값을 리턴합니다.
boolean	isEmpty () 이 TabularData 인스턴스에 포함되는 CompositeData 치의 수 (행수)가 제로의 경우, true를 리턴합니다.
Set	keySet () 이 TabularData 인스턴스에 포함되는 CompositeData 치 (행)의 키 (인덱스치)의 셋트뷰를 리턴합니다.
void	put (CompositeData value) 이 TabularData 인스턴스에 value를 추가합니다.
void	putAll (CompositeData [] values) values 내의 모든 요소를 이 TabularData 인스턴스에 추가합니다.
CompositeData	remove (Object [] key) 인덱스가 이 TabularData 인스턴스의 key가 되어 있는 CompositeData 치를 삭제해, 삭제된 값을 리턴합니다.
int	size () 이 TabularData 인스턴스에 포함되는 CompositeData 치의 수 (행수)를 리턴합니다.
String	toString () 이 TabularData인스턴스의 캐릭터 라인 표현을 리턴합니다.
Collection	values () 이 TabularData 인스턴스에 포함되는 CompositeData 치 (행)의 코레크션뷰를 리턴합니다.

메서드의 상세

getTabularType

TabularType  getTabularType()

이 TabularData 인스턴스를 기술하는 「표 형」을 리턴합니다.

반환값:

표 형

calculateIndex

Object [] calculateIndex(CompositeData  value)

이 TabularData 인스턴스에 지정된 복합 데이터 value 파라미터를 참조하기 위해서 사용되는 인덱스가 추가되고 있는 경우, 이 인덱스를 계산합니다. 이 메서드는 지정된 value 형태의 타당성을 검사합니다. 다만, 계산된 인덱스가 이 TabularData 인스턴스내의 값을 참조하기 위해서 이미 사용되고 있을지 어떨지는 검사하지 않습니다.

파라미터:

value - 복합 데이터. 이 TabularData 인스턴스내의 이 데이터의 인덱스를 계산한다. 이 인스턴스의 행의 형태와 같은 복합형으로 null 이외가 아니면 안된다

반환값:

지정된 value가 이 TabularData 인스턴스내에 가지는 인덱스

예외:

NullPointerException - value가 null인 경우

InvalidOpenTypeException - value가 이 TabularData 인스턴스의 행의 형태 정의에 준거하고 있지 않는 경우

size

int size()

이 TabularData 인스턴스에 포함되는 CompositeData 치의 수 (행수)를 리턴합니다.

반환값:

포함되는 값의 수

isEmpty

boolean isEmpty()

이 TabularData 인스턴스에 포함되는 CompositeData 치의 수 (행수)가 제로의 경우, true를 리턴합니다.

반환값:

이 TabularData가 비어있는 경우는 true

containsKey

boolean containsKey(Object [] key)

이 TabularData 인스턴스에 인덱스가 지정된 key가 되어 있는 CompositeData 치 (행)가 포함되는 경우에 한정해 true를 리턴합니다. key가 null인 경우, 또는 이 TabularData 인스턴스의 TabularType 정의에 준거하고 있지 않는 경우, 이 메서드는 false를 리턴합니다.

파라미터:

key - 이 TabularData 내에 있을지 어떨지 테스트되는 인덱스치

반환값:

이 TabularData가 지정된 키를 가지는 행의 값을 나타내는 경우는 true

containsValue

boolean containsValue(CompositeData  value)

이 TabularData 인스턴스에 지정된 CompositeData 값이 포함되는 경우에 한정해 true를 리턴합니다. value가 null인 경우, 또는 이 TabularData 인스턴스의 행의 형태 정의에 준거하고 있지 않는 경우, 이 메서드는 false를 리턴합니다.

파라미터:

value - 이 TabularData 내에 있을지 어떨지 테스트되는 행의 값

반환값:

이 TabularData 인스턴스로 지정된 행의 값이 포함되는 경우는 true

get

CompositeData  get(Object [] key)

이 TabularData 인스턴스내의, 인덱스가 key CompositeData 치, 또는 null (key에 일치하는 값이 없는 경우)를 리턴합니다.

파라미터:

key - 리턴된 행의 키

반환값:

key에 대응하는 값

예외:

NullPointerException - key가 null인 경우

InvalidKeyException - key가 이 TabularData 인스턴스의 TabularType 정의에 준거하고 있지 않는 경우

put

void put(CompositeData  value)

이 TabularData 인스턴스에 value를 추가합니다. value 복합형은 이 인스턴스의 행의 형태 (this.getTabularType(). getRowType() 에 의해 리턴된 복합형)와 같지 않으면 안됩니다. 또, 이 TabularData 인스턴스내에 추가되는 value 용으로 계산된 인덱스를 가지는 기존의 값이 존재하고 있어 되지 않습니다. value 인덱스는 이 TabularData 인스턴스의 TabularType 정의에 따라 계산됩니다 (TabularType. getIndexNames() 를 참조).

파라미터:

value - 이 TabularData 인스턴스에 새로운 행으로서 추가되는 복합 데이터. 이 인스턴스의 행의 형태와 같은 복합형으로 null 이외가 아니면 안된다

예외:

NullPointerException - value가 null인 경우

InvalidOpenTypeException - value가 이 TabularData 인스턴스의 행의 형태 정의에 준거하고 있지 않는 경우

KeyAlreadyExistsException - 이 TabularData 인스턴스의 TabularType 정의에 준거하도록 계산된 value 인덱스가 부하의 HashMap 내의 기존의 값과 이미 일치하고 있는 경우

remove

CompositeData  remove(Object [] key)

인덱스가 이 TabularData 인스턴스의 key가 되어 있는 CompositeData 치를 삭제해, 삭제된 값을 리턴합니다. 인덱스가 key 값이 없는 경우는 null을 리턴합니다.

파라미터:

key - 이 TabularData 인스턴스내에 얻는 값의 인덱스. 이 TabularData 인스턴스의 행의 형태 정의에 대해서 유효하고 null 이외가 아니면 안된다

반환값:

지정된 키와 관련지을 수 있고 있던 이전의 값. 키의 매핑이 없었던 경우는 null

예외:

NullPointerException - key가 null인 경우

InvalidKeyException - key가 이 TabularData 인스턴스의 TabularType 정의에 준거하고 있지 않는 경우

putAll

void putAll(CompositeData [] values)

values 내의 모든 요소를 이 TabularData 인스턴스에 추가합니다. values 내에 put 로 정의된 제약을 채우지 않는 요소가 있는 경우, 또는 values 내의 2개의 요소로 이 TabularData 인스턴스의 TabularType 정의에 준거하도록 계산된 인덱스가 같게 되어 있는 경우, 장해를 기술하는 예외가 Throw 되어values 요소는 추가되지 않습니다. 따라서, 이 TabularData 인스턴스는 변경되지 않습니다.

파라미터:

values - 복합 데이터의 배열. 이 값이, 새로운 행으로서 이 TabularData 인스턴스에 추가된다. values가 null 또는 공문자열의 경우, 이 메서드는 아무것도 하지 않고 종료한다

예외:

NullPointerException - value 요소가 null인 경우

InvalidOpenTypeException - values 내의 요소가 이 TabularData 인스턴스의 행의 형태 정의에 준거하고 있지 않는 경우

KeyAlreadyExistsException - 이 TabularData 인스턴스의 TabularType 정의에 준거하도록 계산된 values 요소의 인덱스가 이 인스턴스내의 기존의 값에 이미 일치하고 있는 경우, 또는 values 내에 같은 인덱스를 가지는 값이 2개 존재하는 경우

clear

void clear()

이 TabularData 인스턴스로부터 모든 CompositeData 치 (행)를 삭제합니다.

keySet

Set  keySet()

이 TabularData 인스턴스에 포함되는 CompositeData 치 (행)의 키 (인덱스치)의 셋트뷰를 리턴합니다. 리턴된 Set를 사용해, 키의 반복 처리를 실시할 수 있습니다 .

반환값:

이 TabularData 인스턴스내에서 사용되는 인덱스치의 셋트뷰

values

Collection  values()

이 TabularData 인스턴스에 포함되는 CompositeData 치 (행)의 코레크션뷰를 리턴합니다. 리턴된 컬렉션을 사용해, 값의 반복 처리를 실시할 수 있습니다 .

반환값:

이 TabularData 인스턴스내에 포함되어 있는 행의 코레크션뷰

equals

boolean equals(Object  obj)

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

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

• obj가 null이 아니다
• obj가 TabularData인터페이스를 구현하고 있다
• 행형이 동일하다
• 내용 (인덱스와 값의 매핑)이 동일하다

이러한 조건이 채워지고 있으면, 이 equals 메서드는 TabularData인터페이스가 다른 구현인 obj 파라미터에 대해서 정상적으로 기능합니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

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

반환값:

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

관련 항목:

Object.hashCode(), Hashtable

hashCode

int hashCode()

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

TabularData인스턴스의 해시 코드는 equals 비교로 사용된 모든 정보 요소 ( 「표 형」이라고, 모든 값매핑의 인덱스로서 정의된 내용)의 해시 코드의 합계입니다.

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

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

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

관련 항목:

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

toString

String  toString()

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

캐릭터 라인 표현은 구현 클래스명과 이 인스턴스의 표 형으로 구성됩니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

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