StandardMBean (Java Platform SE 6) - xrath.com 에서 번역됨

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세: 필드 | 생성자 | 메소드

javax.management
클래스 StandardMBean

java.lang.Object 
  javax.management.StandardMBean

모든 구현된 인터페이스:: DynamicMBean , MBeanRegistration

직계의 기존의 서브 클래스:: StandardEmitterMBean

public class StandardMBean
extends Object
implements DynamicMBean , MBeanRegistration
extends Object
implements DynamicMBean , MBeanRegistration

Java 인터페이스의 리플렉션에 의해 관리 인터페이스를 결정하는 MBean 입니다.

이 클래스는, Standard MBean 의 사용에 있어서의 관리 인터페이스의 개념의 유연성을 향상시킵니다. JMX 스펙에 설명되고 있는 Standard MBean 의 패턴의 단순한 사용 방법에는, MBean 의 구현 클래스와 관리 인터페이스간에 고정한 관계가 있다고 설명되고 있습니다 (즉, 구현 클래스가 Thing 의 경우, 관리 인터페이스는 ThingMBean 가 아니면 안된다). 이 클래스는, 구현 클래스와 인터페이스 클래스간의 이름의 관련성을 필요로 하지 않고, Java 인터페이스에 의한 관리 인터페이스의 지정에 도움이 됩니다.

MBean 로부터 DynamicMBean 를 제외하는 것으로써, 이 클래스는, MBean 가 구현하는 임의의 인터페이스를 관리 인터페이스로서 선택할 수 있습니다. 다만, JMX 패턴에 준거하는 인터페이스가 아니면 안됩니다 (취득 메소드 또는 설정 메소드에 의해 정의된 속성 등).

이 클래스는, DynamicMBean 인터페이스로부터 반환되는 MBeanInfo 에 커스텀의 기술과 이름을 할당할 수가 있는 훅을 제공합니다.

이 클래스를 사용해, 임의의 구현 클래스명 Impl 와 임의의 인터페이스 Intf 로 정의된 관리 인터페이스 (현재의 Standard MBean 용)를 지정해 MBean 를 작성할 수 있습니다. 일반적으로, 다음의 몇개의 작성 방법을 선택합니다.

public 생성자 StandardMBean(impl, interface) 를 사용

     MBeanServer mbs;
     ...
     Impl impl = new Impl(...);
     StandardMBean mbean = new StandardMBean(impl, Intf.class, false);
     mbs.registerMBean(mbean, objectName);

StandardMBean 의 서브 클래스화

     public class Impl extends StandardMBean implements Intf {
        public Impl() {
          super(Intf.class, false);
       }
       // implement methods of Intf
     }

     [...]

     MBeanServer mbs;
     ....
     Impl impl = new Impl();
     mbs.registerMBean(impl, objectName);

어느 경우도, 클래스 Impl 는 인터페이스 Intf 를 구현할 필요가 있습니다.

구현 클래스와 인터페이스 클래스간의 이름의 관련성에 근거한 Standard MBean 도, 계속 사용 가능합니다.

이 클래스는, MXBean 의 구축에도 사용할 수 있습니다. 사용법은, 위의 예의 생성자 에게 건네지는 false 파라미터 또는 super(...) 의 호출이 대신에 true 가 되는 것을 제외해, Standard MBean 와 완전히 같습니다.

도입된 버젼:: 1.5

생성자 의 개요
`protected`	`StandardMBean (Class <? > mbeanInterface)` 특정의 `mbeanInterface` 클래스를 사용해, DynamicMBean 를 `this` 로부터 제외합니다.
`protected`	`StandardMBean (Class <? > mbeanInterface, boolean isMXBean)` 특정의 `mbeanInterface` 클래스를 사용해, DynamicMBean 를 `this` 로부터 제외합니다.
	`StandardMBean (T implementation, Class <T> mbeanInterface)` 특정의 `mbeanInterface` 클래스를 사용해, DynamicMBean 를 객체 `implementation` 로부터 제외합니다.
	`StandardMBean (T implementation, Class <T> mbeanInterface, boolean isMXBean)` 특정의 `mbeanInterface` 클래스를 사용해, DynamicMBean 를 객체 `implementation` 로부터 제외합니다.

