javax.management.modelmbean
클래스 RequiredModelMBean

java.lang.Object 
  javax.management.modelmbean.RequiredModelMBean

모든 구현된 인터페이스:

DynamicMBean, MBeanRegistration, ModelMBean, ModelMBeanNotificationBroadcaster, NotificationBroadcaster, NotificationEmitter, PersistentMBean

public class RequiredModelMBean
extends Object 
implements ModelMBean,
 MBeanRegistration,
 NotificationEmitter 

이 클래스는 ModelMBean 구현입니다. 모든 JMX 에이전트에 적절한 ModelMBean 구현이 부속되어 있을 필요가 있습니다. 또, 클래스명은 반드시 RequiredModelMBean 로 합니다.

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

MBeanServer 내에서 인스턴스화 되는 각 RequiredModelMBean가 관리 대상이 됩니다.
이러한 속성 및 오퍼레이션에는 MBeanServer에 접속된 커넥터 또는 어댑터 경유로 원격 접근 할 수 있습니다.

JMX 준거의 MBean가 아닌 Java 객체는 MBeanServer에 등록할 수 없습니다. RequiredModelMBean를 인스턴스화하는 것으로 자원은 MBean가 유효한 것이 보증됩니다. 모든 public 메서드로 MBeanException 및 RuntimeOperationsException가 Throw 될 필요가 있습니다. 이것에 의해 분산형 통신 (RMI, EJB 등)으로부터의 예외의 랩이 가능하게 됩니다.

도입된 버전 :

1.5

생성자 개요

RequiredModelMBean ()
비어있는 ModelMBeanInfo 으로 RequiredModelMBean를 구축합니다.

RequiredModelMBean (ModelMBeanInfo mbi)
건네받은 ModelMBeanInfo을 사용해 RequiredModelMBean 객체를 구축합니다.

메서드 개요

void	addAttributeChangeNotificationListener (NotificationListener inlistener, String inAttributeName, Object inhandback) NotificationListener 인터페이스를 구현하는 객체를 리스너로서 등록합니다.
void	addNotificationListener (NotificationListener listener, NotificationFilter filter, Object handback) NotificationListener 인터페이스를 구현하는 객체를 리스너로서 등록합니다.
Object	getAttribute (String attrName) 이 ModelMBean에 정의된 특정의 속성의 값을 리턴합니다.
AttributeList	getAttributes (String [] attrNames) ModelMBean 내의 복수의 속성의 값을 리턴합니다.
protected ClassLoaderRepository	getClassLoaderRepository () 클래스의 로드에 사용된 클래스 로더 리포지터리(repository)를 리턴합니다.
MBeanInfo	getMBeanInfo () 이 RequiredModelMBean가 관리용으로서 공개하는 속성, 오퍼레이션, 생성자 및 통지를 리턴합니다.
MBeanNotificationInfo []	getNotificationInfo () RequiredModelMBean에 의해 생성된 Notification 배열을 리턴합니다.
Object	invoke (String opName, Object [] opArgs, String [] sig) RequiredModelMBean 로부터 메서드를 호출해, 그 실행 결과를 리턴합니다.
void	load () 이 MBean 인스턴스를 지속 스토어내의 MBean 용 데이터로 인스턴스화합니다.
void	postDeregister () MBean 서버로부터 등록 해제한뒤 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.
void	postRegister (Boolean registrationDone) MBean 서버에의 등록이 성공 또는 실패한뒤 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.
void	preDeregister () MBean 서버로부터 등록 해제하기 전에 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.
ObjectName	preRegister (MBeanServer server, ObjectName name) MBean 서버에 등록하기 전에 MBean에 필요한 오퍼레이션을 실행시킬 수가 있습니다.
void	removeAttributeChangeNotificationListener (NotificationListener inlistener, String inAttributeName) RequiredModelMBean 로부터 attributeChangeNotification 리스너를 삭제합니다.
void	removeNotificationListener (NotificationListener listener) RequiredModelMBean 로부터 Notification 리스너를 삭제합니다.
void	removeNotificationListener (NotificationListener listener, NotificationFilter filter, Object handback) 이 MBean 로부터 리스너를 삭제합니다.
void	sendAttributeChangeNotification (Attribute inOldVal, Attribute inNewVal) ModelMBean 상의 등록이 끝난 AttributeChangeNotification 리스너에게, 속성의 낡은 값과 새로운 값을 포함한 attributeChangeNotification를 송신합니다.
void	sendAttributeChangeNotification (AttributeChangeNotification ntfyObj) ModelMBean 상의 등록이 끝난 attributeChangeNotification 에 건네받는 attributeChangeNotification를 송신합니다.
void	sendNotification (Notification ntfyObj) ModelMBean 상의 등록이 끝난 Notification 리스너에게, jmx.modelmbean.generic 통지로서 건네받는 Notification를 송신합니다.
void	sendNotification (String ntfyText) ModelMBean 상의 등록이 끝난 Notification 리스너에게, 건네받는 텍스트 캐릭터 라인을 포함한 Notification를 송신합니다.
void	setAttribute (Attribute attribute) 지정의 ModelMBean 특정의 속성의 값을 설정합니다.
AttributeList	setAttributes (AttributeList attributes) 이 ModelMBean 속성의 배열의 값을 설정합니다.
void	setManagedResource (Object mr, String mr_type) 객체의 인스턴스 핸들을 설정합니다.
void	setModelMBeanInfo (ModelMBeanInfo mbi) ModelMBeanInfo를 사용해 ModelMBean 객체를 초기화합니다.
void	store () 이 MBean 인스턴스의 현재 상태를 수중에 넣어, 지속 스토어에 써냅니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

