javax.management.monitor
클래스 Monitor

java.lang.Object 
  javax.management.NotificationBroadcasterSupport 
      javax.management.monitor.Monitor

모든 구현된 인터페이스:

MBeanRegistration, MonitorMBean, NotificationBroadcaster, NotificationEmitter

알려진 직계 서브 클래스:

CounterMonitor, GaugeMonitor, StringMonitor

public abstract class Monitor
extends NotificationBroadcasterSupport 
implements MonitorMBean,
 MBeanRegistration 

모든 모니터 MBean 공통 부분을 정의합니다. 모니터 MBean는 감시 대상의 MBean 세트에 공통의 속성의 값을 감시합니다. 감시 대상의 속성은 입도 주기로서 지정된 간격으로 감시됩니다. 게이지치 (파생 게이지)는 감시 대상의 속성의 값으로부터 파생합니다.

도입된 버전 :

1.5

필드 개요

protected int	alreadyNotified 추천하지 않습니다. alreadyNotifieds [0] 으로 동등합니다.
protected int[]	alreadyNotifieds 이미 통지된 선택이 끝난 모니터 에러입니다.
protected static int	capacityIncrement 모니터 배열의 사이즈가 용량보다 커졌을 때 자동적으로 증가하는 용량입니다.
protected String	dbgTag 추천하지 않습니다. 대체는 없습니다.
protected int	elementCount 감시 대상의 객체의 벡터내의 유효한 컴퍼넌트의 수입니다.
protected static int	OBSERVED_ATTRIBUTE_ERROR_NOTIFIED 감시 대상의 속성의 변경 후, 통지가 발행된 것을 나타내는 플래그입니다.
protected static int	OBSERVED_ATTRIBUTE_TYPE_ERROR_NOTIFIED 감시 대상의 객체 또는 속성의 변경 후, 통지가 발행된 것을 나타내는 플래그입니다.
protected static int	OBSERVED_OBJECT_ERROR_NOTIFIED 감시 대상의 객체의 변경 후, 통지가 발행된 것을 나타내는 플래그입니다.
protected static int	RESET_FLAGS_ALREADY_NOTIFIED 이 플래그는 모니터 속성 alreadyNotifieds를 리셋 하기 위해서 사용됩니다.
protected static int	RUNTIME_ERROR_NOTIFIED 감시 대상의 객체 또는 속성의 변경 후, 통지가 발행된 것을 나타내는 플래그입니다.
protected MBeanServer	server MBean 서버상의 참조입니다.

생성자 개요

Monitor ()

메서드 개요

void	addObservedObject (ObjectName object) 감시 대상의 MBean 세트로 지정된 객체가 포함되지 않는 경우, 그 객체를 추가합니다.
boolean	containsObservedObject (ObjectName object) 감시 대상의 MBean 세트내로 지정된 객체가 포함될지 어떨지를 테스트합니다.
long	getGranularityPeriod () 입도의 주기를 밀리 세컨드 단위로 취득합니다.
String	getObservedAttribute () 감시 대상의 속성을 취득합니다.
ObjectName	getObservedObject () 추천하지 않습니다. JMX 1.2 에서는 getObservedObjects() 로 치환됩니다.
ObjectName []	getObservedObjects () 감시 대상의 객체를 포함한 배열을 리턴합니다.
boolean	isActive () 모니터 MBean가 활성화되었는가 어떤가를 테스트합니다.
void	postDeregister () MBean 서버로부터 등록 해제한뒤 모니터 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.
void	postRegister (Boolean registrationDone) MBean 서버에의 등록이 성공 또는 실패한뒤 모니터 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.
void	preDeregister () MBean 서버로부터 등록 해제하기 전에 모니터 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.
ObjectName	preRegister (MBeanServer server, ObjectName name) MBean 서버에 등록하기 전에 모니터 MBean가 필요한 오퍼레이션을 실행할 수 있도록 합니다.
void	removeObservedObject (ObjectName object) 감시 대상의 MBean 세트로부터 지정된 객체를 삭제합니다.
void	setGranularityPeriod (long period) 입도의 주기를 밀리 세컨드 단위로 설정합니다.
void	setObservedAttribute (String attribute) 감시 대상의 속성을 설정합니다.
void	setObservedObject (ObjectName object) 추천하지 않습니다. JMX 1.2 이후, addObservedObject(javax.management.ObjectName) 로 치환되고 있습니다.
abstract void	start () 모니터를 개시합니다.
abstract void	stop () 모니터를 정지합니다.

클래스 javax.management. NotificationBroadcasterSupport 로부터 상속된 메서드

addNotificationListener, getNotificationInfo, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification

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

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

필드의 상세

capacityIncrement

protected static final int capacityIncrement