메소드의 개요
`protected void`	`cacheMBeanInfo (MBeanInfo info)` 커스터마이즈 훅:이 객체용으로 구축된 MBeanInfo 를 캐쉬에 넣습니다.
`Object`	`getAttribute (String attribute)` Dynamic MBean 의 특정의 속성의 값을 가져옵니다.
`AttributeList`	`getAttributes (String [] attributes)` Dynamic MBean 의 복수의 속성의 값을 가져옵니다.
`protected MBeanInfo`	`getCachedMBeanInfo ()` 커스터마이즈 훅:이 객체용으로 캐쉬된 MBeanInfo 를 돌려줍니다.
`protected String`	`getClassName (MBeanInfo info)` 커스터마이즈 훅:이 MBean 로부터 반환되는 MBeanInfo 내에서 사용되는 className 를 가져옵니다.
`protected MBeanConstructorInfo []`	`getConstructors (MBeanConstructorInfo [] ctors, Object impl)` 커스터마이즈 훅:이 MBean 로부터 반환되는 MBeanInfo 로 사용되는 MBeanConstructorInfo[] 를 가져옵니다.
`protected String`	`getDescription (MBeanAttributeInfo info)` 커스터마이즈 훅:이 MBean 가 돌려주는 MBeanAttributeInfo 내에서 사용되는 설명을 가져옵니다.
`protected String`	`getDescription (MBeanConstructorInfo info)` 커스터마이즈 훅:이 MBean 로부터 반환되는 MBeanConstructorInfo 내에서 사용되는 설명을 가져옵니다.
`protected String`	`getDescription (MBeanConstructorInfo ctor, MBeanParameterInfo param, int sequence)` 커스터마이즈 훅:이 MBean 로부터 반환되는 MBeanConstructorInfo 의 `sequence` MBeanParameterInfo 에 사용되는 설명을 가져옵니다.
`protected String`	`getDescription (MBeanFeatureInfo info)` 커스터마이즈 훅:이 MBean 가 돌려주는 MBeanFeatureInfo 내에서 사용되는 설명을 가져옵니다.
`protected String`	`getDescription (MBeanInfo info)` 커스터마이즈 훅:이 MBean 로부터 반환되는 MBeanInfo 내에서 사용되는 설명을 가져옵니다.
`protected String`	`getDescription (MBeanOperationInfo info)` 커스터마이즈 훅:이 MBean 로부터 반환되는 MBeanOperationInfo 내에서 사용되는 설명을 가져옵니다.
`protected String`	`getDescription (MBeanOperationInfo op, MBeanParameterInfo param, int sequence)` 커스터마이즈 훅:이 MBean 로부터 반환되는 MBeanOperationInfo 의 `sequence` MBeanParameterInfo 에 사용되는 설명을 가져옵니다.
`protected int`	`getImpact (MBeanOperationInfo info)` 커스터마이즈 훅:이 MBean 로부터 반환되는 MBeanOperationInfo 로 사용되는 오퍼레이션의 `impact` 플래그를 가져옵니다.
`Object`	`getImplementation ()` 이 Standard MBean (또는 MXBean)의 구현을 가져옵니다.
`Class <? >`	`getImplementationClass ()` 이 Standard MBean (또는 MXBean)의 구현의 클래스를 가져옵니다.
`MBeanInfo`	`getMBeanInfo ()` 이 MBean `MBeanInfo` 를 가져옵니다.
`Class <? >`	`getMBeanInterface ()` 이 Standard MBean (또는 MXBean)의 관리 인터페이스를 가져옵니다.
`protected String`	`getParameterName (MBeanConstructorInfo ctor, MBeanParameterInfo param, int sequence)` 커스터마이즈 훅:이 MBean 로부터 반환되는 MBeanConstructorInfo 의 `sequence` MBeanParameterInfo 에 사용되는 이름을 가져옵니다.
`protected String`	`getParameterName (MBeanOperationInfo op, MBeanParameterInfo param, int sequence)` 커스터마이즈 훅:이 MBean 로부터 반환되는 MBeanOperationInfo 의 `sequence` MBeanParameterInfo 에 사용되는 이름을 가져옵니다.
`Object`	`invoke (String actionName, Object [] params, String [] signature)` Dynamic MBean 상에서의 액션의 실행을 허가합니다.
`void`	`postDeregister ()` MBean 서버로부터 등록 해제한 뒤, MBean 가 필요한 오퍼레이션을 실행할 수 있도록(듯이) 합니다.
`void`	`postRegister (Boolean registrationDone)` MBean 서버에의 등록이 성공 또는 실패한 뒤, MBean 가 필요한 오퍼레이션을 실행할 수 있도록(듯이) 합니다.
`void`	`preDeregister ()` MBean 서버로부터 등록 해제하기 전에, MBean 가 필요한 오퍼레이션을 실행할 수 있도록(듯이) 합니다.
`ObjectName`	`preRegister (MBeanServer server, ObjectName name)` MBean 서버에 등록하기 전에, MBean 에 필요한 오퍼레이션을 실행시킬 수가 있습니다.
`void`	`setAttribute (Attribute attribute)` Dynamic MBean 의 특정의 속성의 값을 설정합니다.
`AttributeList`	`setAttributes (AttributeList attributes)` Dynamic MBean 의 복수의 속성의 값을 설정합니다.
`void`	`setImplementation (Object implementation)` 이 객체내의 랩 된 구현 객체를 치환합니다.