생성자 상세

RequiredModelMBean

public RequiredModelMBean()
                   throws MBeanException,

                          RuntimeOperationsException 

비어있는 ModelMBeanInfo 으로 RequiredModelMBean를 구축합니다.

RequiredModelMBean MBeanInfo 및 Descriptor 은, setModelMBeanInfo(javax.management.modelmbean.ModelMBeanInfo) 메서드로 커스터마이즈 할 수 있습니다. RequiredModelMBean MBeanInfo 및 Descriptor 커스터마이즈 후, RequiredModelMBean를 MBeanServer에 등록할 수 있습니다 .

예외:

MBeanException - 배값이 끝난 통신 Exception을 랩 한다

RuntimeOperationsException - 객체의 구축시에 RuntimeException를 랩 한다

RequiredModelMBean

public RequiredModelMBean(ModelMBeanInfo  mbi)
                   throws MBeanException,

                          RuntimeOperationsException 

건네받은 ModelMBeanInfo을 사용해 RequiredModelMBean 객체를 구축합니다. RequiredModelMBean가 아직 MBeanServer에 등록되지 않은 경우에 한정해, setModelMBeanInfo(javax.management.modelmbean.ModelMBeanInfo) 메서드를 사용해 RequiredModelMBean MBeanInfo 및 Descriptor를 커스터마이즈 할 수 있습니다. RequiredModelMBean MBeanInfo 및 Descriptor 커스터마이즈 후, RequiredModelMBean를 MBeanServer에 등록할 수 있습니다 .

파라미터:

mbi - RequiredModelMBean에 의해 사용되는 ModelMBeanInfo 객체. 지정된 ModelMBeanInfo 가setModelMBeanInfo(javax.management.modelmbean.ModelMBeanInfo) 지정에 따라 복제되어 변경된다

예외:

MBeanException - 배값이 끝난 통신 Exception을 랩 한다

RuntimeOperationsException - {link java.lang.IllegalArgumentException}을 랩 한다. 파라미터에게 건네지는 MBeanInfo가 null인 경우

메서드의 상세

setModelMBeanInfo

public void setModelMBeanInfo(ModelMBeanInfo  mbi)
                       throws MBeanException,

                              RuntimeOperationsException 

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

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

지정의 inModelMBeanInfo에 GENERIC 또는 ATTRIBUTE_CHANGE 통지 ModelMBeanNotificationInfo 가 포함되지 않는 경우, RequiredModelMBean 에의해 디폴트 ModelMBeanNotificationInfo 가 제공됩니다.

정의:

인터페이스 ModelMBean 내의 setModelMBeanInfo

파라미터:

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

예외:

MBeanException - 배값이 끝난 통신 Exception을 랩 한다

RuntimeOperationsException -

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

setManagedResource

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

                               RuntimeOperationsException,

                               InstanceNotFoundException,

                               InvalidTargetObjectTypeException 

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

정의:

인터페이스 ModelMBean 내의 setManagedResource

파라미터:

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

mr_type - 관리 대상의 자원의 참조의 형태.
ObjectReference, Handle, IOR, EJBHandle, 또는 RMIReference.
이 구현으로 지원 되는 것은 ObjectReference 마셔

예외:

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

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

InvalidTargetObjectTypeException - 관리 대상의 자원의 형태는 ObjectReference가 아니면 안된다

RuntimeOperationsException - 자원의 설정시에 RuntimeException를 랩 한다

load

public void load()
          throws MBeanException,

                 RuntimeOperationsException,

                 InstanceNotFoundException 

이 MBean 인스턴스를 지속 스토어내의 MBean 용 데이터로 인스턴스화합니다. 데이터로서 속성과 오퍼레이션의 값을 로드할 수 있습니다.

이 메서드는 이 인스턴스의 구축 또는 초기화시, MBean를 MBeanServer에 등록하기 전에 호출합니다.

이 클래스의 구현이 지속성을 지원 하지 않는 경우, ServiceNotFoundException를 감싸는 MBeanException을 발생시킵니다.

정의:

인터페이스 PersistentMBean 내의 load

예외:

MBeanException - 그 외의 예외를감싸는 경우, 또는 지속성이 지원 되지 않는 경우

