JavaTM Platform
Standard Ed. 6

javax.management
클래스 MBeanInfo

java.lang.Object 
  상위를 확장 javax.management.MBeanInfo
모든 구현된 인터페이스:
Serializable , Cloneable , DescriptorRead
직계의 기존의 서브 클래스:
ModelMBeanInfoSupport , OpenMBeanInfoSupport


public class MBeanInfo
extends Object
implements Cloneable , Serializable , DescriptorRead

MBean 에 의해 공개된 관리 인터페이스 (관리 오퍼레이션에 사용할 수 있는 속성과 조작세트)를 기술합니다. 이 클래스의 인스턴스는 불변입니다. 서브 클래스는 가변입니다만, 서브 클래스의 변경은 추천 되고 있지 않습니다.

Dynamic MBean 에 의해 사용되는 MBeanInfo 의 컨텐츠는,getMBeanInfo() 메소드에 의해 결정됩니다. Dynamic MBean 인 Open MBean, Model MBean 가 포함됩니다.

Standard MBean 에 의해 사용되는 MBeanInfo 의 컨텐츠는, MBean 서버에 의해, 다음과 같이 결정됩니다.

getDescription() 가 돌려주는 기술자 및 내부의 속성 및 오퍼레이션의 기술자는, 대응하는 Description 주석이 존재하는 경우에는, 거기에 기초를 두어 결정됩니다. 대응하는 Description 주석이 존재하지 않는 경우, 내용은 지정되지 않습니다.

Standard MBean 에 의해 사용되는 MBeanInfo 의 그 외의 상세 정보는 지정되지 않습니다. 지정되지 않는 상세 정보에는, 포함되는 생성자 및 통지의 설명, 생성자 이나 오퍼레이션에게 건네지는 파라미터의 이름, 생성자 파라미터의 설명이 포함됩니다.

도입된 버젼:
1.5
관련 항목:
직렬화 된 형식

생성자 의 개요
MBeanInfo (String  className, String  description, MBeanAttributeInfo [] attributes, MBeanConstructorInfo [] constructors, MBeanOperationInfo [] operations, MBeanNotificationInfo [] notifications)
          MBeanInfo 를 구축합니다.
MBeanInfo (String  className, String  description, MBeanAttributeInfo [] attributes, MBeanConstructorInfo [] constructors, MBeanOperationInfo [] operations, MBeanNotificationInfo [] notifications, Descriptor  descriptor)
          MBeanInfo 를 구축합니다.
 
메소드의 개요
 Object clone ()
          이 인스턴스의 shallow 복사를 돌려줍니다.
 boolean equals (Object  o)
          이 MBeanInfo 를 다른 MBeanInfo 와 비교합니다.
 MBeanAttributeInfo [] getAttributes ()
          관리용의 공개 속성의 리스트를 돌려줍니다.
 String getClassName ()
          이 MBeanInfo 에 의해 기술된 MBean 의 Java 클래스의 이름을 돌려줍니다.
 MBeanConstructorInfo [] getConstructors ()
          MBean 의 public 생성자 의 리스트를 돌려줍니다.
 String getDescription ()
          인간이 읽을 수 있는 형식의 MBean 의 설명을 돌려줍니다.
 Descriptor getDescriptor ()
          이 MBeanInfo 의 기술자를 가져옵니다.
 MBeanNotificationInfo [] getNotifications ()
          MBean 에 의해 발행된 통지의 리스트를 돌려줍니다.
 MBeanOperationInfo [] getOperations ()
          MBean 의 오퍼레이션의 리스트를 돌려줍니다.
 int hashCode ()
          객체의 해시 코드값를 돌려줍니다.
 String toString ()
          객체의 캐릭터 라인 표현을 돌려줍니다.
 
클래스 java.lang. Object 로부터 상속된 메소드
finalize , getClass , notify , notifyAll , wait , wait , wait
 

생성자 의 상세

MBeanInfo

public MBeanInfo(String  className,
                 String  description,
                 MBeanAttributeInfo [] attributes,
                 MBeanConstructorInfo [] constructors,
                 MBeanOperationInfo [] operations,
                 MBeanNotificationInfo [] notifications)
          throws IllegalArgumentException 
MBeanInfo 를 구축합니다.