클래스 java.lang. Object 로부터 상속된 메소드
`clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait`

생성자 의 상세

StandardMBean

public StandardMBean(T implementation,
                     Class <T> mbeanInterface)
              throws NotCompliantMBeanException

특정의 mbeanInterface 클래스를 사용해, DynamicMBean 를 객체 implementation 로부터 제외합니다.

형태 파라미터:: T - mbeanInterface 로 기술된 클래스를 implementation 가 실제로 구현하고 있는지 체크하는 것을 컴파일러에 허가한다. 컴파일러가 이 체크를 실행할 수 있는 것은, mbeanInterface 가 MyMBean.class 등의 클래스 리터럴인 경우만
파라미터:: implementation - 이 MBean 의 구현; mbeanInterface - 이 MBean 의 구현에 의해 export 된다 관리 인터페이스. null 의 경우, 이 객체는 표준 JMX 설계 패턴을 사용해, 지정된 구현에 관련지을 수 있었던 관리 인터페이스를 특정한다
예외:: IllegalArgumentException - 지정되었다 implementation 가 null 의 경우; NotCompliantMBeanException - mbeanInterface 가 관리 인터페이스의 JMX 설계 패턴에 따르지 않은 경우, 또는 지정된 implementation 가 특정의 인터페이스를 구현하고 있지 않는 경우

StandardMBean

protected StandardMBean(Class <? > mbeanInterface)
                 throws NotCompliantMBeanException

특정의 mbeanInterface 클래스를 사용해, DynamicMBean 를 this 로부터 제외합니다.

this(this, mbeanInterface) 를 호출합니다. 이 생성자 은 서브 클래스용으로서 예약되고 있습니다.

파라미터:: mbeanInterface - 이 MBean 에 의해 export 된다 관리 인터페이스
예외:: NotCompliantMBeanException - mbeanInterface 가 관리 인터페이스의 JMX 설계 패턴에 따르지 않은 경우, 또는 this 가 특정의 인터페이스를 구현하고 있지 않는 경우

StandardMBean

public StandardMBean(T implementation,
                     Class <T> mbeanInterface,
                     boolean isMXBean)

