javax.management
클래스 NotificationBroadcasterSupport

java.lang.Object 
  javax.management.NotificationBroadcasterSupport

모든 구현된 인터페이스:

NotificationBroadcaster, NotificationEmitter

알려진 직계 서브 클래스:

JMXConnectorServer, Monitor, RelationService, Timer

public class NotificationBroadcasterSupport
extends Object 
implements NotificationEmitter 

NotificationEmitter 인터페이스의 구현을 제공합니다. 이것은 통지를 송신하는 MBean 슈퍼 클래스로서 사용 가능합니다.

통지 디스패치모델이 동기 모델일까 비동기 모델일까는 지정되지 않습니다. thread가 sendNotification를 호출했을 때, 각 리스너의 NotificationListener.handleNotification 메서드가 그 thread내에서 불려가 면 동기 모델, 다른 thread내에서 불려가 면 비동기 모델이라는 것이 됩니다.

어플리케이션은 통지 디스패값이 동기 또는 비동기일까에 존해 되지 않습니다.

• 어플리케이션은 동기 모델을 상정할 수 없다. sendNotification 메서드의 종료시까지, 모든 리스너의 handleNotification 메서드가 호출되는 것은 아니다. 또, 리스너는 통지가 생성된 순서에 수신한다고는 할 수 없다. 차례로 의존된 리스너는 통지 순서 번호를 사용해, 수신한 통지의 줄 순서를 확인하는 (Notification.getSequenceNumber()를 참조)
• 어플리케이션은 비동기 모델을 상정하지 않는다. 액션을 신속하게 실행할 수 없다고 판단했을 경우, 리스너는 그 외의 리스너나 sendNotification 호출해 원래로의 응답의 지연을 회피하기 위해, 다른 thread로 액션을 실행한다

도입된 버전 :

1.5

생성자 개요

NotificationBroadcasterSupport ()

메서드 개요

void	addNotificationListener (NotificationListener listener, NotificationFilter filter, Object handback) 리스너를 추가합니다.
MBeanNotificationInfo []	getNotificationInfo () 이 MBean가 통지를 송신할 때마다, 그 통지의 Java 클래스명과 통지형을 나타내는 배열을 리턴합니다.
protected void	handleNotification (NotificationListener listener, Notification notif, Object handback) 이 메서드는 리스너에게 통지를 송신하기 위해, sendNotification 에 의해 호출합니다.
void	removeNotificationListener (NotificationListener listener) 이 MBean 로부터 리스너를 삭제합니다.
void	removeNotificationListener (NotificationListener listener, NotificationFilter filter, Object handback) 이 MBean 로부터 리스너를 삭제합니다.
void	sendNotification (Notification notification) 통지를 송신합니다.

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

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

생성자 상세

NotificationBroadcasterSupport

public NotificationBroadcasterSupport()

메서드의 상세

addNotificationListener

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

리스너를 추가합니다.

정의:

인터페이스 NotificationBroadcaster 내의 addNotificationListener

파라미터:

listener - 통지를 받는 리스너

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

handback - 통지의 발행시에 리스너에게 송신되는 불투명한 객체. Notification 브로드 캐스터 객체는 이 객체를 사용할 수 없다. 이 객체는 손보지 않는 상태로 통지와 함께 리스너에게 돌려 보내지지 않으면 안 된다

예외:

IllegalArgumentException - 리스너가 null인 경우

관련 항목:

removeNotificationListener(javax.management.NotificationListener)

removeNotificationListener

public void removeNotificationListener(NotificationListener  listener)
                                throws ListenerNotFoundException 

인터페이스 NotificationBroadcaster 기술:

이 MBean 로부터 리스너를 삭제합니다. 리스너가 다른 핸드백 객체 또는 통지 필터에 등록되어 있는 경우, 이 리스너에게 대응하는 모든 엔트리가 삭제됩니다.

정의:

인터페이스 NotificationBroadcaster 내의 removeNotificationListener

파라미터:

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

예외:

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

관련 항목:

NotificationBroadcaster.addNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object), NotificationEmitter.removeNotificationListener(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에 등록되지 않은 경우, 또는 지정된 필터 및 핸드백으로 등록되지 않은 경우

getNotificationInfo

public MBeanNotificationInfo [] getNotificationInfo()

인터페이스 NotificationBroadcaster 기술:

이 MBean가 통지를 송신할 때마다, 그 통지의 Java 클래스명과 통지형을 나타내는 배열을 리턴합니다.

MBean 가 이 배열에 기술되어 있지 않은 통지를 송신할 수 없습니다. 다만, 일부의 MBean 서버 클라이언트는 현재의 기능에 의해 완성하는 배열에 존하고 있는 경우가 있습니다.

정의:

인터페이스 NotificationBroadcaster 내의 getNotificationInfo

반환값:

통지의 배열

sendNotification

public void sendNotification(Notification  notification)

통지를 송신합니다.

파라미터:

notification - 송신하는 통지

handleNotification

protected void handleNotification(NotificationListener  listener,
                                  Notification  notif,
                                  Object  handback)

이 메서드는 리스너에게 통지를 송신하기 위해, sendNotification 에 의해 호출합니다. 통지의 전달 방법을 변경하고 싶은 경우, 예를 들어 통지를 다른 thread로 전달하고 싶은 경우 등은 서브 클래스내에서 오버라이드(override) 할 수 있습니다.

이 메서드는 sendNotification를 호출한 thread에 의해 불려 간다고는 할 수 없습니다.

이 메서드의 디폴트 구현은 아래와 동등합니다.

 listener.handleNotification(notif, handback);
 

파라미터:

listener - 통지의 전달처 리스너

notif - 리스너에게 전달되는 통지

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