파라미터:
className - 이 MBeanInfo 로 기술된다 MBean 의 Java 클래스의 이름. 이 값에는 올바른 구문의 임의의 Java 클래스명을 지정할 수 있다. 반드시, MBean 서버 또는 MBean 의 ClassLoader 의 기존의 Java 클래스가 아니어도 좋다. MBean 의 ClassLoader 의 기존의 Java 클래스인 경우, 클래스의 public 메소드에, 이 MBeanInfo 내의 속성과 오퍼레이션을 구현하는 Standard MBean 내의 메소드를 포함하는 것이 추천 되지만, 이것은 필수가 아닌
description - 인간이 읽을 수 있는 형식의 MBean 의 설명 (임의)
attributes - MBean 의 공개 속성의 리스트. 제로장의 배열을 지정했을 경우와 같게, null 가 되는 경우도 있는
constructors - MBean 의 public 생성자 의 리스트. 제로장의 배열을 지정했을 경우와 같게, null 에 되는 경우도 있는
operations - MBean 의 오퍼레이션의 리스트. 제로장의 배열을 지정했을 경우와 같게, null 가 되는 경우도 있는
notifications - 발행된 통지의 리스트. 제로장의 배열을 지정했을 경우와 같게, null 가 되는 경우도 있다
예외:
IllegalArgumentException

MBeanInfo

public MBeanInfo(String  className,
                 String  description,
                 MBeanAttributeInfo [] attributes,
                 MBeanConstructorInfo [] constructors,
                 MBeanOperationInfo [] operations,
                 MBeanNotificationInfo [] notifications,
                 Descriptor  descriptor)
          throws IllegalArgumentException 
MBeanInfo 를 구축합니다.

파라미터:
className - 이 MBeanInfo 로 기술된다 MBean 의 Java 클래스의 이름. 이 값에는 올바른 구문의 임의의 Java 클래스명을 지정할 수 있다. 반드시, MBean 서버 또는 MBean 의 ClassLoader 의 기존의 Java 클래스가 아니어도 좋다. MBean 의 ClassLoader 의 기존의 Java 클래스인 경우, 클래스의 public 메소드에, 이 MBeanInfo 내의 속성과 오퍼레이션을 구현하는 Standard MBean 내의 메소드를 포함하는 것이 추천 되지만, 이것은 필수가 아닌
description - 인간이 읽을 수 있는 형식의 MBean 의 설명 (임의)
attributes - MBean 의 공개 속성의 리스트. 제로장의 배열을 지정했을 경우와 같게, null 가 되는 경우도 있는
constructors - MBean 의 public 생성자 의 리스트. 제로장의 배열을 지정했을 경우와 같게, null 에 되는 경우도 있는
operations - MBean 의 오퍼레이션의 리스트. 제로장의 배열을 지정했을 경우와 같게, null 가 되는 경우도 있는
notifications - 발행된 통지의 리스트. 제로장의 배열을 지정했을 경우와 같게, null 가 되는 경우도 있는
descriptor - MBean 의 기술자. null 의 경우가 있어, 이것은 빈 상태(empty)의 기술자와 동등
예외:
IllegalArgumentException
도입된 버젼:
1.6
메소드의 상세

clone

public Object  clone()

이 인스턴스의 shallow 복사를 돌려줍니다. 이 카피는,super.clone() 의 호출 (Object.clone() 에 의해 구현되는 디폴트의 네이티브shallow 복사�구의 호출)에 의해 취득됩니다. 내부 필드에 도착해, 더 이상 상세한 카피는 작성되지 않습니다.

이 클래스는 불변이므로, 카피 메소드는 주로 서브 클래스에 있어 중요하게 됩니다.

오버라이드(override):
클래스 Object 내의 clone
반환값:
이 인스턴스의 복제
관련 항목:
Cloneable

getClassName

public String  getClassName()
MBeanInfo 에 의해 기술된 MBean 의 Java 클래스의 이름을 돌려줍니다.

반환값:
클래스명

getDescription

public String  getDescription()
인간이 읽을 수 있는 형식의 MBean 의 설명을 돌려줍니다.

반환값:
설명

getAttributes

public MBeanAttributeInfo [] getAttributes()
관리용의 공개 속성의 리스트를 돌려줍니다. 각 속성은 MBeanAttributeInfo 객체에 의해 기술됩니다. 반환되는 배열은, 내부 배열의 shallow 복사, 즉 MBeanAttributeInfo 객체를 참조하는 내부 배열의 카피가 됩니다. 다만, 참조되는 각 MBeanAttributeInfo 객체는 카피되지 않습니다.

반환값:
MBeanAttributeInfo 객체의 배열

getOperations

public MBeanOperationInfo [] getOperations()
MBean 의 오퍼레이션의 리스트를 돌려줍니다. 각 오퍼레이션은 MBeanOperationInfo 객체에 의해 기술됩니다. 반환되는 배열은, 내부 배열의 shallow 복사, 즉 MBeanOperationInfo 객체를 참조하는 내부 배열의 카피가 됩니다. 다만, 참조되는 각 MBeanOperationInfo 객체는 카피되지 않습니다.

