javax.management.modelmbean
클래스 ModelMBeanInfoSupport

java.lang.Object 
  javax.management.MBeanInfo 
      javax.management.modelmbean.ModelMBeanInfoSupport

모든 구현된 인터페이스:

Serializable , Cloneable , DescriptorRead , ModelMBeanInfo

public class ModelMBeanInfoSupport
extends MBeanInfo 
implements ModelMBeanInfo 

이 클래스는, ModelMBean 의 메타데이타를 나타냅니다. 메타데이타객체에 기술자가 추가되고 있습니다.

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

MBeanServer 로 인스턴스화 된 MBean 는 모두 관리 대상이 됩니다. 이러한 속성 및 오퍼레이션에는, MBeanServer 에 접속된 연결기 또는 어댑터 경유로 원격 접근 할 수 있습니다. JMX 준거의 MBean 가 아닌 Java 객체는, MBeanServer 에 등록할 수 없습니다. 자원은, ModelMBean 를 인스턴스화하는 것으로, MBean 의 유효성을 보증합니다. 모든 public 메소드로, MBeanException 및 RuntimeOperationsException 가 throw 될 필요가 있습니다. 이것에 의해, 분산형 통신 (RMI, EJB 등)으로부터의 예외의 랩이 가능하게 됩니다.

이 클래스의 serialVersionUID 은 -1935722590756516193L 입니다.

도입된 버젼:

1.5

관련 항목:

직렬화 된 형식

생성자 의 개요

ModelMBeanInfoSupport (ModelMBeanInfo mbi)
지정된 ModelMBeanInfo 를 복제해 ModelMBeanInfoSupport 를 구축합니다.

ModelMBeanInfoSupport (String className, String description, ModelMBeanAttributeInfo [] attributes, ModelMBeanConstructorInfo [] constructors, ModelMBeanOperationInfo [] operations, ModelMBeanNotificationInfo [] notifications)
제공된 정보로 ModelMBeanInfoSupport 를 작성합니다.

ModelMBeanInfoSupport (String className, String description, ModelMBeanAttributeInfo [] attributes, ModelMBeanConstructorInfo [] constructors, ModelMBeanOperationInfo [] operations, ModelMBeanNotificationInfo [] notifications, Descriptor mbeandescriptor)
제공된 정보와 파라미터로서 지정된 기술자를 사용해 ModelMBeanInfoSupport 를 작성합니다.

메소드의 개요

Object	clone () 이 인스턴스의 shallow 복사를 돌려줍니다.
ModelMBeanAttributeInfo	getAttribute (String inName) 이름으로 요구된 ModelMBeanAttributeInfo 를 돌려줍니다.
ModelMBeanConstructorInfo	getConstructor (String inName) 이름으로 요구된 ModelMBeanConstructorInfo 를 돌려줍니다.
Descriptor	getDescriptor () 이 MBeanInfo 의 기술자를 가져옵니다.
Descriptor	getDescriptor (String inDescriptorName) 이름으로 요구된 Descriptor 를 돌려줍니다.
Descriptor	getDescriptor (String inDescriptorName, String inDescriptorType) 이름과 descriptorType 로 요구된 Descriptor 를 돌려줍니다.
Descriptor []	getDescriptors (String inDescriptorType) inDescriptorType 형의 ModelMBeanInfo 의 모든 Descriptor 로 구성되는 Descriptor 배열을 돌려줍니다.
Descriptor	getMBeanDescriptor () MBean 전체 정책를 포함한 ModelMBean 의 기술자를 돌려줍니다.
ModelMBeanNotificationInfo	getNotification (String inName) 이름으로 요구된 ModelMBeanNotificationInfo 를 돌려줍니다.
ModelMBeanOperationInfo	getOperation (String inName) 이름으로 요구된 ModelMBeanOperationInfo 를 돌려줍니다.
void	setDescriptor (Descriptor inDescriptor, String inDescriptorType) ModelMBean 의 inDescriptorType 형의 정보 배열내에 기술자를 설정합니다.
void	setDescriptors (Descriptor [] inDescriptors) ModelMBeanInfo 에 기술자를 추가하는지, ModelMBeanInfo 내의 기술자를 옮겨놓습니다.
void	setMBeanDescriptor (Descriptor inMBeanDescriptor) ModelMBean 의 기술자를 설정합니다.

클래스 javax.management. MBeanInfo 로부터 상속된 메소드

equals , getAttributes , getClassName , getConstructors , getDescription , getNotifications , getOperations , hashCode , toString

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