모니터 배열의 사이즈가 용량보다 커졌을 때 자동적으로 증가하는 용량입니다.

관련 항목:

정수 필드값

elementCount

protected int elementCount

감시 대상의 객체의 벡터내의 유효한 컴퍼넌트의 수입니다.

alreadyNotified

@Deprecated 
protected int alreadyNotified

추천하지 않습니다. alreadyNotifieds [0] 으로 동등합니다.

이미 통지된 모니터 에러입니다.

alreadyNotifieds

protected int[] alreadyNotifieds

이미 통지된 선택이 끝난 모니터 에러입니다.

이 배열내의 각 요소는 벡터내의 감시 대상 객체에 대응하고 있습니다. OBSERVED_OBJECT_ERROR_NOTIFIED 플래그등의 비트 마스크를 포함해, 대응하는 통지가 이미 감시 대상의 MBean에 송신되었는지 어떠했는지를 나타냅니다.

server

protected MBeanServer  server

MBean 서버상의 참조입니다. 이 참조는 모니터 MBean가 MBean 서버에 등록되지 않은 경우 null이 됩니다. 모니터 MBean가 MBean에 등록되기 전에 초기화됩니다.

관련 항목:

preRegister(MBeanServer server, ObjectName name)

RESET_FLAGS_ALREADY_NOTIFIED

protected static final int RESET_FLAGS_ALREADY_NOTIFIED

이 플래그는 모니터 속성 alreadyNotifieds를 리셋 하기 위해서 사용됩니다.

관련 항목:

정수 필드값

OBSERVED_OBJECT_ERROR_NOTIFIED

protected static final int OBSERVED_OBJECT_ERROR_NOTIFIED

감시 대상의 객체의 변경 후, 통지가 발행된 것을 나타내는 플래그입니다. 이 플래그는 최초의 통지의 발행시에 MBean 서버에 새로운 감시 대상 객체가 등록된 것을 확인하기 위해서 사용됩니다.

관련 항목:

정수 필드값

OBSERVED_ATTRIBUTE_ERROR_NOTIFIED

protected static final int OBSERVED_ATTRIBUTE_ERROR_NOTIFIED

감시 대상의 속성의 변경 후, 통지가 발행된 것을 나타내는 플래그입니다. 이 플래그는 최초의 통지의 발행시에 새로운 감시 대상의 속성이 감시 대상의 객체에 소속하는 것을 확인하기 위해서 사용됩니다.

관련 항목:

정수 필드값

OBSERVED_ATTRIBUTE_TYPE_ERROR_NOTIFIED

protected static final int OBSERVED_ATTRIBUTE_TYPE_ERROR_NOTIFIED

감시 대상의 객체 또는 속성의 변경 후, 통지가 발행된 것을 나타내는 플래그입니다. 이 플래그는 최초의 통지의 발행시에 감시 대상의 속성의 형태가 올바른 (사용하는 모니터에 따라서 다르다) 것을 확인하기 위해서 사용됩니다.

관련 항목:

정수 필드값

RUNTIME_ERROR_NOTIFIED

protected static final int RUNTIME_ERROR_NOTIFIED

감시 대상의 객체 또는 속성의 변경 후, 통지가 발행된 것을 나타내는 플래그입니다. 이 플래그는 최초의 통지의 발행시에 감시 대상의 속성의 값을 취득하려고 했을 때, 예외가 있으면 통지하기 위해서 사용됩니다 (상기의 경우를 제외하다).

관련 항목:

정수 필드값

dbgTag

@Deprecated 
protected String  dbgTag

추천하지 않습니다. 대체는 없습니다.

이 필드는 호환성을 위해서 확보되고 있는 것만으로 참조할 수 없습니다.

생성자 상세

Monitor

public Monitor()

메서드의 상세

preRegister

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

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

MBean 서버의 참조를 초기화합니다.

정의:

인터페이스 MBeanRegistration 내의 preRegister

파라미터:

server - MBean 서버. 모니터 MBean는 이 MBean 서버에 등록되는

name - 모니터 MBean 객체명

반환값:

등록이 끝난 모니터 MBean 이름

예외:

Exception -

postRegister

public void postRegister(Boolean  registrationDone)

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

this 컨텍스트에 서는 사용하지 않습니다.

정의:

인터페이스 MBeanRegistration 내의 postRegister

파라미터:

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

preDeregister

public void preDeregister()
                   throws Exception 

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

모니터를 정지합니다.

정의:

인터페이스 MBeanRegistration 내의 preDeregister

예외:

Exception -

postDeregister

public void postDeregister()

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

this 컨텍스트에 서는 사용하지 않습니다.

정의:

인터페이스 MBeanRegistration 내의 postDeregister

start

public abstract void start()

모니터를 개시합니다.