특정의 mbeanInterface 클래스를 사용해, DynamicMBean 를 객체 implementation 로부터 제외합니다. 이 생성자 은, Standard MBean 또는 MXBean 의 작성에 사용할 수 있습니다. StandardMBean(Object, Class) 생성자 과는 달라, 이것은 NotCompliantMBeanException 를 throw 하지 않습니다.

형태 파라미터:: T - mbeanInterface 로 기술된 클래스를 implementation 가 실제로 구현하고 있는지 체크하는 것을 컴파일러에 허가한다. 컴파일러가 이 체크를 실행할 수 있는 것은, mbeanInterface 가 MyMBean.class 등의 클래스 리터럴인 경우만
파라미터:: implementation - 이 MBean 의 구현; mbeanInterface - 이 MBean 의 구현에 의해 export 된다 관리 인터페이스. null 의 경우, 이 객체는 표준 JMX 설계 패턴을 사용해, 지정된 구현에 관련지을 수 있었던 관리 인터페이스를 특정하는; isMXBean - true 의 경우,mbeanInterface 파라미터에 의해 MXBean 인터페이스가 명명되어 생성되는 MBean 는 MXBean 가 된다
예외:: IllegalArgumentException - 지정되었다 implementation 가 null 의 경우,mbeanInterface 가 관리 인터페이스의 JMX 설계 패턴에 따르지 않은 경우, 또는 지정된 implementation 가 특정의 인터페이스를 구현하고 있지 않는 경우
도입된 버젼:: 1.6

StandardMBean

protected StandardMBean(Class <? > mbeanInterface,
                        boolean isMXBean)

특정의 mbeanInterface 클래스를 사용해, DynamicMBean 를 this 로부터 제외합니다. 이 생성자 은, Standard MBean 또는 MXBean 의 작성에 사용할 수 있습니다. StandardMBean(Object, Class) 생성자 과는 달라, 이것은 NotCompliantMBeanException 를 throw 하지 않습니다.

this(this, mbeanInterface, isMXBean) 를 호출합니다. 이 생성자 은 서브 클래스용으로서 예약되고 있습니다.

파라미터:: mbeanInterface - 이 MBean 에 의해 export 된다 관리 인터페이스; isMXBean - true 의 경우,mbeanInterface 파라미터에 의해 MXBean 인터페이스가 명명되어 생성되는 MBean 는 MXBean 가 된다
예외:: IllegalArgumentException - mbeanInterface 가 관리 인터페이스의 JMX 설계 패턴에 따르지 않은 경우, 또는 this 가 특정의 인터페이스를 구현하고 있지 않는 경우
도입된 버젼:: 1.6

메소드의 상세

setImplementation

public void setImplementation(Object  implementation)
                       throws NotCompliantMBeanException

이 객체내의 랩 된 구현 객체를 치환합니다.

파라미터:: implementation - 이 Standard MBean (또는 MXBean)의 새로운 구현. implementation 객체는, StandardMBean 의 구축시에 제공된 Standard MBean (또는 MXBean) 인터페이스를 구현할 필요가 있다
예외:: IllegalArgumentException - 지정되었다 implementation 가 null 의 경우; NotCompliantMBeanException - 지정되었다 implementation 가 구축시에 제공되었다 Standard MBean (또는 MXBean) 인터페이스를 구현하고 있지 않는 경우
관련 항목:: getImplementation()

getImplementation

public Object  getImplementation()

이 Standard MBean (또는 MXBean)의 구현을 가져옵니다.

반환값:: 이 Standard MBean (또는 MXBean)의 구현
관련 항목:: setImplementation(java.lang.Object)

getMBeanInterface

public final Class <? > getMBeanInterface()

이 Standard MBean (또는 MXBean)의 관리 인터페이스를 가져옵니다.

반환값:: 이 Standard MBean (또는 MXBean)의 관리 인터페이스

getImplementationClass

public Class <? > getImplementationClass()

이 Standard MBean (또는 MXBean)의 구현의 클래스를 가져옵니다.

반환값:: 이 Standard MBean (또는 MXBean)의 구현의 클래스