finalize , getClass , notify , notifyAll , wait , wait , wait

인터페이스 javax.management.modelmbean. ModelMBeanInfo 로부터 상속된 메소드

getAttributes , getClassName , getConstructors , getDescription , getNotifications , getOperations

생성자 의 상세

ModelMBeanInfoSupport

public ModelMBeanInfoSupport(ModelMBeanInfo  mbi)

지정된 ModelMBeanInfo 를 복제해 ModelMBeanInfoSupport 를 구축합니다. 반환되는 객체는, 지정한 객체의 shallow 복사입니다. Descriptor 도, 포함되는 배열 (ModelMBeanAttributeInfo[] 등)도 복제되지 않습니다. 이 메소드의 주된 용도는,setDescriptor 를 사용해, 원의 객체의 Descriptor 에 영향을 미치는 일 없이, 반환되는 인스턴스의 Descriptor 를 변경하는 것입니다.

파라미터:

mbi - ModelMBeanInfo 인스턴스. 이 인스턴스로부터 작성한 ModelMBeanInfo 가 초기화된다

ModelMBeanInfoSupport

public ModelMBeanInfoSupport(String  className,
                             String  description,
                             ModelMBeanAttributeInfo [] attributes,
                             ModelMBeanConstructorInfo [] constructors,
                             ModelMBeanOperationInfo [] operations,
                             ModelMBeanNotificationInfo [] notifications)

제공된 정보로 ModelMBeanInfoSupport 를 작성합니다. 기술자는 디폴트의 것이 사용됩니다. 디폴트의 기술자는, name=mbeanName, descriptorType=mbean, displayName=ClassName, persistPolicy=never, log=F, visibility=1 입니다.

파라미터:

className - MBean 의 클래스명

description - 인간이 읽을 수 있는 형식의 ModelMBean 의 설명

attributes - 기술자를 가지는 ModelMBeanAttributeInfo 객체의 배열

constructors - 기술자를 가지는 ModelMBeanConstructorInfo 객체의 배열

operations - 기술자를 가지는 ModelMBeanOperationInfo 객체의 배열

notifications - 기술자를 가지는 ModelMBeanNotificationInfo 객체의 배열

ModelMBeanInfoSupport

public ModelMBeanInfoSupport(String  className,
                             String  description,
                             ModelMBeanAttributeInfo [] attributes,
                             ModelMBeanConstructorInfo [] constructors,
                             ModelMBeanOperationInfo [] operations,
                             ModelMBeanNotificationInfo [] notifications,
                             Descriptor  mbeandescriptor)

제공된 정보와 파라미터로서 지정된 기술자를 사용해 ModelMBeanInfoSupport 를 작성합니다.

파라미터:

className - MBean 의 클래스명

description - 인간이 읽을 수 있는 형식의 ModelMBean 의 설명

attributes - 기술자를 가지는 ModelMBeanAttributeInfo 객체의 배열

constructors - 기술자를 가지는 ModelMBeanConstructorInfo 객체의 배열

operations - 기술자를 가지는 ModelMBeanOperationInfo 객체의 배열

notifications - 기술자를 가지는 ModelMBeanNotificationInfo 객체의 배열

mbeandescriptor - MBean 전체 정책를 포함한 MBeanDescriptor 로서 사용되는 기술자. 기술자가 null 의 경우, 디폴트의 기술자가 작성된다. 디폴트의 기술자는, name=className, descriptorType=mbean, displayName=className, persistPolicy=never, log=F, visibility=1 입니다. 기술자에게 이러한 필드 모든 것이 포함되지 않는 경우는, 디폴트 값로 추가됩니다.

예외:

RuntimeOperationsException - 파라미터로서 건네받은 기술자가 무효인 경우, IllegalArgumentException 를 랩 한다(유효한 MBean 기술자의 정의에 대해서는 getMBeanDescriptor 를 참조)

메소드의 상세

clone

public Object  clone()

이 인스턴스의 shallow 복사를 돌려줍니다. Descriptor 도, 포함되는 배열 (ModelMBeanAttributeInfo[] 등)도 복제되지 않습니다. 이 메소드의 주된 용도는,setDescriptor 를 사용해, 원의 객체의 Descriptor 에 영향을 미치는 일 없이, 복제의 Descriptor 를 변경하는 것입니다.

정의:

인터페이스 ModelMBeanInfo 내의 clone

오버라이드(override):

클래스 MBeanInfo 내의 clone

반환값:

이 인스턴스의 샤로 복제

