java.lang.Object java.lang.management.ManagementFactory
public class ManagementFactory
The ManagementFactory class is a factory class for getting managed beans for the Java platform. This class consists of static methods each of which returns one or more platform MXBean(s) representing the management interface of a component of the Java virtual machine.
An application can access a platform MXBean in the following ways:
The platform MXBean interfaces use only the following data types:
When an attribute or operation of a platform MXBean is accessed via an MBeanServer , the data types are mapped as follows:
For example, the MemoryMXBean interface has the following getter and setter methods:
These attributes in the MBeanInfo of the MemoryMXBean have the following names and types:public MemoryUsage getHeapMemoryUsage(); public boolean isVerbose(); public void setVerbose(boolean value);
Attribute Name Type HeapMemoryUsage CompositeData representing MemoryUsage Verbose boolean
The mapping specified above could be done in the implementation of each platform MXBean. One good implementation choice is to implement a MXBean as a
dynamic MBean
.
Management Interface 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
A Java virtual machine has zero or a single instance of the following management interfaces.
Management Interface ObjectName CompilationMXBean java.lang:type=Compilation
A Java virtual machine may have one or more instances of the following management interfaces.
Management Interface 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
Field Summary | |
---|---|
static String |
CLASS_LOADING_MXBEAN_NAME
String representation of the ObjectName for the ClassLoadingMXBean . |
static String |
COMPILATION_MXBEAN_NAME
String representation of the ObjectName for the CompilationMXBean . |
static String |
GARBAGE_COLLECTOR_MXBEAN_DOMAIN_TYPE
The domain name and the type key property in the ObjectName for a GarbageCollectorMXBean . |
static String |
MEMORY_MANAGER_MXBEAN_DOMAIN_TYPE
The domain name and the type key property in the ObjectName for a MemoryManagerMXBean . |
static String |
MEMORY_MXBEAN_NAME
String representation of the ObjectName for the MemoryMXBean . |
static String |
MEMORY_POOL_MXBEAN_DOMAIN_TYPE
The domain name and the type key property in the ObjectName for a MemoryPoolMXBean . |
static String |
OPERATING_SYSTEM_MXBEAN_NAME
String representation of the ObjectName for the OperatingSystemMXBean . |
static String |
RUNTIME_MXBEAN_NAME
String representation of the ObjectName for the RuntimeMXBean . |
static String |
THREAD_MXBEAN_NAME
String representation of the ObjectName for the ThreadMXBean . |
Method Summary | ||
---|---|---|
static ClassLoadingMXBean |
getClassLoadingMXBean
() Returns the managed bean for the class loading system of the Java virtual machine. |
|
static CompilationMXBean |
getCompilationMXBean
() Returns the managed bean for the compilation system of the Java virtual machine. |
|
static List < GarbageCollectorMXBean > |
getGarbageCollectorMXBeans
() Returns a list of GarbageCollectorMXBean objects in the Java virtual machine. |
|
static List < MemoryManagerMXBean > |
getMemoryManagerMXBeans
() Returns a list of MemoryManagerMXBean objects in the Java virtual machine. |
|
static MemoryMXBean |
getMemoryMXBean
() Returns the managed bean for the memory system of the Java virtual machine. |
|
static List < MemoryPoolMXBean > |
getMemoryPoolMXBeans
() Returns a list of MemoryPoolMXBean objects in the Java virtual machine. |
|
static OperatingSystemMXBean |
getOperatingSystemMXBean
() Returns the managed bean for the operating system on which the Java virtual machine is running. |
|
static javax.management.MBeanServer
|
getPlatformMBeanServer
() Returns the platform MBeanServer. |
|
static RuntimeMXBean |
getRuntimeMXBean
() Returns the managed bean for the runtime system of the Java virtual machine. |
|
static ThreadMXBean |
getThreadMXBean
() Returns the managed bean for the thread system of the Java virtual machine. |
|
static
|
newPlatformMXBeanProxy
(javax.management.MBeanServerConnection connection,
String
Returns a proxy for a platform MXBean interface of a given MXBean name that forwards its method calls through the given MBeanServerConnection . |
Methods inherited from class java.lang. Object |
---|
clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait |
Field Detail |
---|
public static final String CLASS_LOADING_MXBEAN_NAME
public static final String COMPILATION_MXBEAN_NAME
public static final String MEMORY_MXBEAN_NAME
public static final String OPERATING_SYSTEM_MXBEAN_NAME
public static final String RUNTIME_MXBEAN_NAME
public static final String THREAD_MXBEAN_NAME
public static final String GARBAGE_COLLECTOR_MXBEAN_DOMAIN_TYPE
public static final String MEMORY_MANAGER_MXBEAN_DOMAIN_TYPE
public static final String MEMORY_POOL_MXBEAN_DOMAIN_TYPE
Method Detail |
---|
public static ClassLoadingMXBean getClassLoadingMXBean()
public static MemoryMXBean getMemoryMXBean()
public static ThreadMXBean getThreadMXBean()
public static RuntimeMXBean getRuntimeMXBean()
public static CompilationMXBean getCompilationMXBean()
public static OperatingSystemMXBean getOperatingSystemMXBean()
public static List<MemoryPoolMXBean> getMemoryPoolMXBeans()
public static List<MemoryManagerMXBean> getMemoryManagerMXBeans()
public static List<GarbageCollectorMXBean> getGarbageCollectorMXBeans()
public static javax.management.MBeanServerMBeanServergetPlatformMBeanServer()
MXBeans that get created and destroyed dynamically, for example, memory pools and managers , will automatically be registered and deregistered into the platform MBeanServer .
If the system property
javax.management.builder.initial
is set, the platform
MBeanServer
creation will be done by the specified
MBeanServerBuilder.
MBeanServerBuilder
.
It is recommended that this platform MBeanServer also be used to register other application managed beans besides the platform MXBeans. This will allow all MBeans to be published through the same MBeanServer and hence allow for easier network publishing and discovery. Name conflicts with the platform MXBeans should be avoided.
public static <T> T newPlatformMXBeanProxy(javax.management.MBeanServerConnection connection, String(MBeanServerConnectionconnection,StringmxbeanName, Class<T> mxbeanInterface) throws IOException
This method is equivalent to:
Proxy.newProxyInstance (mxbeanInterface.getClassLoader(), new Class[] { mxbeanInterface }, handler)where handler is an InvocationHandler to which method invocations to the MXBean interface are dispatched. This handler converts an input parameter from an MXBean data type to its mapped open type before forwarding to the MBeanServer and converts a return value from an MXBean method call through the MBeanServer from an open type to the corresponding return type declared in the MXBean interface.
If the MXBean is a notification emitter (i.e., it implements
NotificationEmitter),
NotificationEmitter
),
both the
mxbeanInterface
and
NotificationEmitter
will be implemented by this proxy.
Notes: