java.lang.management
클래스 ManagementFactory

java.lang.Object 
  java.lang.management.ManagementFactory

public class ManagementFactory
extends Object 

ManagementFactory 클래스는 Java 플랫폼의 관리 빈을 취득하기 위한 팩토리 클래스입니다. 이 클래스는 Java 가상 머신의 컴퍼넌트의 관리 인터페이스를 나타내는 1개 이상의 플랫폼 MXBean 를 돌려주는 static 메서드로 구성됩니다.

어플리케이션은 다음의 방법으로 플랫폼 MXBean에 액세스 할 수 있습니다.

• MXBean 인터페이스에의 직접 액세스
  1. static 팩토리 메서드를 개입시켜 MXBean 인스턴스를 취득해, 실행중의 가상 머신의 MXBean에 로컬 액세스 한다.
  2. newPlatfromMXBeanProxy를 호출하는 것으로 지정된 MBeanServer에 메서드 호출을 전송 하는 MXBean 프록시 인스턴스를 구축한다. 프록시는 보통, 실행중외의 가상 머신의 MXBean에 원격 접근 하기 위해서 구축된다
• MBeanServer를 포함한 MXBean 인터페이스에의 간접 액세스
  1. platform MBeanServer 로 MXBean에 로컬 액세스 하는지, 또는 특정의 MBeanServerConnection로 MXBean에 원격 접근 한다. MXBean 속성과 오퍼레이션은, OpenType에 정의된 기본 데이터형, CompositeData 및 TabularData를 포함한 「JMX 공개형」만을 사용한다. 매핑은 이하에 나타낸다

플랫폼 MXBean

플랫폼 MXBean는 JMX 인스트르멘테이션 사양에 적합하는 「관리 빈」이며, 이하에 나타내는 기본 데이터형 세트만을 사용합니다. JMX 관리 어플리케이션과 플랫폼 MBeanServer는 MXBean 고유의 데이터형을 위한 클래스를 필요로 하는 일 없이 상호 운용할 수 있습니다. JMX 커넥터 서버와 커넥터 클라이언트의 사이에 전송 되는 데이터형은, 공개형 이며, 이것에 의해 버전 간의 상호 운용이 가능합니다.

플랫폼 MXBean 인터페이스에서는 다음의 데이터형만이 사용됩니다.

• int, long, boolean 등의 원시형
• Integer, Long, Boolean, String 등의 원시형의 래퍼 클래스
• Enum 클래스
• 입력 CompositeData로 부터 그 클래스의 인스턴스로 변환하기 위해서 CompositeData 인수를 사용해, getter 메서드 및 static 메서드만을 정의하는 클래스
• List<E> (E는 원시형, 래퍼 클래스, 열거 클래스, 또는 CompositeData로 부터 그 클래스에의 변환을 지원하는 클래스)
• Map<K, V> (K와 V는 원시형, 래퍼 클래스, 열거 클래스, 또는 CompositeData로 부터 그 클래스에의 변환을 지원하는 클래스)

플랫폼 MXBean 속성 또는 오퍼레이션에의 액세스가 MBeanServer를 개입시켜 행해지는 경우, 데이터형은 다음대로 매핑 됩니다.

• 원시형 또는 래퍼 클래스는 같은 형태에 매핑 된다
• Enum 는 열거 정수명을 값으로 해서 가지는 String에 매핑 된다
• CompositeData 인수를 사용해 getter 메서드 및 static 메서드만을 정의하는 클래스는 CompositeData에 매핑 된다
• Map<K, V>는 「key」와「value」라고 하는 이름의 2개의 항목이 있는 CompositeType 라고 하는 행의 형태를 가지는 TabularData에 매핑 된다. 항목형은 각각 K와 V 대응하는 맵형이며, 「key」가 인덱스가 된다
• List<E>는 요소형으로서 E 라고 하는 맵형을 가지는 배열에 매핑 된다
• 요소형 E 배열은 요소형으로서 E 라고 하는 맵형을 가지는 같은 크기의 배열에 매핑 된다