정의:

인터페이스 MonitorMBean 내의 start

stop

public abstract void stop()

모니터를 정지합니다.

정의:

인터페이스 MonitorMBean 내의 stop

getObservedObject

@Deprecated 
public ObjectName  getObservedObject()

추천하지 않습니다. JMX 1.2 에서는 getObservedObjects() 로 치환됩니다.

감시 대상의 MBean 세트내의 최초의 객체의 객체명을 리턴합니다. 해당하는 객체가 존재하지 않는 경우, null을 리턴합니다.

정의:

인터페이스 MonitorMBean 내의 getObservedObject

반환값:

감시 대상의 객체

관련 항목:

setObservedObject(ObjectName)

setObservedObject

@Deprecated 
public void setObservedObject(ObjectName  object)
                       throws IllegalArgumentException 

추천하지 않습니다. JMX 1.2 이후, addObservedObject(javax.management.ObjectName) 로 치환되고 있습니다.

감시 대상의 객체세트로부터 모든 객체를 삭제해, 지정된 객체를 추가합니다.

정의:

인터페이스 MonitorMBean 내의 setObservedObject

파라미터:

object - 감시 대상의 객체

예외:

IllegalArgumentException - 지정된 객체가 null인 경우

관련 항목:

getObservedObject()

addObservedObject

public void addObservedObject(ObjectName  object)
                       throws IllegalArgumentException 

감시 대상의 MBean 세트로 지정된 객체가 포함되지 않는 경우, 그 객체를 추가합니다.

정의:

인터페이스 MonitorMBean 내의 addObservedObject

파라미터:

object - 감시 대상의 객체

예외:

IllegalArgumentException - 지정된 객체가 null인 경우

removeObservedObject

public void removeObservedObject(ObjectName  object)

감시 대상의 MBean 세트로부터 지정된 객체를 삭제합니다.

정의:

인터페이스 MonitorMBean 내의 removeObservedObject

파라미터:

object - 삭제하는 객체

containsObservedObject

public boolean containsObservedObject(ObjectName  object)

감시 대상의 MBean 세트내로 지정된 객체가 포함될지 어떨지를 테스트합니다.

정의:

인터페이스 MonitorMBean 내의 containsObservedObject

파라미터:

object - 체크 대상의 객체

반환값:

지정된 요소가 존재하는 경우는 true, 그렇지 않은 경우는 false

getObservedObjects

public ObjectName [] getObservedObjects()

감시 대상의 객체를 포함한 배열을 리턴합니다.

정의:

인터페이스 MonitorMBean 내의 getObservedObjects

반환값:

감시 대상의 객체

getObservedAttribute

public String  getObservedAttribute()

감시 대상의 속성을 취득합니다.
감시 대상의 속성은 디폴트에서는 초기화되지 않습니다 (null 로 설정된다).

정의:

인터페이스 MonitorMBean 내의 getObservedAttribute

반환값:

감시 대상의 속성

관련 항목:

setObservedAttribute(java.lang.String)

setObservedAttribute

public void setObservedAttribute(String  attribute)
                          throws IllegalArgumentException 

감시 대상의 속성을 설정합니다.
감시 대상의 속성은 디폴트에서는 초기화되지 않습니다 (null 로 설정된다).

정의:

인터페이스 MonitorMBean 내의 setObservedAttribute

파라미터:

attribute - 감시 대상의 속성

예외:

IllegalArgumentException - 지정된 속성이 null인 경우

관련 항목:

getObservedAttribute()

getGranularityPeriod

public long getGranularityPeriod()

입도의 주기를 밀리 세컨드 단위로 취득합니다.
디폴트의 입도 주기의 값은 10 초입니다.

정의:

인터페이스 MonitorMBean 내의 getGranularityPeriod

반환값:

입도 주기의 값

관련 항목:

setGranularityPeriod(long)

setGranularityPeriod

public void setGranularityPeriod(long period)
                          throws IllegalArgumentException 

입도의 주기를 밀리 세컨드 단위로 설정합니다.
디폴트의 입도 주기의 값은 10 초입니다.

정의:

인터페이스 MonitorMBean 내의 setGranularityPeriod

파라미터:

period - 입도 주기의 값

예외:

IllegalArgumentException - 입도 주기가 제로 아래의 경우

관련 항목:

getGranularityPeriod()

isActive

public boolean isActive()

모니터 MBean가 활성화되었는가 어떤가를 테스트합니다. 모니터 MBean는 start 메서드가 불려가 면 활성화 되어, stop 메서드가 불려가 면 비활성화 됩니다.

정의:

인터페이스 MonitorMBean 내의 isActive

반환값:

모니터 MBean가 활성화된 경우는 true, 그렇지 않은 경우는 false