javax.management.modelmbean
인터페이스 ModelMBeanNotificationBroadcaster

모든 슈퍼 인터페이스:

NotificationBroadcaster

알려진 서브 인터페이스 목록 :

ModelMBean

알려진 구현 클래스 목록:

RequiredModelMBean

public interface ModelMBeanNotificationBroadcaster
extends NotificationBroadcaster 

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	addAttributeChangeNotificationListener (NotificationListener listener, String attributeName, Object handback) NotificationListener 인터페이스를 구현하는 객체를 리스너로서 등록합니다.
void	removeAttributeChangeNotificationListener (NotificationListener listener, String attributeName) RequiredModelMBean 로부터 attributeChangeNotification 리스너를 삭제합니다.
void	sendAttributeChangeNotification (Attribute oldValue, Attribute newValue) ModelMBean 상의 등록이 끝난 AttributeChangeNotification 리스너에게, 속성의 낡은 값과 새로운 값을 포함한 attributeChangeNotification를 송신합니다.
void	sendAttributeChangeNotification (AttributeChangeNotification notification) ModelMBean 상의 등록이 끝난 attributeChangeNotification 에 건네받는 attributeChangeNotification를 송신합니다.
void	sendNotification (Notification ntfyObj) ModelMBean 상의 등록이 끝난 Notification 리스너에게, jmx.modelmbean.generic 통지로서 건네받는 Notification를 송신합니다.
void	sendNotification (String ntfyText) ModelMBean 상의 등록이 끝난 Notification 리스너에게, 건네받는 텍스트 캐릭터 라인을 포함한 Notification를 송신합니다.

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

addNotificationListener, getNotificationInfo, removeNotificationListener

메서드의 상세

sendNotification

void sendNotification(Notification  ntfyObj)
                      throws MBeanException,

                             RuntimeOperationsException 

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

파라미터:

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

예외:

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

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

sendNotification

void sendNotification(String  ntfyText)
                      throws MBeanException,

                             RuntimeOperationsException 

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

파라미터:

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

예외:

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

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

sendAttributeChangeNotification

void sendAttributeChangeNotification(AttributeChangeNotification  notification)
                                     throws MBeanException,

                                            RuntimeOperationsException 

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

파라미터:

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

예외:

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

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

sendAttributeChangeNotification

void sendAttributeChangeNotification(Attribute  oldValue,
                                     Attribute  newValue)
                                     throws MBeanException,

                                            RuntimeOperationsException 

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

파라미터:

oldValue - Attribute 초기값

newValue - 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 객체가 복수 지정되었을 경우

addAttributeChangeNotificationListener

void addAttributeChangeNotificationListener(NotificationListener  listener,
                                            String  attributeName,
                                            Object  handback)
                                            throws MBeanException,

                                                   RuntimeOperationsException,

                                                   IllegalArgumentException 

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

파라미터:

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

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

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

예외:

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

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

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

관련 항목:

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

removeAttributeChangeNotificationListener

void removeAttributeChangeNotificationListener(NotificationListener  listener,
                                               String  attributeName)
                                               throws MBeanException,

                                                      RuntimeOperationsException,

                                                      ListenerNotFoundException 

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

파라미터:

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

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

예외:

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

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

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

관련 항목:

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