플랫폼 MXBean MBeanInfo 는 상기대로 매핑 된 원시형 또는 공개형으로서 속성 및 오퍼레이션의 데이터형을 기술합니다.

예를 들어, MemoryMXBean 인터페이스는 다음의 getter 메서드와 setter 메서드를 가집니다.

 public MemoryUsage getHeapMemoryUsage();
 public boolean isVerbose();
 public void setVerbose(boolean value);
 

MemoryMXBean MBeanInfo 속성은 다음의 이름과 형태를 가집니다.

속성명	형
HeapMemoryUsage	CompositeData representing MemoryUsage
Verbose	boolean 형

구현상의 주의:

상기의 매핑은 각 플랫폼 MXBean 구현으로 행해집니다. 1개의 적절한 구현의 선택사항은, dynamic MBean 로서 MXBean를 구현하는 것입니다.

MXBean 명

Java 가상 머신의 각 플랫폼 MXBean는 플랫폼 MBeanServer에 서의 등록을 위해서 하나의 ObjectName를 가집니다. Java 가상 머신은 다음의 관리 인터페이스의 단일의 인스턴스를 가집니다.

관리 인터페이스	ObjectName
ClassLoadingMXBean	java.lang:type=ClassLoading
MemoryMXBean	java.lang:type=Memory
ThreadMXBean	java.lang:type=Threading
RuntimeMXBean	java.lang:type=Runtime
OperatingSystemMXBean	java.lang:type=OperatingSystem

Java 가상 머신은 아래의 관리 인터페이스의 인스턴스를 가지지 않는가 단일의 인스턴스를 가집니다.

관리 인터페이스	ObjectName
CompilationMXBean	java.lang:type=Compilation

Java 가상 머신은 아래의 관리 인터페이스의 인스턴스를 1개 이상 가질 수가 있습니다.

관리 인터페이스	ObjectName
GarbageCollectorMXBean	java.lang:type=GarbageCollector , name=collector's name
MemoryManagerMXBean	java.lang:type=MemoryManager , name=manager's name
MemoryPoolMXBean	java.lang:type=MemoryPool , name=pool's name

도입된 버전 :

1.5

관련 항목:

JMX Specification, Ways to Access Management Metrics, LoggingMXBean

필드 개요

static String	CLASS_LOADING_MXBEAN_NAME ClassLoadingMXBean ObjectName 캐릭터 라인 표현
static String	COMPILATION_MXBEAN_NAME CompilationMXBean ObjectName 캐릭터 라인 표현
static String	GARBAGE_COLLECTOR_MXBEAN_DOMAIN_TYPE GarbageCollectorMXBean ObjectName 도메인명과 형태 키프로파티.
static String	MEMORY_MANAGER_MXBEAN_DOMAIN_TYPE MemoryManagerMXBean ObjectName 도메인명과 형태 키프로파티.
static String	MEMORY_MXBEAN_NAME MemoryMXBean ObjectName 캐릭터 라인 표현
static String	MEMORY_POOL_MXBEAN_DOMAIN_TYPE MemoryPoolMXBean ObjectName 도메인명과 형태 키프로파티.
static String	OPERATING_SYSTEM_MXBEAN_NAME OperatingSystemMXBean ObjectName 캐릭터 라인 표현
static String	RUNTIME_MXBEAN_NAME RuntimeMXBean ObjectName 캐릭터 라인 표현
static String	THREAD_MXBEAN_NAME ThreadMXBean ObjectName 캐릭터 라인 표현

메서드 개요