반환값:
MBeanOperationInfo 객체의 배열

getConstructors

public MBeanConstructorInfo [] getConstructors()

MBean 의 public 생성자 의 리스트를 돌려줍니다. 각 생성자 은 MBeanConstructorInfo 객체에 의해 기술됩니다.

반환되는 배열은, 내부 배열의 shallow 복사, 즉 MBeanConstructorInfo 객체를 참조하는 내부 배열의 카피가 됩니다. 다만, 참조되는 각 MBeanConstructorInfo 객체는 카피되지 않습니다.

반환되는 리스트는 완전하지 않아도 괜찮습니다. 즉, MBean 는, 리스트에 없는 public 생성자 을 가질 수도 있습니다. 이 경우, MBean 서버는, 리스트에 포함되어 있는지 어떤지에 관계없이, 생성자 을 사용해, 이 MBean 의 클래스의 인스턴스를 새롭게 구축할 수 있습니다.

반환값:
MBeanConstructorInfo 객체의 배열

getNotifications

public MBeanNotificationInfo [] getNotifications()
MBean 에 의해 발행된 통지의 리스트를 돌려줍니다. 각 통지는 MBeanNotificationInfo 객체에 의해 기술됩니다. 반환되는 배열은, 내부 배열의 shallow 복사, 즉 MBeanNotificationInfo 객체를 참조하는 내부 배열의 카피가 됩니다. 다만, 참조되는 각 MBeanNotificationInfo 객체는 카피되지 않습니다.

반환값:
MBeanNotificationInfo 객체의 배열

getDescriptor

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

정의:
인터페이스 DescriptorRead 내의 getDescriptor
반환값:
불변 또는 오리지날의 카피인 기술자
도입된 버젼:
1.6

toString

public String  toString()
클래스 Object 의 기술:
객체의 캐릭터 라인 표현을 돌려줍니다. 일반적으로,toString 메소드는 이 객체를 「텍스트로 표현한다」캐릭터 라인을 돌려줍니다. 이 결과는, 인간이 읽을 수 있는 간결하고 유익한 정보여야 합니다. 모든 서브 클래스에서, 이 메소드를 오버라이드(override) 하는 것을 추천합니다.  

Object 클래스의 toString 메소드는, 객체의 파생원의 클래스명, @ 부호 (@), 및 객체의 해시 코드의 부호 없음 16 진표현으로부터 구성되는 캐릭터 라인을 돌려줍니다. 즉, 이 메소드는 다음의 값과 동일한 캐릭터 라인을 돌려줍니다.

 getClass(). getName() + '@' + Integer.toHexString(hashCode())
 

오버라이드(override):
클래스 Object 내의 toString
반환값:
이 객체의 캐릭터 라인 표현

equals

public boolean equals(Object  o)

이 MBeanInfo 를 다른 MBeanInfo 와 비교합니다. getClassName() ,getDescription() , 및 getDescriptor() 의 반환값이 동일하고,getAttributes() ,getOperations() ,getConstructors() , 및 getNotifications() 의 2 개의 객체에 의해 반환되는 배열의 페어가 동일한 경우, 2 개의 MBeanInfo 객체는 동일해집니다. 「동일하다」란, ID 는 아니고,Object.equals(Object) 가 동일한 일을 의미합니다.

2 개의 MBeanInfo 객체에 의해 배열내에 반환되는 값이 같아도, 그 차례가 차이가 나는 경우, 이 2 개의 MBeanInfo 객체는 동일하지는 않습니다.

오버라이드(override):
클래스 Object 내의 equals
파라미터:
o - 비교 대상의 객체
반환값:
o 가 MBeanInfo 이며, 상기의 룰에 의해 이 객체와 동일한 경우에만 true
관련 항목:
Object.hashCode() , Hashtable

hashCode

public int hashCode()
클래스 Object 의 기술:
객체의 해시 코드값를 돌려줍니다. 이 메소드는,java.util.Hashtable 에 의해 제공되는 것 같은 해시 테이블로 사용하기 위해서 준비되어 있습니다.  

hashCode 메소드의 일반적인 규칙을 다음에 나타냅니다.

할 수 있는 한,Object 클래스에서 정의되는 hashCode 메소드는, 다른 객체에 대해서는 다른 정수치를 돌려줍니다. 일반적으로, 이것은 객체의 내부 주소를 정수치로 변환하는 형태로 구현됩니다만, 그러한 구현 테크닉은 JavaTM 프로그램 언어에서는 불필요합니다.

오버라이드(override):
클래스 Object 내의 hashCode
반환값:
이 객체의 해시 코드값
관련 항목:
Object.equals(java.lang.Object) , Hashtable

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.