패키지 javax.management.openmbean

공개 데이터형과 Open MBean 기술자 클래스를 제공합니다.

참조처:
설명

인터페이스의 개요

CompositeData	CompositeData 인터페이스는, 「복합 데이터」구조를 표현하는 특정의 형태의 복합 「공개 데이터」객체의 동작을 지정합니다.
CompositeDataView	Java 클래스는, 이 인터페이스를 구현하는 것으로써, MXBean 시스템를 사용해 CompositeData 로 변환하는 방법을 나타낼 수가 있습니다.
OpenMBeanAttributeInfo	공개 MBean 의 속성을 기술합니다.
OpenMBeanConstructorInfo	Open MBean 의 생성자 을 기술합니다.
OpenMBeanInfo	Open MBean 를 기술합니다.
OpenMBeanOperationInfo	Open MBean 의 오퍼레이션을 기술합니다.
OpenMBeanParameterInfo	공개 MBean 의 1 개 이상의 오퍼레이션 또는 생성자 으로 사용되는 파라미터를 기술합니다.
TabularData	TabularData 인터페이스는, 「테이블 데이터」구조를 표현하는 특정의 형태의 복합 「공개 데이터」객체의 동작을 지정합니다.

클래스의 개요

ArrayType<T>	ArrayType 클래스는, 「공개 데이터」치의 n 차원 배열인 모든 「공개 데이터」치를 기술하는 인스턴스를 가지는 「공개형」클래스입니다.
CompositeDataInvocationHandler	취득 메소드를 CompositeData 에 전송 하는 InvocationHandler 입니다.
CompositeDataSupport	CompositeDataSupport 클래스는,CompositeData 인터페이스를 구현하는 「공개 데이터」클래스입니다.
CompositeType	CompositeType 클래스는,CompositeData 치의 형태를 기술하는 인스턴스를 가지는 「공개형」클래스입니다.
OpenMBeanAttributeInfoSupport	공개 MBean 의 속성을 기술합니다.
OpenMBeanConstructorInfoSupport	Open MBean 의 생성자 을 기술합니다.
OpenMBeanInfoSupport	OpenMBeanInfoSupport 클래스는, 「공개 MBean」의 관리 정보를 기술합니다.
OpenMBeanOperationInfoSupport	Open MBean 의 오퍼레이션을 기술합니다.
OpenMBeanParameterInfoSupport	공개 MBean 의 1 개 이상의 오퍼레이션 또는 생성자 으로 사용되는 파라미터를 기술합니다.
OpenType<T>	OpenType 클래스는, 실제의 공개 데이터값의 「공개형」을 기술하는 모든 클래스의 친 abstract 클래스입니다.
SimpleType<T>	SimpleType 클래스는, 배열에서도 CompositeData 치에서도 TabularData 치도 아닌 모든 「공개 데이터」치를 기술하는 인스턴스를 가지는, 「공개형」클래스입니다.
TabularDataSupport	TabularDataSupport 클래스는,TabularData 인터페이스와 Map 인터페이스를 구현해, 내부에서 해시 맵 데이터 구조에 근거하고 있는 「공개 데이터」클래스입니다.
TabularType	TabularType 클래스는,TabularData 치의 형태를 기술하는 인스턴스를 가지는 「공개형」클래스입니다.

예외의 개요

InvalidKeyException	이 실행시 예외는, 「복합 데이터」의 항목명 또는 「겉(표) 데이터」의 행 인덱스가 될 예정이었던 메소드 파라미터가 무효인 경우에 throw 됩니다.
InvalidOpenTypeException	이 실행시 예외는, 「공개 데이터」치의 「공개형」이 예상하고 있던 값과 다른 경우에 throw 됩니다.
KeyAlreadyExistsException	이 실행시 예외는, 「겉(표) 데이터」인스턴스에 추가되는 행의 인덱스가, 이 「겉(표) 데이터」인스턴스내의 다른 행을 참조하기 위해서 벌써 사용되고 있는 경우에 throw 됩니다.
OpenDataException	이 확인이 끝난 예외는, 타당성의 제약의 일부가 채워지지 않기 때문에, 「공개형」, 「공개 데이터」, 또는 「공개 MBean 메타데이타 정보」인스턴스를 구축할 수 없었던 경우에 throw 됩니다.

패키지 javax.management.openmbean 의 설명

공개 데이터형과 Open MBean 기술자 클래스를 제공합니다. Open MBean 는 MBean 의 일종이며, 그 속성 및 오퍼레이션 파라미터의 형태와 반환값은, 몇개의 사전 정의 끝난 Java 클래스를 사용해 구축됩니다. Open MBean 는, 어플리케이션 고유의 형태 (비 Java 프로그램을 포함한다)에 반드시 액세스 할 수 있다고는 할 수는 없는 remote administration 프로그램을 사용해, 오퍼레이션을 간편화합니다.