관련 항목:

Cloneable

getDescriptors

public Descriptor [] getDescriptors(String  inDescriptorType)
                            throws MBeanException ,
                                   RuntimeOperationsException 

인터페이스 ModelMBeanInfo 의 기술:

inDescriptorType 형의 ModelMBeanInfo 의 모든 Descriptor 로 구성되는 Descriptor 배열을 돌려줍니다.

정의:

인터페이스 ModelMBeanInfo 내의 getDescriptors

파라미터:

inDescriptorType - 반환되는 기술자에 대해서 설정할 필요가 있는 descriptorType 필드의 값. mbean, attribute, operation, constructor, notification 의 언젠가. null 또는 빈 상태(empty)의 경우, 모든 형태가 반환된다

반환값:

형이 inDescriptorType 의 경우, 이 ModelMBean 의 모든 기술자를 포함한 기술자 배열

예외:

MBeanException - 분산 통신 Exception 를 랩 한다

RuntimeOperationsException - 파라미터로서 건네받은 descriptorType 가 mbean, attribute, operation, constructor, notification 의 머지않아도 아닌 경우, 빈 상태(empty)의 경우, 또는 null 의 경우, IllegalArgumentException 를 랩 하는

관련 항목:

ModelMBeanInfo.setDescriptors(javax.management.Descriptor[])

setDescriptors

public void setDescriptors(Descriptor [] inDescriptors)
                    throws MBeanException ,
                           RuntimeOperationsException 

인터페이스 ModelMBeanInfo 의 기술:

ModelMBeanInfo 에 기술자를 추가하는지, ModelMBeanInfo 내의 기술자를 옮겨놓습니다.

정의:

인터페이스 ModelMBeanInfo 내의 setDescriptors

파라미터:

inDescriptors - ModelMBeanInfo 내로 설정되는 기술자. 리스트의 null 요소는 무시된다. 모든 기술자가 name 및 descriptorType 필드를 가지고 있을 필요가 있다

예외:

MBeanException - 분산 통신 Exception 를 랩 한다

RuntimeOperationsException - 기술자가 null 또는 부정한 경우, IllegalArgumentException 를 랩 하는

관련 항목:

ModelMBeanInfo.getDescriptors(java.lang.String)

getDescriptor

public Descriptor  getDescriptor(String  inDescriptorName)
                         throws MBeanException ,
                                RuntimeOperationsException 

이름으로 요구된 Descriptor 를 돌려줍니다.

파라미터:

inDescriptorName - 기술자의 이름

반환값:

같은 이름의 ModelMBean 의 기술자를 포함한다 기술자. 기술자가 발견되지 않는 경우, null 가 반환된다

예외:

MBeanException - 분산 통신 Exception 를 랩 한다

RuntimeOperationsException - 이름이 null 의 경우, IllegalArgumentException 을 랩 하는

관련 항목:

setDescriptor(javax.management.Descriptor, java.lang.String)

getDescriptor

public Descriptor  getDescriptor(String  inDescriptorName,
                                String  inDescriptorType)
                         throws MBeanException ,
                                RuntimeOperationsException 

인터페이스 ModelMBeanInfo 의 기술:

이름과 descriptorType 로 요구된 Descriptor 를 돌려줍니다.

정의:

인터페이스 ModelMBeanInfo 내의 getDescriptor

파라미터:

inDescriptorName - 기술자의 이름

inDescriptorType - 요구되는 기술자의 형. null 또는 빈 상태(empty)의 경우, 모든 형태가 검색된다. 유효한 형태는, mbean, attribute, constructor, operation, 및 notification. 이 값은, 반환되는 기술자의 descriptorType 필드와 동일해진다

반환값:

같은 이름 및 descriptorType 의 ModelMBean 의 기술자를 포함한 기술자. 기술자가 발견되지 않는 경우, null 가 반환된다

예외:

MBeanException - 분산 통신 Exception 를 랩 한다

RuntimeOperationsException - 기술자명이 null 인지, 형태가 null 또는 부정한 경우, IllegalArgumentException 를 랩 한다. 형태는, mbean, attribute, constructor, operation, notification 의 언젠가가 아니면 안되는

관련 항목:

ModelMBeanInfo.setDescriptor(javax.management.Descriptor, java.lang.String)

setDescriptor

public void setDescriptor(Descriptor  inDescriptor,
                          String  inDescriptorType)
                   throws MBeanException ,
                          RuntimeOperationsException 

인터페이스 ModelMBeanInfo 의 기술:

ModelMBean 의 inDescriptorType 형의 정보 배열내에 기술자를 설정합니다. 지정된 기술자를 설정하기 위해(때문에), 대응하는 ModelMBean*Info 의 setDescriptor 메소드가 불려 갑니다.

정의:

인터페이스 ModelMBeanInfo 내의 setDescriptor

파라미터:

inDescriptor - ModelMBean 내로 설정된다 기술자. null 이외가 아니면 안된다. 모든 기술자가 name 및 descriptorType 필드를 가지고 있을 필요가 있는

inDescriptorType - 설정되는 기술자의 형. null 의 경우, 기술자의 descriptorType 필드가 사용된다. 지정되고 있는 경우, 이 값이 기술자의 descriptorType 필드에 설정되지 않으면 안 된다. mbean, attribute, constructor, operation, notification 의 언젠가

예외:

MBeanException - 기술자의 name 필드가 발견되지 않는 경우, IllegalArgumentException 를 랩 한다

RuntimeOperationsException - 인수가 부정 또는 null 인 경우, 또는 대응하는 MBeanAttributeInfo, MBeanConstructorInfo, MBeanNotificationInfo, MBeanOperationInfo 의 어느쪽이든으로

관련 항목:

ModelMBeanInfo.getDescriptor(java.lang.String, java.lang.String)

getAttribute

public ModelMBeanAttributeInfo  getAttribute(String  inName)
                                     throws MBeanException ,
                                            RuntimeOperationsException 

인터페이스 ModelMBeanInfo 의 기술:

이름으로 요구된 ModelMBeanAttributeInfo 를 돌려줍니다.

정의:

인터페이스 ModelMBeanInfo 내의 getAttribute

파라미터:

inName - 취득하는 ModelMBeanAttributeInfo 의 이름. 이 이름의 ModelMBeanAttributeInfo 가 존재하지 않는 경우는 null 가 반환된다

반환값:

지정된 속성의 속성 정보. 존재하지 않는 경우는 null

예외:

MBeanException - 분산 통신 Exception 를 랩 한다

RuntimeOperationsException - 속성명이 null 의 경우, IllegalArgumentException 를 랩 한다

getOperation

public ModelMBeanOperationInfo  getOperation(String  inName)
                                     throws MBeanException ,
                                            RuntimeOperationsException 

인터페이스 ModelMBeanInfo 의 기술:

이름으로 요구된 ModelMBeanOperationInfo 를 돌려줍니다.

정의:

인터페이스 ModelMBeanInfo 내의 getOperation

파라미터:

inName - 취득하는 ModelMBeanOperationInfo 의 이름. 이 이름의 ModelMBeanOperationInfo 가 존재하지 않는 경우는 null 가 반환된다

반환값:

지정된 오퍼레이션의 오퍼레이션 정보. 존재하지 않는 경우는 null

예외:

MBeanException - 분산 통신 Exception 를 랩 한다

RuntimeOperationsException - 오퍼레이션명이 null 의 경우 IllegalArgumentException 를 랩 한다

getConstructor

public ModelMBeanConstructorInfo  getConstructor(String  inName)
                                         throws MBeanException ,
                                                RuntimeOperationsException 

이름으로 요구된 ModelMBeanConstructorInfo 를 돌려줍니다. 이 이름의 ModelMBeanConstructorInfo 가 존재하지 않는 경우, null 가 돌려주어집니다.

파라미터:

inName - 생성자 의 이름

반환값:

지정된 생성자 의 생성자 정보. 존재하지 않는 경우는 null

예외:

MBeanException - 분산 통신 Exception 를 랩 한다

RuntimeOperationsException - 생성자 명이 null 의 경우, IllegalArgumentException 를 랩 한다

getNotification

public ModelMBeanNotificationInfo  getNotification(String  inName)
                                           throws MBeanException ,
                                                  RuntimeOperationsException 

인터페이스 ModelMBeanInfo 의 기술:

이름으로 요구된 ModelMBeanNotificationInfo 를 돌려줍니다.

정의:

인터페이스 ModelMBeanInfo 내의 getNotification

파라미터:

inName - 취득하는 ModelMBeanNotificationInfo 의 이름. 이 이름의 ModelMBeanNotificationInfo 가 존재하지 않는 경우는 null 가 반환된다

반환값:

지정된 통지의 정보. 존재하지 않는 경우는 null

예외:

MBeanException - 분산 통신 Exception 를 랩 한다

