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 또는 null (key 에 일치하는 값이 없는 경우)의 CompositeData 치를 돌려줍니다.
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 가 빈 상태(empty)의 경우는 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 또는 null (key 에 일치하는 값이 없는 경우)의 CompositeData 치를 돌려줍니다.

파라미터:

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 는 Set<List<? >> 입니다만, 호환성을 유지하기 위해서 Set<? > 로서 선언됩니다. 반환되는 세트를 사용해, 키의 반복 처리를 실시할 수가 있습니다.

반환값:

이 TabularData 인스턴스로 사용된다 인덱스치의 셋트뷰 (Set<List<? >>)

values

Collection <? > values()

이 TabularData 인스턴스에 포함되는 CompositeData 치 (행)의 코레크션뷰를 돌려줍니다. 반환되는 Collection 는 Collection<CompositeData> 입니다만, 호환성을 유지하기 위해서 Collection<? > 로서 선언됩니다. 반환되는 컬렉션을 사용해, 값의 반복 처리를 실시할 수가 있습니다.

반환값:

이 TabularData 인스턴스에 포함되는 행의 코레크션뷰 (Collection<CompositeData>)

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 인스턴스의 캐릭터 라인 표현