RuntimeOperationsException - 지속 도구 로부터의 예외를감싸는 경우

InstanceNotFoundException - 이 MBean가 발견되지 않는 경우, 또는 지속 스토리지로부터 로드할 수 없는 경우

store

public void store()
           throws MBeanException,

                  RuntimeOperationsException,

                  InstanceNotFoundException 

이 MBean 인스턴스의 현재 상태를 수중에 넣어, 지속 스토어에 써냅니다. 속성이나 오퍼레이션의 값이, 상태로서 포함되는 경우도 있습니다.

이 클래스의 구현이 지속성을 지원 하지 않는 경우, ServiceNotFoundException를 감싸는 MBeanException을 발생시킵니다.

MBean 지속성 정책 및 속성 기술자를 사용해, 이 메서드의 실행을 제어합니다. persistPolicy 필드가 다음의 내용이 되어 있는 경우, MBean는 포함됩니다.

  ! = "never" = "always" = "onTimer" and now > 'lastPersistTime' + 'persistPeriod' = "NoMoreOftenThan" and now > 'lastPersistTime' + 'persistPeriod' 

persistPolicy 필드가 다음의 내용이 되어 있는 경우, MBean는 포함되지 않습니다.

 = "never" = "onUpdate" = "onTimer" && now < 'lastPersistTime' + 'persistPeriod' 

정의:

인터페이스 PersistentMBean 내의 store

예외:

MBeanException - 그 외의 예외를감싸는 경우, 또는 지속성이 지원 되지 않는 경우

RuntimeOperationsException - 지속 도구 로부터의 예외를감싸는 경우

InstanceNotFoundException - 지속 스토어가 발견되지 않는 경우, 또는 액세스 할 수 없는 경우

getMBeanInfo

public MBeanInfo  getMBeanInfo()

이 RequiredModelMBean가 관리용으로서 공개하는 속성, 오퍼레이션, 생성자 및 통지를 리턴합니다.

정의:

인터페이스 DynamicMBean 내의 getMBeanInfo

반환값:

ModelMBeanInfo 인스턴스. 이 MBean 모든 속성, 오퍼레이션 및 통지의 취득을 허가한다

invoke

public Object  invoke(String  opName,
                     Object [] opArgs,
                     String [] sig)
              throws MBeanException,

                     ReflectionException 

RequiredModelMBean 로부터 메서드를 호출해, 그 실행 결과를 리턴합니다.

호출되는 메서드와 시그니쳐가 RequiredModelMbean 로부터 액세스 가능한 메서드의 어느 쪽인가에 일치하고 있는 경우, 이 메서드가 호출됩니다. 그 외의 경우, 관리 대상의 자원상에서 지정의 메서드의 호출이 시행됩니다.

오퍼레이션에 의해 리턴된 마지막 값은 ModelMBeanOperationInfo 기술자내의 오퍼레이션 기술자에게 캐쉬되는 일이 있습니다. 유효한 값이 존재하는 경우, value 필드내에 존재합니다. 값이 캐쉬될지 어떨지는 기술자내의 currencyTimeLimit 필드의 값에 의해 정해집니다.

• <0인 경우, 값은 무효로 캐쉬되지 않는다. 오퍼레이션 메서드가 불려 간다. value 필드와 lastUpdatedTimeStamp 필드는 클리어 된다
• =0인 경우, 값은 항상 유효해, 항상 캐쉬된다. value 필드가 리턴된다. value 필드가 존재하지 않는 경우, 속성용으로서 오퍼레이션 메서드가 불려 간다. lastUpdatedTimeStamp 필드와 value 필드에는 오퍼레이션의 반환값 및 현재의 타임 스탬프가 설정된다
• >0는 value 필드의 유효기간을 나타내는 초수. lastUpdatedTimeStamp + currencyTimeLimit > Now인 경우, value 필드는 무효가 된다
  • value가 유효한 경우, value가 리턴된다
  • value가 무효가 되었을 경우, 오퍼레이션 메서드가 불려 간다. lastUpdatedTimeStamp 필드 및 value 필드가 갱신된다

주: 이전의 버전의 사양과의 부정합이 있기 때문에 currencyTimeLimit에는 제로 아래의 값을 사용하지 않게의해 주세요. 캐쉬에 들어간 값이 유효하지 않은 것을 나타내고 싶은 경우는 currencyTimeLimit 필드를 생략 합니다. 이 값이 항상 유효한 것을 나타내고 싶은 경우는 이 필드에 매우 큰 값을 지정합니다.

정의:

인터페이스 DynamicMBean 내의 invoke

파라미터:

opName - 호출되는 메서드의 이름. 클래스명을 포함한 완전 수식 메서드명. 오퍼레이션 기술자의 class 필드에 클래스명이 정의되고 있는 경우는 메서드명만

opArgs - 오퍼레이션의 호출시로 설정되는 파라미터를 포함한 배열

