javax.management (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

전의 패키지 다음의 패키지

프레임으로 프레임 없이

패키지 javax.management

Java Management Extensions 코어 클래스를 제공합니다.

참조처:
설명

인터페이스 개요
Descriptor	이 인터페이스는 JMX 요소의 동작의 메타데이타셋트를 나타냅니다.
DescriptorAccess	이 인터페이스는 JMX 컴퍼넌트에 관련된 Descriptor 클래스의 기술자 (MBean, MBeanInfo, MBeanAttributeInfo, MBeanNotificationInfo, MBeanOperationInfo, MBeanParameterInfo)에게 액세스 하는 목적으로 사용됩니다.
DynamicMBean	Dynamic MBean (동적 관리 인터페이스를 공개하는 MBean)에 구현하는 메서드를 정의합니다.
MBeanRegistration	MBean 서버에의 등록 또는 MBean 서버로부터의 등록 해제의 전후에 다양한 오퍼레이션을 실행하기 위해, MBean에 의해 구현됩니다.
MBeanServer	에이전트측에서 MBean를 조작하기 위한 인터페이스입니다.
MBeanServerConnection	이 인터페이스는 MBean 서버 (로컬 또는 리모트)와의 통신 방법을 나타냅니다.
MBeanServerDelegateMBean	MBeanServerDelegate 클래스의 객체의 관리 인터페이스를 정의합니다.
NotificationBroadcaster	Notification를 발행하는 MBean가 구현하고 있는 인터페이스.
NotificationEmitter	Notification를 발행하는 MBean가 구현하고 있는 인터페이스.
NotificationFilter	통지 필터로서 기능하는 모든 클래스에 의해 구현됩니다.
NotificationListener	통지의 수신을 희망하는 객체에 의해 구현될 필요가 있습니다.
PersistentMBean	이 클래스는 MBean에 의해 구현되는 인터페이스 (지속 인터페이스)입니다.
QueryExp	데이타베이스 쿼리 「where clauses」내에서 사용 가능한 관계 제약을 나타냅니다.
ValueExp	관계식의 인수로서 건네줄 수 있는 값을 나타냅니다.

클래스 개요
Attribute	이름과 값을 관련짓는 것으로 MBean 속성을 표현합니다.
AttributeChangeNotification	MBean에 의해 송신되는 속성 변경 통지를 정의합니다.
AttributeChangeNotificationFilter	이 클래스는 `속성 변경 통지` `NotificationFilter` 인터페이스를 구현합니다.
AttributeList	MBean 속성의 값의 리스트를 나타냅니다.
AttributeValueExp	관계 제약의 인수로서 사용되는 속성을 나타냅니다.
DefaultLoaderRepository	추천하지 않습니다. 대신에 `MBeanServer.getClassLoaderRepository()`를 사용해 주세요.
MBeanAttributeInfo	관리용으로서 공개되는 MBean 속성을 기술합니다.
MBeanConstructorInfo	MBean에 의해 공개되는 생성자를 기술합니다.
MBeanFeatureInfo	MBean 기술 객체에 일반 정보를 제공합니다.
MBeanInfo	MBean에 의해 공개된 관리 인터페이스 (관리 오퍼레이션에 사용할 수 있는 속성과 조작세트)를 기술합니다.
MBeanNotificationInfo	`MBeanNotificationInfo` 클래스는 MBean에 의해 발행된, 지정의 통지 Java 클래스에 대한 복수가 다른 통지 인스턴스의 특성을 기술합니다.
MBeanOperationInfo	MBean에 의해 공개되는 관리 오퍼레이션을 기술합니다.
MBeanParameterInfo	MBean에 의해 공개되는 오퍼레이션의 인수를 기술합니다.
MBeanPermission	MBeanServer 오퍼레이션의 액세스를 제어하는 접근 권한입니다.
MBeanServerBuilder	이 클래스는 디폴트 `MBeanServer` 구현을 작성하는 빌더를 나타냅니다.
MBeanServerDelegate	관리의 시점에서 MBean 서버를 표현합니다.
MBeanServerFactory	MBean 서버 참조를 제공합니다.
MBeanServerInvocationHandler	MBean 관리 인터페이스내에서 MBean 서버로부터 MBean에 메서드를 건네주는 `InvocationHandler` 입니다.
MBeanServerNotification	MBean 서버에의해 MBeanServerDelegate MBean 로부터 발행되는 통지를 나타냅니다.
MBeanServerPermission	MBeanServer 관련의 액션을 실행하기 위한 접근 권한.
MBeanTrustPermission	이 접근 권한은 서명자 또는 코드 베이스의 「trust」를 나타냅니다.
Notification	Notification 클래스는 MBean가 발행하는 통지를 나타냅니다.
NotificationBroadcasterSupport	`NotificationEmitter` 인터페이스의 구현을 제공합니다.
NotificationFilterSupport	`NotificationFilter` 인터페이스의 구현을 제공합니다.
ObjectInstance	MBean 객체명과 클래스명을 나타냅니다.
ObjectName	MBean 객체명, 또는 복수의 MBean 명에 일치하는 패턴을 나타냅니다.
Query	쿼리객체 제약을 구축합니다.
QueryEval	특정의 MBean 서버의 컨텍스트 으로 쿼리를 실행합니다.
StandardMBean	Java 인터페이스의 리플렉션에 의해 관리 인터페이스를 결정하는 MBean 입니다.
StringValueExp	관계 제약의 인수가 되는 캐릭터 라인을 나타냅니다.

예외 개요
AttributeNotFoundException	지정된 속성이 존재하지 않는지, 취득할 수 없습니다.
BadAttributeValueExpException	쿼리를 작성하는 메서드에 무효인 MBean 속성이 건네받았을 경우에 예외를 발생시킵니다.
BadBinaryOpValueExpException	쿼리를 작성하는 메서드에 무효인 식이 건네받았을 경우에 예외를 발생시킵니다.
BadStringOperationException	쿼리를 작성하는 메서드에 무효인 캐릭터 라인 오퍼레이션이 건네받았을 경우에 예외를 발생시킵니다.
InstanceAlreadyExistsException	MBean는 이미 레포지트리에 등록되어 있습니다.
InstanceNotFoundException	지정된 MBean가 리포지터리(repository)내에 존재하지 않습니다.
IntrospectionException	MBean 인트로스페크션의 실행시에 발생한 예외입니다.
InvalidApplicationException	MBean 서브 쿼리의 식 또는 MBean 수식 속성의 식의 클래스가 잘못되어 있는 경우에 예외를 발생시킵니다.
InvalidAttributeValueException	지정된 값은 속성에 대한 유효한 값이 아닙니다.
JMException	JMX 구현으로부터 발생되는 예외입니다.
JMRuntimeException	JMX 구현으로부터 리턴된 실행시 예외입니다.
ListenerNotFoundException	지정된 MBean 리스너가 리포지터리(repository)내에 존재하지 않습니다.
MalformedObjectNameException	캐릭터 라인의 형식이 유효한 ObjectName에 대응하고 있습니다.
MBeanException	에이전트내의 MBean 메서드에 의해 발생되는 사용자 정의의 예외를 나타냅니다.
MBeanRegistrationException	`MBeanRegistration` 인터페이스의 preRegister() 메서드와 preDeregister() 메서드에 의해 발생되는 예외를 랩 합니다.
NotCompliantMBeanException	MBean 서버에 JMX 준거의 MBean가 아닌 객체를 등록하려고 했을 경우에 발행되는 예외입니다.
OperationsException	MBean 오퍼레이션의 실행시에 MBean 서버내에서 발생되는 예외를 나타냅니다.
ReflectionException	java.lang.reflect 클래스를 사용해 MBean 상의 메서드를 호출할 때, MBean 서버내에서 발생되는 예외를 나타냅니다.
RuntimeErrorException	에이전트내에서 `java.lang.Error`가 발생했을 경우, 캐치 해, `RuntimeErrorException` 으로서 재Throw 할 필요가 있습니다.
RuntimeMBeanException	에이전트내의 MBean 메서드에 의해 발생되는 실행시 예외를 나타냅니다.
RuntimeOperationsException	MBean 로 오퍼레이션의 실행시에 에이전트내에서 발생되는 실행시 예외를 나타냅니다.
ServiceNotFoundException	요구된 서비스가 지원 되어 있지 않은 경우에 발행되는 예외를 나타냅니다.

패키지 javax.management 설명

Java Management Extensions 코어 클래스를 제공합니다.

Java Management Extensions (JMX^TM) API는 관리 및 감시용의 표준 API 입니다. 일반적으로 다음의 용도로 사용됩니다.

어플리케이션의 구성의 참조 및 변경

어플리케이션의 동작에 관한 통계 정보의 축적 및 유효화

상태의 변화와 에러 조건의 통지

JMX API는 시스템이나 네트워크의 관리 솔루션에도 사용됩니다.

remote administration 프로그램은 JMX API 원격 접근 기능을 이용해, 실행중의 어플리케이션에 원격 접근 할 수 있습니다.

MBean

JMX API 기본 개념, 「MBean」는 자원을 나타내는 이름 첨부의 관리 객체입니다. 다음과 같은 관리 인터페이스를 가집니다.

독해나 출력이 가능한 이름과 형태의 지정된 속성
호출해 가능한 이름과 형태의 지정된 오퍼레이션

MBean 로부터 발행 가능한 형태가 지정된 통지

예를 들어 어플리케이션의 구성을 나타내는 MBean는 복수가 다른 구성 항목을 나타내는 속성을 가질 수가 있습니다. CacheSize 속성을 읽어냈을 경우, 그 항목의 현재의 값이 리턴됩니다 . 동속성을 출력했을 경우, 항목이 갱신되어 실행중의 어플리케이션의 동작이 변화할 가능성이. save 등의 오퍼레이션을 실행해, 현재의 구성을 영속적으로 포함할 수 있습니다 . ConfigurationChangedNotification 등의 통지는 구성의 변경마다 송신할 수 있습니다.

JMX API 표준적인 사용 방법에서는 MBean는 Java 객체로서 구현됩니다. 그러나, 이하에 설명하는 대로 보통 이러한 객체가 직접 참조될 것은 없습니다.

Standard MBean

MBean 구현을 단순화 하기 위한, JMX API에는 「Standard MBean」의 개념이 도입되고 있습니다. Standard MBean는 JavaBeans^TM 의 네이밍 패턴과 자주 닮은 네이밍 패턴을 사용해 Java 인터페이스로부터 속성과 오퍼레이션을 추측할 수 있는 MBean 입니다. 예를 들어 다음과 같은 인터페이스가 있다고 합니다.

 public interface ConfigurationMBean {  public int getCacheSize();
        public void setCacheSize(int size);
        public long getLastChangedTime();
        public void save();
 }

getCacheSize 메서드와 setCacheSize 메서드는 int 형태로 불려 간 CacheSize (JavaBeans 규칙과는 달라, 최초의 문자가 알파벳의 대문자) 의 읽어내 출력 속성을 정의합니다.

getLastChangedTime 메서드는 long 형으로 불려 간 LastChangedTime 의 속성을 정의합니다. 이것은, setLastChangedTime 메서드가 존재하지 않기 때문에 읽기 전용 속성입니다.

save 메서드는 오퍼레이션으로 불려 간 save를 정의합니다. get, set, 또는 is로 시작되는 이름을 가지지 않기 때문에 속성이 아닙니다.

Standard MBean 정확한 네이밍 패턴의 상세한 것에 대하여는 JMX 사양을 참조해 (이)라고 주세요.

이 관리 인터페이스로 MBean 인 Java 객체를 작성하는 방법은 2 방법 존재합니다. 1개는 Java 인터페이스의 이름에서 MBean 접미말을 제외한 이름을 가지는 클래스에 속하는 객체를 작성하는 방법입니다. 예에서는 객체는 ConfigurationMBean (와)과 같은 Java 패키지의 Configuration 클래스에 속하게 됩니다. 이제(이미 ) 1 개의 방법에서는 StandardMBean 클래스를 사용합니다.

Dynamic MBean

Dynamic MBean는 관리 인터페이스를 실행시에 정의하는 MBean 입니다. 예를 들어 구성 MBean는 XML 파일의 해석에의해 공개하는 속성의 이름과 형태를 결정할 수 있습니다.

DynamicMBean 인터페이스를 구현하는 클래스의 Java 객체는 Dynamic MBean가 됩니다.

Open MBean

Open MBean는 Dynamic MBean 1 개입니다. 속성의 형태, 오퍼레이션 파라미터의 형태 및 반환값은 몇개의 사전 정의가 끝난 Java 클래스를 사용해 구축됩니다. Open MBean는 어플리케이션 고유의 형태 (비 Java 프로그램을 포함한다)에 반드시 액세스 할 수 있다고는 할 수 없는 remote administration 프로그램을 사용해, 오퍼레이션을 간편화합니다. Open MBean는 패키지 javax.management.openmbean 그리고 정의됩니다.

Model MBean

Model MBean는 Dynamic MBean 1 개입니다. 관리 인터페이스와 부하의 관리 자원간의 브릿지로서 기능합니다. 관리 인터페이스와 관리 자원은 Java 객체로서 지정됩니다. 다른 관리 인터페이스, 다른 관리 자원으로 같은 Model MBean 구현을 몇회에서도 재이용할 수 있습니다. Model MBean 구현은 지속성, 캐쉬 기능이라고 하는 공통의 기능을 제공할 수가 있어 패키지 javax.management.modelmbean 그리고 정의됩니다.

MBean 서버

MBean를 사용하기 위해서는 MBean 서버에 등록할 필요가 있습니다. MBean 서버는 MBean 의 리포지터리(repository)입니다. 보통, MBean 서버를 이용하지 않으면, MBean에는 액세스 할 수 없습니다. 코드는 MBean를 직접 구현하는 Java 객체에 액세스 하는 대신에 MBean 이름을 지정해 MBean 서버 경유로 MBean에 액세스 하게 되었습니다. 각 MBean는 MBean 서버내에 ObjectName 클래스에 의해 정의된 일의의 이름을 가집니다.

MBean 서버는 MBeanServer 인터페이스를 구현하는 객체입니다. J2SE 5.0 은 동일한 Java가상 머신상에서 실행되고 있는 복수가 다른 관리 컴퍼넌트로 공유 가능한 「Platform MBean Server」를 제공합니다. Platform MBean Server 에는 ManagementFactory.getPlatformMBeanServer() 메서드로 액세스 합니다.

어플리케이션 코드에서도, MBeanServerFactory 클래스를 사용해 새로운 MBean 서버를 작성하거나 기존의 MBean 서버에 액세스 하거나 할 수 있습니다.

MBean 서버에서의 MBean 작성

MBean는 2 방법의 방법으로 작성할 수 있습니다. 우선, MBean 로 하는 Java 객체를 구축해, registerMBean 메서드를 사용해, 이 Java 객체를 MBean 서버에 등록하는 방법이 있습니다. 이제(이미 ) 1개의 방법에서는 몇개의 createMBean 메서드를 사용해, 단일의 오퍼레이션으로 MBean를 작성해, 등록합니다.

registerMBean 메서드는 로컬에서는 간단하게 사용할 수 있습니다만, 리모트에서는 사용할 수 없습니다. createMBean 메서드는 리모트로 사용할 수 있습니다. 다만, 클래스의 로드의 문제가 발생하는 경우가 있으므로 주의가 필요합니다.

MBeanRegistration 인터페이스를 구현하고 있는 MBean는 MBean 서버에의 등록시 또는 MBean 서버로부터의 등록 해제시에 액션을 실행할 수 있습니다.

MBean 서버내의 MBean 에의 액세스

다음의 예의 같게, ObjectName name와 MBeanServer mbs를 지정하는 것으로써, 속성과 오퍼레이션에 액세스 할 수 있습니다.

 int cacheSize = mbs.getAttribute(name, "CacheSize");
 Attribute  newCacheSize = new Attribute("CacheSize", new Integer(2000));
 mbs.setAttribute(name, newCacheSize);
 mbs.invoke(name, "save", new Object[0], new Class[0]);

MBean 관리 인터페이스에 대응하는 Java 인터페이스가 있는 경우는 다음과 같이, MBean 프록시를 이용할 수 있습니다.

 ConfigurationMBean conf = (ConfigurationMBean) MBeanServerInvocationHandler . newProxyInstance(mbs, name, ConfigurationMBean.class, false);
 int cacheSize = conf.getCacheSize();
 conf.setCacheSize(2000);
 conf.save();

MBean 프록시는 매우 편리합니다. 2번째의 예에서는 최초의 예와 같은 MBeanServer 오퍼레이션을 호출합니다.

MBean 서버로 특정의 패턴에 일치하는 이름을 가지는 MBean 나, 특정의 제약을 채우는 속성을 가지는 MBean를 조회할 수 있습니다. 이름의 패턴은 ObjectName 클래스에서 작성됩니다. 제약은 Query 클래스에서 작성됩니다. 그 후, queryNames 메서드와 queryMBeans 메서드에 의해 쿼리가 실행됩니다.

통지

통지는 Notification 클래스 또는 서브 클래스의 인스턴스입니다. Java 클래스에 가세해, 같은 클래스의 통지의 구별로 사용하는 형태 캐릭터 라인을 가지고 있습니다.

통지를 발행하는 MBean는 NotificationBroadcaster 또는 NotificationEmitter 인터페이스를 구현할 필요가 있습니다. 보통, 이러한 인터페이스를 구현하기 위해서 NotificationBroadcasterSupport 상속인가 이 클래스의 인스턴스의 위양을 합니다.

통지는 리스너에 의해 수신됩니다. 리스너는 NotificationListener 인터페이스를 구현하는 객체입니다. MBeanServer.addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object) 메서드를 사용해, MBean에 리스너를 추가할 수 있습니다. 이 메서드에 필터를 적용해, 필요한 통지만을 선택할 수도 있습니다. 필터는 NotificationFilter 인터페이스를 구현하는 객체입니다.

MBean는 같은 MBean 서버상의 그 외의 MBean에 의해 발행되는 통지의 리스너가 될 수가 있습니다. 이 경우 MBean는 NotificationListener를 구현해, MBeanServer.addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object) 메서드를 이용해 통지를 대기합니다.

MBean 에의 원격 접근

MBean 서버에는 커넥터 경유로 원격 접근 할 수 있습니다. 커넥터를 이용하는 것으로 리모트 Java 어플리케이션으로부터, 로컬의 서버에 액세스 할 때와 같게의해 MBean 서버에 액세스 할 수 있습니다. 커넥터는 javax.management.remote 패키지에 정의되고 있습니다.

JMX 사양에는 어댑터의 개념도 정의되고 있습니다. 어댑터는 SNMP, HTML 등의 요구의 프로토콜을 변환해, MBean 서버에 액세스 합니다. 예를 들어 SNMP GET 오퍼레이션은 MBean 서버상의 getAttribute (이)가 됩니다.

패키지의 사양

JMX API 사양 버전 1.2

도입된 버전 :

1.5

개요