javax.management.modelmbean
인터페이스 ModelMBean

모든 슈퍼 인터페이스:

DynamicMBean, ModelMBeanNotificationBroadcaster, NotificationBroadcaster, PersistentMBean

알려진 구현 클래스 목록:

RequiredModelMBean

public interface ModelMBean
extends DynamicMBean,
 PersistentMBean,
 ModelMBeanNotificationBroadcaster 

ModelMBean는 이 인터페이스를 구현할 필요가 있습니다. 이 인터페이스의 구현은 모든 JMX 에이전트에 부속되어 있습니다.

관리 대상이 되는 Java 자원은 MBeanServer createMBean 메서드를 사용해, ModelMBean를 인스턴스화합니다. 다음에 ModelMBean 인스턴스의 ModelMBeanInfo (Descriptor 첨부)를 설정합니다. ModelMBean ModelMBeanInfo 에서 공개된 속성과 오퍼레이션에는 MBean, 커넥터, 어댑터로부터 액세스 할 수 있습니다. ModelMBeanInfo Descriptor를 사용해, 관리 대상 어플리케이션내의 값과 메서드를 정의해, ModelMBean 속성 및 오퍼레이션에 맵 할 수 있습니다 . 이 매핑은 XML 형식의 파일을 사용해 개발시, 또는 실행시에 프로그램을 사용해 동적으로 정의할 수 있습니다.

MBeanServer 로 인스턴스화 된 MBean는 모두 관리 대상이 됩니다. 이러한 MBean 속성과 오퍼레이션에는 MBeanServer에 접속된 커넥터 또는 어댑터 경유로 원격 접근 할 수 있습니다. JMX 준거의 MBean가 아닌 Java 객체는 MBeanServer에 등록할 수 없습니다. 자원은 ModelMBean를 인스턴스화하는 것으로 MBean 유효성을 보증합니다.

모든 public 메서드로 MBeanException 및 RuntimeOperationsException가 Throw 될 필요가 있습니다. 이렇게 하는 것으로 분산형 통신 (RMI, EJB 등)에 한 예외를 랩 할 수 있습니다. 사양 및 javadoc에 기재되어 있는 시나리오 이외에서는 구현이 반드시 이러한 예외를 Throw 한다고는 할 수 없습니다.

도입된 버전 :

1.5

메서드 개요

void	setManagedResource (Object mr, String mr_type) 객체의 인스턴스 핸들을 설정합니다.
void	setModelMBeanInfo (ModelMBeanInfo inModelMBeanInfo) ModelMBeanInfo를 사용해 ModelMBean 객체를 초기화합니다.

인터페이스 javax.management. DynamicMBean 로부터 상속된 메서드

getAttribute, getAttributes, getMBeanInfo, invoke, setAttribute, setAttributes

인터페이스 javax.management. PersistentMBean 로부터 상속된 메서드

load, store

인터페이스 javax.management.modelmbean. ModelMBeanNotificationBroadcaster 로부터 상속된 메서드

addAttributeChangeNotificationListener, removeAttributeChangeNotificationListener, sendAttributeChangeNotification, sendAttributeChangeNotification, sendNotification, sendNotification

인터페이스 javax.management. NotificationBroadcaster 로부터 상속된 메서드

addNotificationListener, getNotificationInfo, removeNotificationListener

메서드의 상세

setModelMBeanInfo

void setModelMBeanInfo(ModelMBeanInfo  inModelMBeanInfo)
                       throws MBeanException,

                              RuntimeOperationsException 

ModelMBeanInfo를 사용해 ModelMBean 객체를 초기화합니다. 이 메서드를 사용하면, ModelMBean 상에 MBeanServer에 등록되지 않은 커스텀 ModelMBeanInfo를 설정할 수 있습니다.
ModelMBean ModelMBeanInfo (Descriptor 첨부)를 커스터마이즈 해, ModelMBean 로 설정한뒤 ModelMBean를 MBeanServer에 등록할 수 있습니다 .

ModelMBean가 현재 등록되어 있는 경우, 이 메서드는 IllegalStateException를 감싸는 RuntimeOperationsException를 Throw 합니다.

파라미터:

inModelMBeanInfo - ModelMBean에 의해 사용되는 ModelMBeanInfo 객체

예외:

MBeanException - 분산 통신 Exception을 랩 한다

RuntimeOperationsException -

• 파라미터로서 건네받은 MBeanInfo가 null인 경우, IllegalArgumentException를 랩 한다
• ModelMBean가 현재 MBeanServer에 등록되어 있는 경우, IllegalStateException를 랩 한다

setManagedResource

void setManagedResource(Object  mr,
                        String  mr_type)
                        throws MBeanException,

                               RuntimeOperationsException,

                               InstanceNotFoundException,

                               InvalidTargetObjectTypeException 

객체의 인스턴스 핸들을 설정합니다. 이 인스턴스 핸들에 대해서 이 ModelMBean 관리 인터페이스내의 모든 메서드 (MBeanInfo와 Descriptor)가 실행됩니다.

파라미터:

mr - 관리 대상의 자원이 되어 있는 객체

mr_type - 관리 대상의 자원의 참조의 형태. ObjectReference, Handle, IOR, EJBHandle, RMIReference 언젠가. MBeanServer가 건네받은 mr_type를 처리할 수 없는 경우, InvalidTargetTypeException가 Throw 된다

예외:

MBeanException - 객체의 이니샤라이자가 예외를 Throw 했을 경우

RuntimeOperationsException - IllegalArgumentException을 랩 한다. 파라미터로서 건네받은 관리 대상의 자원의 형태가 null인 경우

InstanceNotFoundException - 관리 대상의 자원 객체가 발견되지 않는 경우

InvalidTargetObjectTypeException - 관리 대상의 자원의 형태를 ModelMBean 또는 JMX 에이전트로 처리할 수 없는 경우