RuntimeOperationsException - 통지명이 null 의 경우 IllegalArgumentException 를 랩 한다

getDescriptor

public Descriptor  getDescriptor()

클래스 MBeanInfo 의 기술:

이 MBeanInfo 의 기술자를 가져옵니다. 반환값을 변경해도, 원의 기술자는 영향을 받지 않습니다.

정의:

인터페이스 DescriptorRead 내의 getDescriptor

오버라이드(override):

클래스 MBeanInfo 내의 getDescriptor

반환값:

불변 또는 오리지날의 카피인 기술자

도입된 버젼:

1.6

getMBeanDescriptor

public Descriptor  getMBeanDescriptor()
                              throws MBeanException 

인터페이스 ModelMBeanInfo 의 기술:

MBean 전체 정책를 포함한 ModelMBean 의 기술자를 돌려줍니다. 이 기술자에게는, MBean 의 메타데이타와 지속성 기능 및 캐싱 기능의 디폴트 정책가 포함됩니다.

기술자내의 필드는 이하와 같이 정의가 끝난 상태입니다만, 이 내용으로 한정되지 않습니다.

 name           :MBean 명  
 descriptorType :반드시 mbean   
 displayName    :디스플레이로 사용되는 속성의 이름 
 persistPolicy  :OnUpdate, OnTimer, NoMoreOftenThan, OnUnregister, Always, Never  
 persistLocation :완전 수식 디렉토리명. MBean 는, 필요에 따라서 이 디렉토리에 보관 유지된다 
 persistFile    :MBean 를 보관 유지하는 파일의 이름
 persistPeriod  :초수. OnTime 및 NoMoreOftenThan PersistPolicy 의 지속 사이클의 빈도를 나타낸다 
 currencyTimeLimit :치의 유효기간.  <0 무효,=0 항상 유효, >0 초  
 log            :t 의 경우는 모든 통지를 로그에 기록, f 의 경우는 통지를 기록하지 않는다
 logfile        :이벤트의 기록처 파일의 완전 수식 파일명
 visibility     :1 ~ 4 의 값의 쳐 1:항상 가시 4:거의 불가시
 export         :이 MBean 를 export 또는 공개할 때 사용하는 이름.
                  다른 JMX 에이전트는 이 이름을 사용해 MBean 를 검색한다   
 presentationString :데이터 표현과 MBean 를 관련짓기 위한 XML 형식의 캐릭터 라인 
 

디폴트의 기술자는, name=mbeanName, descriptorType=mbean, displayName=this.getClassName(), persistPolicy=never, log=F, export=F, visibility=1 입니다. 기술자에게 이러한 몇개의 필드가 부족한 경우, 부족한 필드가 디폴트 값로 추가됩니다.

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

정의:

인터페이스 ModelMBeanInfo 내의 getMBeanDescriptor

반환값:

MBean 기술자

예외:

MBeanException - 분산 통신 Exception 를 랩 하는

관련 항목:

ModelMBeanInfo.setMBeanDescriptor(javax.management.Descriptor)

setMBeanDescriptor

public void setMBeanDescriptor(Descriptor  inMBeanDescriptor)
                        throws MBeanException ,
                               RuntimeOperationsException 

인터페이스 ModelMBeanInfo 의 기술:

ModelMBean 의 기술자를 설정합니다. 이 기술자에게는, MBean 에 관한 MBean 전체의 디폴트의 메타데이타와 지속성 기능 및 캐싱 기능의 디폴트 정책가 포함됩니다. 이 오퍼레이션은, 기술자를 완전하게 치환합니다. 머지는 실시하지 않습니다. 기술자가 null 로 설정되었을 경우, 디폴트의 기술자가 작성됩니다. 디폴트의 기술자는, name=mbeanName, descriptorType=mbean, displayName=this.getClassName(), persistPolicy=never, log=F, export=F, visibility=1 입니다. 기술자에게 이러한 몇개의 필드가 부족한 경우, 부족한 필드가 디폴트 값로 추가됩니다. 유효한 필드명에 대해서는,getMBeanDescriptor 메소드의 javadoc 를 참조해 주세요.

정의:

인터페이스 ModelMBeanInfo 내의 setMBeanDescriptor

파라미터:

inMBeanDescriptor - 설정하는 기술자

예외:

MBeanException - 분산 통신 Exception 를 랩 한다

RuntimeOperationsException - 기술자가 무효인 경우, IllegalArgumentException 를 랩 하는

관련 항목:

ModelMBeanInfo.getMBeanDescriptor()