static ClassLoadingMXBean	getClassLoadingMXBean () Java 가상 머신의 클래스 로딩 시스템의 관리 빈을 리턴합니다.
static CompilationMXBean	getCompilationMXBean () Java 가상 머신의 컴파일 시스템의 관리 빈을 리턴합니다.
static List <GarbageCollectorMXBean >	getGarbageCollectorMXBeans () Java 가상 머신 GarbageCollectorMXBean 객체의 리스트를 리턴합니다.
static List <MemoryManagerMXBean >	getMemoryManagerMXBeans () Java 가상 머신 MemoryManagerMXBean 객체의 리스트를 리턴합니다.
static MemoryMXBean	getMemoryMXBean () Java 가상 머신의 메모리시스템의 관리 빈을 리턴합니다.
static List <MemoryPoolMXBean >	getMemoryPoolMXBeans () Java 가상 머신 MemoryPoolMXBean 객체의 리스트를 리턴합니다.
static OperatingSystemMXBean	getOperatingSystemMXBean () Java 가상 머신을 실행하고 있는 OS 의 관리 빈을 리턴합니다.
static MBeanServer	getPlatformMBeanServer () 플랫폼 MBeanServer를 리턴합니다.
static RuntimeMXBean	getRuntimeMXBean () Java 가상 머신의 실행 시스템의 관리 빈을 리턴합니다.
static ThreadMXBean	getThreadMXBean () Java 가상 머신의 thread 시스템의 관리 빈을 리턴합니다.
static <T> T	newPlatformMXBeanProxy (MBeanServerConnection connection, String mxbeanName, Class <T> mxbeanInterface) 지정된 MBeanServerConnection를 개입시켜 메서드 호출을 전송 하는 지정된 MXBean 명의 플랫폼 MXBean 인터페이스의 프록시를 리턴합니다.

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

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

필드의 상세

CLASS_LOADING_MXBEAN_NAME

public static final String  CLASS_LOADING_MXBEAN_NAME

ClassLoadingMXBean ObjectName 캐릭터 라인 표현

관련 항목:

정수 필드값

COMPILATION_MXBEAN_NAME

public static final String  COMPILATION_MXBEAN_NAME

CompilationMXBean ObjectName 캐릭터 라인 표현

관련 항목:

정수 필드값

MEMORY_MXBEAN_NAME

public static final String  MEMORY_MXBEAN_NAME

MemoryMXBean ObjectName 캐릭터 라인 표현

관련 항목:

정수 필드값

OPERATING_SYSTEM_MXBEAN_NAME

public static final String  OPERATING_SYSTEM_MXBEAN_NAME

OperatingSystemMXBean ObjectName 캐릭터 라인 표현

관련 항목:

정수 필드값

RUNTIME_MXBEAN_NAME

public static final String  RUNTIME_MXBEAN_NAME

RuntimeMXBean ObjectName 캐릭터 라인 표현

관련 항목:

정수 필드값

THREAD_MXBEAN_NAME

public static final String  THREAD_MXBEAN_NAME

ThreadMXBean ObjectName 캐릭터 라인 표현

관련 항목:

정수 필드값

GARBAGE_COLLECTOR_MXBEAN_DOMAIN_TYPE

public static final String  GARBAGE_COLLECTOR_MXBEAN_DOMAIN_TYPE

GarbageCollectorMXBean ObjectName 도메인명과 형태 키프로파티. GarbageCollectorMXBean 일의의 ObjectName는 이 캐릭터 라인과 함께 「, name=collector's name」를 추가해 형성할 수 있습니다.

관련 항목:

정수 필드값

MEMORY_MANAGER_MXBEAN_DOMAIN_TYPE

public static final String  MEMORY_MANAGER_MXBEAN_DOMAIN_TYPE

MemoryManagerMXBean ObjectName 도메인명과 형태 키프로파티. MemoryManagerMXBean 일의의 ObjectName는 이 캐릭터 라인과 함께 「, name=manager's name」를 추가해 형성할 수 있습니다.

관련 항목:

정수 필드값

MEMORY_POOL_MXBEAN_DOMAIN_TYPE

public static final String  MEMORY_POOL_MXBEAN_DOMAIN_TYPE

MemoryPoolMXBean ObjectName 도메인명과 형태 키프로파티. MemoryPoolMXBean 일의의 ObjectName는 이 캐릭터 라인과 함께 「, name=pool's name」를 추가해 형성할 수 있습니다.

관련 항목:

정수 필드값

메서드의 상세

getClassLoadingMXBean

public static ClassLoadingMXBean  getClassLoadingMXBean()

Java 가상 머신의 클래스 로딩 시스템의 관리 빈을 리턴합니다.

반환값:

Java 가상 머신 ClassLoadingMXBean 객체

getMemoryMXBean

public static MemoryMXBean  getMemoryMXBean()

Java 가상 머신의 메모리시스템의 관리 빈을 리턴합니다.

반환값:

Java 가상 머신 MemoryMXBean 객체

getThreadMXBean

public static ThreadMXBean  getThreadMXBean()

Java 가상 머신의 thread 시스템의 관리 빈을 리턴합니다.

반환값:

Java 가상 머신 ThreadMXBean 객체

getRuntimeMXBean

public static RuntimeMXBean  getRuntimeMXBean()

Java 가상 머신의 실행 시스템의 관리 빈을 리턴합니다.

반환값:

Java 가상 머신 RuntimeMXBean 객체

getCompilationMXBean

public static CompilationMXBean  getCompilationMXBean()

Java 가상 머신의 컴파일 시스템의 관리 빈을 리턴합니다. Java 가상 머신이 컴파일 시스템을 가지지 않는 경우, 이 메서드는 null을 리턴합니다.

반환값:

Java 가상 머신 CompilationMXBean 객체. Java 가상 머신이 컴파일 시스템을 가지지 않는 경우는 null

getOperatingSystemMXBean

public static OperatingSystemMXBean  getOperatingSystemMXBean()

Java 가상 머신을 실행하고 있는 OS 의 관리 빈을 리턴합니다.

반환값:

Java 가상 머신 OperatingSystemMXBean 객체

getMemoryPoolMXBeans

public static List <MemoryPoolMXBean > getMemoryPoolMXBeans()

Java 가상 머신 MemoryPoolMXBean 객체의 리스트를 리턴합니다. Java 가상 머신은 1개 이상의 메모리프르를 가질 수가 있습니다. 실행중에 메모리프르를 추가 또는 삭제할 수 있습니다.

반환값:

MemoryPoolMXBean 객체의 리스트

getMemoryManagerMXBeans

public static List <MemoryManagerMXBean > getMemoryManagerMXBeans()

Java 가상 머신 MemoryManagerMXBean 객체의 리스트를 리턴합니다. Java 가상 머신은 1개 이상의 MS-DOS메모리 관리 프로그램을 가질 수가 있습니다. 실행중에 MS-DOS메모리 관리 프로그램을 추가 또는 삭제할 수 있습니다.

반환값:

MemoryManagerMXBean 객체의 리스트

getGarbageCollectorMXBeans

public static List <GarbageCollectorMXBean > getGarbageCollectorMXBeans()

Java 가상 머신 GarbageCollectorMXBean 객체의 리스트를 리턴합니다. Java 가상 머신은 1개 이상의 GarbageCollectorMXBean 객체를 가질 수가 있습니다. 또, 실행중에 GarbageCollectorMXBean를 추가 또는 삭제할 수 있습니다.

반환값:

GarbageCollectorMXBean 객체의 리스트

getPlatformMBeanServer

public static MBeanServer  getPlatformMBeanServer()

플랫폼 MBeanServer를 리턴합니다. 이 메서드의 최초의 호출로 메서드는 우선 MBeanServerFactory.createMBeanServer() 메서드를 호출해, 플랫폼 MBeanServer를 작성해, 클래스의 기술로 정의된 MXBean 명을 사용해, 이 플랫폼 MBeanServer에 플랫폼 MXBean를 등록합니다. 이후의 호출에서는 이 메서드는 초기에 작성된 플랫폼 MBeanServer를 리턴합니다.

MXBean는 동적으로 작성되어 파기됩니다. 예를 들어 메모리 pools 및 managers 는 플랫폼 MBeanServer에 자동적으로 등록 및 등록 해제됩니다.

시스템 프로퍼티 javax.management.builder.initial 이 설정되어 있으면, 플랫폼 MBeanServer 작성은 지정된 MBeanServerBuilder 에 의해 실행됩니다.