sig - 오퍼레이션의 시그니쳐를 포함한 배열. 클래스 객체의 로드에는 오퍼레이션을 호출한 MBean를 로드할 때와 같은 클래스 로더가 사용된다

반환값:

메서드에 의해 리턴된 객체. 지정된 관리 대상의 자원상에서 메서드를 호출한 결과를 나타낸다

예외:

MBeanException - 다음의 몇개의 Exception을 랩 한다:

• 관리 대상 객체의 호출 메서드에 의해 Throw 된 Exception
• ServiceNotFoundException . ModelMBeanOperationInfo가 존재하지 않는 경우, 지정의 오퍼레이션의 기술자가 정의되어 있지 않은 경우, 또는 관리 대상의 자원이 null인 경우
• InvalidTargetObjectTypeException . targetType 필드의 값이 objectReference가 아닌 경우

ReflectionException - 메서드의 호출시에 발생되는 Exception를 랩 한다

RuntimeOperationsException - IllegalArgumentException를 랩 한다. 메서드명이 null인 경우

getAttribute

public Object  getAttribute(String  attrName)
                    throws AttributeNotFoundException,

                           MBeanException,

                           ReflectionException 

이 ModelMBean에 정의된 특정의 속성의 값을 리턴합니다. 속성에 의해 리턴된 마지막 값은 속성의 기술자내에 캐쉬되는 일이 있습니다. 유효한 값이 존재하는 경우, value 필드내에 존재합니다. 값이 캐쉬될지 어떨지는 기술자내의 currencyTimeLimit 필드의 값에 의해 정해집니다.

• <0인 경우, 값은 무효로 캐쉬되지 않는다. 속성에 대해서 취득 메서드가 불려 간다. value 필드와 lastUpdatedTimeStamp 필드는 클리어 된다
• =0인 경우, 값은 항상 유효해, 항상 캐쉬된다. value 필드가 리턴된다. value 필드가 존재하지 않는 경우, 속성용으로서 취득 메서드가 불려 간다. lastUpdatedTimeStamp 필드와 value 필드에는 속성값 및 현재의 타임 스탬프가 설정된다
• >0는 value 필드의 유효기간을 나타내는 초수. lastUpdatedTimeStamp + currencyTimeLimit > Now인 경우, value 필드는 무효가 된다
  • value가 유효한 경우, value가 리턴된다
  • value가 무효가 되었을 경우, 속성에 대해서 취득 메서드가 불려 간다. lastUpdatedTimeStamp 필드 및 value 필드가 갱신된다

주: 이전의 버전의 사양과의 부정합이 있기 때문에 currencyTimeLimit에는 제로 아래의 값을 사용하지 않게의해 주세요. 캐쉬에 들어간 값이 유효하지 않은 것을 나타내고 싶은 경우는 currencyTimeLimit 필드를 생략 합니다. 이 값이 항상 유효한 것을 나타내고 싶은 경우는 이 필드에 매우 큰 값을 지정합니다.

getMethod 필드에 유효한 오퍼레이션 기술자의 이름이 포함되는 경우, 이 오퍼레이션 기술자에 의해 기술된 메서드가 실행됩니다. 메서드는 응답으로서 속성값을 리턴합니다. 오퍼레이션이 실패했을 경우, 또는 반환값의 형태가 속성의 형태와 다르고 있는 경우, 예외가 발생 됩니다. getMethod 필드가 정의되어 있지 않은 경우, 속성의 기본값이 리턴됩니다 . 이 구현으로 getMethod를 호출할 필요가 있는 경우는 호출이 정상적으로 행해지도록, 이 getMethod에 대해서 오퍼레이션을 지정할 필요가 있습니다. 이것은 메서드가 표준의 호출 메서드로부터 불려가 operationInfo가 필요하게 되기 때문입니다.

정의:

인터페이스 DynamicMBean 내의 getAttribute

파라미터:

attrName - 취득되는 속성의 이름을 지정하는 String. ModelMBeanAttributeInfo 이름에 일치하고 있을 필요가 있다

반환값:

기술자의 value 필드로부터 취득한 속성의 값. 또는 기술자의 getMethod 필드내의 오퍼레이션의 호출에 의해 취득한 속성의 값

예외:

AttributeNotFoundException - 지정의 속성이 MBean에 액세스 할 수 없는 경우. 다음의 경우, AttributeNotFoundException가 Throw 될 가능성이 있다

• ModelMBean ModelMBeanInfo가 발견되지 않는 경우
• 지정의 속성명의 ModelMBeanAttributeInfo가 발견되지 않는 경우
• ModelMBeanAttributeInfo isReadable 메서드의 반환값이 false인 경우

MBeanException - 다음의 몇개의 Exception을 랩 한다:

• InvalidAttributeValueException . 속성의 취득 메서드로부터 받은 값의 형태가 부정한 경우, 또는 속성의 기술자내에 getMethod 필드가 정의되지 않고, 기본값이 존재하지 않는 경우
• ServiceNotFoundException . 속성의 취득 메서드에 대해서 ModelMBeanOperationInfo가 정의되어 있지 않은 경우, ModelMBeanOperationInfo에 기술자가 관련지을 수 있지 않은 경우, 또는 관리 대상의 자원이 null인 경우
• InvalidTargetObjectTypeException . targetType 필드의 값이 objectReference가 아닌 경우
• 관리 대상 객체의 취득 메서드에 의해 Throw 된 Exception

ReflectionException - 취득 메서드의 호출시에 발생되는 Exception를 랩 한다

RuntimeOperationsException - IllegalArgumentException를 랩 한다. 파라미터내의 속성명이 null인 경우

관련 항목:

setAttribute(javax.management.Attribute)

getAttributes

public AttributeList  getAttributes(String [] attrNames)

ModelMBean 내의 복수의 속성의 값을 리턴합니다. 건네받는 attrNames 배열내의 속성명 마다 getAttribute를 실행합니다.

정의:

인터페이스 DynamicMBean 내의 getAttributes

파라미터:

attrNames - 취득되는 속성의 이름에서 완성되는 String 배열

반환값:

취득되는 속성의 배열

예외:

RuntimeOperationsException - IllegalArgumentException를 랩 한다. 파라미터내의 객체명이 null인 경우, 또는 파라미터내의 속성이 null인 경우

관련 항목:

setAttributes(javax.management.AttributeList)

setAttribute

public void setAttribute(Attribute  attribute)
                  throws AttributeNotFoundException,

                         InvalidAttributeValueException,

                         MBeanException,

                         ReflectionException 

지정의 ModelMBean 특정의 속성의 값을 설정합니다. 속성의 기술자의 setMethod 필드에 유효한 오퍼레이션 기술자의 이름이 포함되는 경우, 이 오퍼레이션 기술자에 의해 기술된 메서드가 실행됩니다. 이 구현에서는 setMethod를 정상적으로 동작시키기 때문에 오퍼레이션 기술자를 올바르게 지정해, modelMBeanInfo에 할당할 필요가 있습니다. 메서드로부터의 응답 내용은 기술자내의 속성의 값으로 해서 설정됩니다.

currencyTimeLimit가 > 0인 경우, 속성의 새로운 값이 속성 기술자의 value 필드에 캐쉬되어 lastUpdatedTimeStamp 필드에 현재의 타임 스탬프가 설정됩니다.

속성의 기술자의 지속 필드가 null 이외의 경우, 지속 스토어내에 속성을 포함하기 위해, 속성 기술자의 Persistance 정책가 사용됩니다.
persistPolicy 필드가 다음의 내용이 되어 있는 경우, MBean가 포함됩니다.

• ! = "never"
• = "always"
• = "onUpdate"
• = "onTimer" 및 now > 'lastPersistTime' + 'persistPeriod'
• = "NoMoreOftenThan" 및 now > 'lastPersistTime' + 'persistPeriod'

persistPolicy 필드가 다음의 내용이 되어 있는 경우, MBean는 포함되지 않습니다.

• ! = "never"
• = "onTimer" && now < 'lastPersistTime' + 'persistPeriod'
• = "NoMoreOftenThan" 및 now < 'lastPersistTime' + 'persistPeriod'

Model MBean ModelMBeanInfo는 파일에 포함됩니다.

정의:

인터페이스 DynamicMBean 내의 setAttribute

파라미터:

attribute - 설정되는 속성의 이름과 설정치를 포함한 Attribute 인스턴스

예외:

AttributeNotFoundException - 지정의 속성이 MBean에 액세스 할 수 없는 경우.
다음의 경우, AttributeNotFoundException가 Throw 될 가능성이 있다

• 지정의 속성의 ModelMBeanAttributeInfo가 발견되지 않는 경우
• ModelMBeanAttributeInfo isWritable 메서드의 반환값이 false인 경우

InvalidAttributeValueException - 지정의 속성에 기술자가 정의되어 있지 않은 경우

MBeanException - 다음의 몇개의 Exception을 랩 한다:

• 관리 대상 객체의 설정 메서드에 의해 Throw 된 Exception
• ServiceNotFoundException . 속성의 기술자에게 setMethod 필드가 정의되어 있지 않은지, 관리 대상의 자원이 null인 경우
• InvalidTargetObjectTypeException . targetType 필드의 값이 objectReference가 아닌 경우
• 관리 대상 객체의 취득 메서드에 의해 Throw 된 Exception

ReflectionException - 설정 메서드의 호출시에 발생되는 Exception를 랩 한다

RuntimeOperationsException - IllegalArgumentException를 랩 한다. 파라미터내의 속성이 null인 경우

관련 항목:

getAttribute(java.lang.String)

setAttributes

public AttributeList  setAttributes(AttributeList  attributes)

이 ModelMBean 속성의 배열의 값을 설정합니다. 리스트내의 각 속성에 대해서 setAttribute() 메서드를 실행합니다.