모든 MBean 는, MBean 자체의 정보와 그 속성, 오퍼레이션, 생성자 , 및 통지를 갖춘 MBeanInfo 를 가집니다. Open MBean 에서는, 이 MBeanInfo 는, 일반적으로 OpenMBeanInfoSupport 의 인스턴스가 되는 것으로,OpenMBeanInfo 인터페이스를 구현합니다.

Open MBean 의 MBeanInfo.getAttributes 에 의해 반환되는 속성 정보는, OpenMBeanAttributeInfo 를 구현하는 객체 (일반적으로 OpenMBeanAttributeInfoSupport 의 인스턴스)의 배열이 됩니다. OpenMBeanAttributeInfo 는, 속성에 관한 일반 정보에 가세해, 속성 OpenType 를 지정합니다. 가능한 OpenType 치는 사전에 정의되고 있기 (위해)때문에, 원격 매니저는 이것들을 인식합니다.

오퍼레이션 및 생성자 의 파라미터형, 또 오퍼레이션의 귀가형에 대해서도, 같은 것을 말할 수 있습니다.

getType() 에 의해 반환되는 속성의 Java 언어형과getOpenType() 에 의해 반환되는 그 OpenType 에는 차이가 있습니다. 예를 들어, Java 언어형이 java.lang.String 의 경우,OpenType 는 SimpleType.String 가 됩니다. Java 언어형이 CompositeData 의 경우,OpenType 는 속성의 CompositeData 인스턴스내의 항목을 기술하는 CompositeType 가 됩니다.

디폴트 값와 제약

Open MBean 에서는, 속성 및 파라미터는, 관련지을 수 있었던 디폴트 값나 제약을 OpenMBeanAttributeInfo 또는 OpenMBeanParameterInfo 내 로 유지할 수 있습니다. 이러한 제약을 지정하려면 , 2 개의 방법이 있습니다. OpenMBeanAttributeInfoSupport 또는 OpenMBeanParameterInfoSupport 의 몇개의 생성자 에의 파라미터로서 값을 직접 지정하는 방법 (예,OpenMBeanParameterInfoSupport.OpenMBeanParameterInfoSupport( String, String, OpenType, Object, Object[]) )와 몇개의 생성자 에의 파라미터로서 지정된 Descriptor 내에 값을 지정하는 방법입니다.

Descriptor 를 사용하는 경우, 다음의 필드가 관련합니다.

• defaultValue 는,getDefaultValue() 에 의해 반환되는 값을 정의합니다.
• minValue 는,getMinValue() 에 의해 반환되는 값을 정의합니다.
• maxValue 는,getMaxValue() 에 의해 반환되는 값을 정의합니다.
• legalValues 은,getLegalValues() 에 의해 반환되는 값을 정의합니다.

defaultValue,minValue, 및 maxValue 의 경우, 관련하는 값은 openType 에 대응하는 Java 형, 또는 그 형태에 변환 가능한 캐릭터 라인이 아니면 안됩니다. static 메소드 valueOf(String) 가 검출되는 경우에는, 이 메소드가 변환에 사용됩니다. 이 메소드가 검출되지 않는 경우, 단일의 String 파라미터를 가지는 생성자 이 검출되는 경우에는 그 생성자 이 사용되어 그렇지 않은 경우에는 변환이 실패합니다.

legalValues 에서는, 관련하는 값은 배열 또는 Set 가 아니면 안됩니다. 또, 배열 또는 세트의 요소는,defaultValue 등에 대해 기술된 방법으로 변환 가능하지 않으면 안됩니다.

이러한 필드에서는, 다음의 조건을 채울 필요가 있습니다.

• 값은, 벌써 설명한 것처럼, 적절한 형태의 값인가, 적절한 형태에 변환 가능한 캐릭터 라인이 아니면 안됩니다.
• legalValues 가 존재하는 경우는,minValue 도 maxValue 도 존재 해서는 안됩니다.
• defaultValue 가 존재하는 경우,legalValues,minValue,maxValue 중 한쪽이 존재한다면, 거기서 정의된 제약을 채우고 있을 필요가 있습니다.
• minValue 와 maxValue 의 양쪽 모두가 존재하는 경우,minValue 가 maxValue 보다 크면 안됩니다.

도입된 버젼:

1.5

관련 항목:

Java SE 6 플랫폼의 JMX 테크놀러지에 관한 메뉴얼, 특히 「JMX 스펙, 버젼 1.4」(pdf)