플랫폼 MXBean에 가세해, 다른 어플리케이션의 관리 빈의 등록에도, 이 플랫폼 MBeanServer를 사용하는 것을 추천합니다. 이것에 의해 모든 MBean는 같은 MBeanServer를 통해서 발행되어 특히 네트워크 퍼블리싱과 검출이 용이하게 됩니다. 플랫폼 MXBean와 의 이름의 중복을 피할 필요가 있습니다.

반환값:

플랫폼 MBeanServer. 플랫폼 MXBean는 이 메서드가 처음으로 불려 갔을 때에 플랫폼 MBeanServer 내에 등록된다

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우로 호출원이 MBeanServerFactory.createMBeanServer() 로 필요한 접근 권한을 가지지 않는 경우

관련 항목:

MBeanServerFactory, MBeanServerFactory.createMBeanServer()

newPlatformMXBeanProxy

public static <T> T newPlatformMXBeanProxy(MBeanServerConnection  connection,
                                           String  mxbeanName,
                                           Class <T> mxbeanInterface)
                                throws IOException 

지정된 MBeanServerConnection를 개입시켜 메서드 호출을 전송 하는 지정된 MXBean 명의 플랫폼 MXBean 인터페이스의 프록시를 리턴합니다.

이 메서드는 다음과 동등합니다.

Proxy.newProxyInstance (mxbeanInterface.getClassLoader(), new Class[] { mxbeanInterface }, handler)

여기서, handler는 MXBean 인터페이스에의 메서드 호출의 디스패치처 InvocationHandler 입니다. 이 handler는 MXBean 데이터형의 입력 파라미터를 매핑 된 공개형으로 변환하고 나서, MBeanServer에 전송 해, MBeanServer를 개입시켜 MXBean 메서드 호출로부터의 반환값을 공개형으로부터 MXBean 인터페이스로 선언된 대응하는 반환값의 형태로 변환합니다.

MXBean가 통지를 발행하는 (NotificationEmitter를 구현한다) 경우, mxbeanInterface와 NotificationEmitter 양쪽 모두가 이 프록시에 의해 구현됩니다.

주:

1. MXBean 프록시의 사용은 실행중의 가상 머신의 플랫폼 MXBean 에의 원격 접근에 유용하다. MXBean 프록시에의 모든 메서드 호출은, MBeanServerConnection에 전송 된다. 커넥터 서버에 통신에 관한 문제가 발생하면, IOException을 발생시킵니다. 프록시를 사용해 플랫폼 MXBean에 원격 접근 하는 어플리케이션에서는 MBeanServerConnector 인터페이스를 사용해 액세스 하는 경우와 같이, IOException을 캐치 할 준비가 필요하게 된다
2. 클라이언트 어플리케이션이, 그것과는 다른 버전을 실행중의 가상 머신의 MXBean에 원격 접근 하도록 설계되고 있는 경우, MXBean 프록시가 클라이언트 어플리케이션으로 로드 된 열거 클래스에서 발견되지 않는 열거 정수의 이름을 받았을 경우에 발생되는 InvalidObjectException를 캐치 할 준비를 할 필요가 있다
3. MBeanServerInvocationHandler 또는 그 newProxyInstance 메서드를 사용해, 플랫폼 MXBean 프록시를 작성할 수 없다. MBeanServerInvocationHandler에 의해 작성된 프록시 객체는 클래스 사양으로 기술된 플랫폼 MXBean 프로퍼티를 처리하지 않는다

파라미터:

connection - 전송처의 MBeanServerConnection

mxbeanName - 전송처의 connection 내의 플랫폼 MXBean 명. mxbeanName 서식은 ObjectName 가 아니면 안되는

mxbeanInterface - 프록시에 의해 구현되는 MXBean 인터페이스

예외:

IllegalArgumentException - 다음의 조건이 성립하는 경우:

• mxbeanName 이 유효한 ObjectName 서식이 아니다
• connection 내에서 지정된 MXBean 가 플랫폼에서 제공되는 MXBean가 아니다
• 지정된 MXBean가 MBeanServerConnection에 등록되지 않았다
• 지정된 MXBean가 지정된 mxbeanInterface 인스턴스가 아니다

IOException - MBeanServerConnection에 의 액세스시에 통신에 관한 문제가 발생했을 경우