정의:

인터페이스 DynamicMBean 내의 setAttributes

파라미터:

attributes - 속성의 리스트 (설정되는 속성의 ID와 설정되는 값)

반환값:

Attribute 인스턴스내의 새로운 값으로 설정된 속성의 배열

예외:

RuntimeOperationsException - IllegalArgumentException를 랩 한다. 파라미터내의 객체명이 null인 경우, 또는 파라미터내의 속성이 null인 경우

관련 항목:

getAttributes(java.lang.String[])

addNotificationListener

public void addNotificationListener(NotificationListener  listener,
                                    NotificationFilter  filter,
                                    Object  handback)
                             throws IllegalArgumentException 

NotificationListener 인터페이스를 구현하는 객체를 리스너로서 등록합니다. ModelMBean에 의해 임의의 통지가 발행되면, 이 객체의 handleNotification() 메서드가 호출됩니다. attributeChangeNotification는 포함하지 않습니다. 이것들은 개별적으로 등록할 필요가 있습니다.

정의:

인터페이스 NotificationBroadcaster 내의 addNotificationListener

파라미터:

listener - 등록이 끝난 MBean가 발행한 통지를 처리하는 리스너 객체

filter - 필터 객체. null인 경우, 통지 처리전에 필터는 적용되지 않는

handback - 통지가 발행되었을 때 통지와 함께 리스너에게 송신되는 컨텍스트

예외:

IllegalArgumentException - 리스너는 null 로 할 수 없는

관련 항목:

removeNotificationListener(javax.management.NotificationListener)

removeNotificationListener

public void removeNotificationListener(NotificationListener  listener)
                                throws ListenerNotFoundException 

RequiredModelMBean 로부터 Notification 리스너를 삭제합니다.

정의:

인터페이스 NotificationBroadcaster 내의 removeNotificationListener

파라미터:

listener - 등록이 끝난 MBean가 발행한 통지를 처리하고 있던 리스너의 이름. 이 메서드는 이 리스너에 관한 모든 정보를 삭제한다

예외:

ListenerNotFoundException - 리스너가 MBean에 등록되지 않은지, null인 경우

관련 항목:

addNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)

removeNotificationListener

public void removeNotificationListener(NotificationListener  listener,
                                       NotificationFilter  filter,
                                       Object  handback)
                                throws ListenerNotFoundException 

인터페이스 NotificationEmitter 기술:

이 MBean 로부터 리스너를 삭제합니다. MBean는 지정된 listener, filter 및 handback 파라미터와 정확하게 일치하는 리스너를 가지고 있을 필요가 있습니다. 해당하는 리스너가 복수 존재하는 경우, 그 중의 1개 만이 삭제됩니다.

삭제되는 리스너내에서 null이 가리키는 경우, filter 및 handback 파라미터는 null이 됩니다.

정의:

인터페이스 NotificationEmitter 내의 removeNotificationListener

파라미터:

listener - 이전에 이 MBean에 추가된 리스너

filter - 리스너의 추가시로 지정된 필터

handback - 리스너의 추가시로 지정된 핸드백

예외:

ListenerNotFoundException - 리스너가 MBean에 등록되지 않은 경우, 또는 지정된 필터 및 핸드백으로 등록되지 않은 경우

sendNotification

public void sendNotification(Notification  ntfyObj)
                      throws MBeanException,

                             RuntimeOperationsException 

인터페이스 ModelMBeanNotificationBroadcaster 기술:

ModelMBean 상의 등록이 끝난 Notification 리스너에게, jmx.modelmbean.generic 통지로서 건네받는 Notification를 송신합니다.

정의:

인터페이스 ModelMBeanNotificationBroadcaster 내의 sendNotification

파라미터:

ntfyObj - 리스너 객체의 handleNotification 메서드에게 건네지는 통지

예외:

MBeanException - 배값이 끝난 통신 Exception을 랩 한다

RuntimeOperationsException - IllegalArgumentException을 랩 한다. 파라미터로서 건네받은 Notification 객체가 null인 경우

sendNotification

public void sendNotification(String  ntfyText)
                      throws MBeanException,

                             RuntimeOperationsException 

인터페이스 ModelMBeanNotificationBroadcaster 기술:

ModelMBean 상의 등록이 끝난 Notification 리스너에게, 건네받는 텍스트 캐릭터 라인을 포함한 Notification를 송신합니다.

정의:

인터페이스 ModelMBeanNotificationBroadcaster 내의 sendNotification

파라미터:

ntfyText - Notification 로 지정되어 리스너 객체의 handleNotification 메서드에게 건네지는 텍스트. 구축 끝난 Notification는 type "jmx.modelmbean.generic" source this ModelMBean instance sequence 1

예외:

MBeanException - 배값이 끝난 통신 Exception을 랩 한다

RuntimeOperationsException - IllegalArgumentException을 랩 한다. 파라미터로서 건네받은 Notification 텍스트 캐릭터 라인이 null인 경우

getNotificationInfo

public MBeanNotificationInfo [] getNotificationInfo()

RequiredModelMBean에 의해 생성된 Notification 배열을 리턴합니다.

RequiredModelMBean는 2개의 추가 통지를 송신하는 경우가 있습니다.

• 1개는 기술자"name=GENERIC, descriptorType=notification, log=T, severity=6, displayName=jmx.modelmbean.generic"를 가지는 통지
• 이제(이미 ) 1개는 기술자 "name=ATTRIBUTE_CHANGE, descriptorType=notification, log=T, severity=6, displayName=jmx.attribute.change"를 가지는 표준 속성 변경 통지

이러한 2개의 통지는 어플리케이션에 의해 지정된 통지에 항상 추가됩니다.

정의:

인터페이스 NotificationBroadcaster 내의 getNotificationInfo

반환값:

MBeanNotificationInfo[]

addAttributeChangeNotificationListener

public void addAttributeChangeNotificationListener(NotificationListener  inlistener,
                                                   String  inAttributeName,
                                                   Object  inhandback)
                                            throws MBeanException,

                                                   RuntimeOperationsException,

                                                   IllegalArgumentException 

인터페이스 ModelMBeanNotificationBroadcaster 기술:

NotificationListener 인터페이스를 구현하는 객체를 리스너로서 등록합니다. ModelMBean에 의해 임의의 attributeChangeNotification가 발행되면, 이 객체의 handleNotification() 메서드가 호출됩니다. 그 외의 Notification는 포함하지 않습니다. 그 외의 Notification는 개별적으로 등록할 필요가 있습니다. 이 attributeName용의 AttributeChangeNotification가 생성됩니다.

정의:

인터페이스 ModelMBeanNotificationBroadcaster 내의 addAttributeChangeNotificationListener

파라미터:

inlistener - 등록이 끝난 MBean가 발행한 통지를 처리하는 리스너 객체

inAttributeName - ModelMBean 속성의 이름. 이 속성의 변경 통지를 수신한다. null인 경우, 어느 속성이 변경되었을 때도 attributeChangeNotification가 발행되는

inhandback - 통지가 발행되었을 때 통지와 함께 리스너에게 송신되는 컨텍스트

예외:

MBeanException - 배값이 끝난 통신 Exception을 랩 한다

RuntimeOperationsException - IllegalArgumentException을 랩 한다. 파라미터로서 건네받는 속성명이 존재하지 않는 경우

IllegalArgumentException - 리스너는 null 로 할 수 없는

관련 항목:

ModelMBeanNotificationBroadcaster.removeAttributeChangeNotificationListener(javax.management.NotificationListener, java.lang.String)

removeAttributeChangeNotificationListener

public void removeAttributeChangeNotificationListener(NotificationListener  inlistener,
                                                      String  inAttributeName)
                                               throws MBeanException,

                                                      RuntimeOperationsException,

                                                      ListenerNotFoundException 

인터페이스 ModelMBeanNotificationBroadcaster 기술:

RequiredModelMBean 로부터 attributeChangeNotification 리스너를 삭제합니다.

정의:

인터페이스 ModelMBeanNotificationBroadcaster 내의 removeAttributeChangeNotificationListener

파라미터:

inlistener - 등록이 끝난 MBean가 발행한 통지를 처리하고 있던 리스너의 이름. 이 메서드는 이 리스너에 관한 모든 정보를 삭제하는

inAttributeName - 속성. 리스너는 이 속성의 attributeChangeNotification를 수신할 필요가 없어졌다. null인 경우, 모든 attributeChangeNotification 리스너가 삭제된다

예외:

MBeanException - 배값이 끝난 통신 Exception을 랩 한다

RuntimeOperationsException - IllegalArgumentException을 랩 한다. inAttributeName 파라미터가 속성명에 일치하지 않는 경우

ListenerNotFoundException - 리스너가 MBean에 등록되지 않은지, null인 경우

관련 항목:

ModelMBeanNotificationBroadcaster.addAttributeChangeNotificationListener(javax.management.NotificationListener, java.lang.String, java.lang.Object)

sendAttributeChangeNotification

public void sendAttributeChangeNotification(AttributeChangeNotification  ntfyObj)
                                     throws MBeanException,

                                            RuntimeOperationsException 

인터페이스 ModelMBeanNotificationBroadcaster 기술:

ModelMBean 상의 등록이 끝난 attributeChangeNotification 에 건네받는 attributeChangeNotification를 송신합니다.

정의:

인터페이스 ModelMBeanNotificationBroadcaster 내의 sendAttributeChangeNotification

파라미터:

ntfyObj - 리스너 객체의 handleNotification 메서드에게 건네지는 통지

예외:

MBeanException - 배값이 끝난 통신 Exception을 랩 한다

RuntimeOperationsException - IllegalArgumentException을 랩 한다. 파라미터로서 건네받은 AttributeChangeNotification 객체가 null인 경우

sendAttributeChangeNotification

public void sendAttributeChangeNotification(Attribute  inOldVal,
                                            Attribute  inNewVal)
                                     throws MBeanException,

                                            RuntimeOperationsException 

인터페이스 ModelMBeanNotificationBroadcaster 기술:

ModelMBean 상의 등록이 끝난 AttributeChangeNotification 리스너에게, 속성의 낡은 값과 새로운 값을 포함한 attributeChangeNotification를 송신합니다.

정의:

인터페이스 ModelMBeanNotificationBroadcaster 내의 sendAttributeChangeNotification

파라미터:

inOldVal - Attribute 초기값

inNewVal - Attribute 현재의 값

   구축 끝난 attributeChangeNotification. type        "jmx.attribute.change" source      this ModelMBean instance sequence    1 attributeName oldValue.getName() attributeType oldValue's class attributeOldValue oldValue.getValue() attributeNewValue newValue.getValue() 

예외:

MBeanException - 배값이 끝난 통신 Exception을 랩 한다

RuntimeOperationsException - IllegalArgumentException을 랩 한다. 파라미터로서 건네받는 Attribute 객체가 null 인 경우, 또는 파라미터에 같은 이름의 Attribute 객체가 복수 지정되었을 경우

getClassLoaderRepository

protected ClassLoaderRepository  getClassLoaderRepository()

클래스의 로드에 사용된 클래스 로더 리포지터리(repository)를 리턴합니다. 서브 클래스는 이 객체내에서 사용하는 적절한 ClassLoaderRepository를 돌려주기 때문에 이 메서드를 재정의할 수 있습니다 .

반환값:

클래스 로더 리포지터리(repository)

preRegister

public ObjectName  preRegister(MBeanServer  server,
                              ObjectName  name)
                       throws Exception 

MBean 서버에 등록하기 전에 MBean에 필요한 오퍼레이션을 실행시킬 수가 있습니다. MBean 이름을 지정하지 않으면 MBean 에의해 등록용의 이름이 제공됩니다. 예외가 Throw 되었을 경우, MBean는 MBean 서버에 등록되지 않습니다.

RequireModelMBean가 실행시에 적절히 기능하도록, 이 메서드를 overload 또는 오버라이드(override) 하는 RequiredModelMBean 서브 클래스는 고유의 preRegister 구현내의 super.preRegister(server, name)를 호출할 필요가 있습니다.

정의:

인터페이스 MBeanRegistration 내의 preRegister

파라미터:

server - MBean 서버. MBean는 여기에 등록되는

name - MBean 객체명. MBeanServer 인터페이스내의 createMBean 또는 registerMBean 메서드의 name 파라미터가 null인 경우, 이 이름도 null이 된다. 이 경우 이 메서드는 새로운 MBean 용으로서 null 이외의 ObjectName를 돌려준다

반환값:

MBean 등록명. null은 지정할 수 없다. name 파라미터의 값이 null 이외의 경우, 일반적으로 값이 돌려주고지지만, 이것은 필수는 아니다

예외:

Exception - 이 예외는 MBean 서버에 캐치 되어MBeanRegistrationException 로서 재Throw 된다

postRegister

public void postRegister(Boolean  registrationDone)

MBean 서버에의 등록이 성공 또는 실패한뒤 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.

RequireModelMBean가 실행시에 적절히 기능하도록, 이 메서드를 overload 또는 오버라이드(override) 하는 RequiredModelMBean 서브 클래스는 고유의 postRegister 구현내의 super.postRegister(registrationDone)를 호출할 필요가 있습니다.

정의:

인터페이스 MBeanRegistration 내의 postRegister

파라미터:

registrationDone - MBean가 MBean 서버에 정상적으로 등록되었는지 어떠했는지를 나타낸다. 등록에 실패했을 경우의 값은 false

preDeregister

public void preDeregister()
                   throws Exception 

MBean 서버로부터 등록 해제하기 전에 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.

RequireModelMBean가 실행시에 적절히 기능하도록, 이 메서드를 overload 또는 오버라이드(override) 하는 RequiredModelMBean 서브 클래스는 고유의 preDeregister 구현내의 super.preDeregister()를 호출할 필요가 있습니다.

정의:

인터페이스 MBeanRegistration 내의 preDeregister

예외:

Exception - 이 예외는 MBean 서버에 캐치 되어MBeanRegistrationException 로서 재Throw 된다

postDeregister

public void postDeregister()

MBean 서버로부터 등록 해제한뒤 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.

RequireModelMBean가 실행시에 적절히 기능하도록, 이 메서드를 overload 또는 오버라이드(override) 하는 RequiredModelMBean 서브 클래스는 고유의 postDeregister 구현내의 super.postDeregister()를 호출할 필요가 있습니다.

정의:

인터페이스 MBeanRegistration 내의 postDeregister