模块 java.management

软件包 javax.management

Class JMX

java.lang.Object

javax.management.JMX

public class JMX
extends Object

JMX API中的静态方法。 没有这个类的实例。

从以下版本开始：

1.6

字段汇总

字段

变量和类型	字段	描述
static String	DEFAULT_VALUE_FIELD	defaultValue字段的名称。
static String	IMMUTABLE_INFO_FIELD	immutableInfo字段的名称。
static String	INTERFACE_CLASS_NAME_FIELD	interfaceClassName字段的名称。
static String	LEGAL_VALUES_FIELD	legalValues字段的名称。
static String	MAX_VALUE_FIELD	maxValue字段的名称。
static String	MIN_VALUE_FIELD	minValue字段的名称。
static String	MXBEAN_FIELD	mxbean字段的名称。
static String	OPEN_TYPE_FIELD	openType字段的名称。
static String	ORIGINAL_TYPE_FIELD	originalType字段的名称。

方法摘要

变量和类型	方法	描述
static boolean	isMXBeanInterface(类<?> interfaceClass)	测试接口是否是MXBean接口。
static <T> T	newMBeanProxy(MBeanServerConnection connection, ObjectName objectName, 类<T> interfaceClass)	为本地或远程MBean Server中的标准MBean创建代理。
static <T> T	newMBeanProxy(MBeanServerConnection connection, ObjectName objectName, 类<T> interfaceClass, boolean notificationEmitter)	为本地或远程MBean Server中的标准MBean创建代理，该MBean也可能支持NotificationEmitter的方法。
static <T> T	newMXBeanProxy(MBeanServerConnection connection, ObjectName objectName, 类<T> interfaceClass)	为本地或远程MBean Server中的MXBean创建代理。
static <T> T	newMXBeanProxy(MBeanServerConnection connection, ObjectName objectName, 类<T> interfaceClass, boolean notificationEmitter)	为本地或远程MBean Server中的MXBean创建代理，该服务器也可能支持NotificationEmitter的方法。

声明方法的类 java.lang.Object

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

字段详细信息

DEFAULT_VALUE_FIELD

public static final String DEFAULT_VALUE_FIELD

defaultValue字段的名称。

另请参见：

常数字段值

IMMUTABLE_INFO_FIELD

public static final String IMMUTABLE_INFO_FIELD

immutableInfo字段的名称。

另请参见：

常数字段值

INTERFACE_CLASS_NAME_FIELD

public static final String INTERFACE_CLASS_NAME_FIELD

interfaceClassName字段的名称。

另请参见：

常数字段值

LEGAL_VALUES_FIELD

public static final String LEGAL_VALUES_FIELD

legalValues字段的名称。

另请参见：

常数字段值

MAX_VALUE_FIELD

public static final String MAX_VALUE_FIELD

maxValue字段的名称。

另请参见：

常数字段值

MIN_VALUE_FIELD

public static final String MIN_VALUE_FIELD

minValue字段的名称。

另请参见：

常数字段值

MXBEAN_FIELD

public static final String MXBEAN_FIELD

mxbean字段的名称。

另请参见：

常数字段值

OPEN_TYPE_FIELD

public static final String OPEN_TYPE_FIELD

openType字段的名称。

另请参见：

常数字段值

ORIGINAL_TYPE_FIELD

public static final String ORIGINAL_TYPE_FIELD

originalType字段的名称。

另请参见：

常数字段值

方法详细信息

newMBeanProxy

public static <T> T newMBeanProxy(MBeanServerConnection connection,
                                  ObjectName objectName,
                                  类<T> interfaceClass)

为本地或远程MBean Server中的标准MBean创建代理。

如果您的MBean Server mbs包含具有ObjectName name的MBean，并且如果MBean的管理接口由Java接口MyMBean描述，则可以为此MBean构造代理，如下所示：

  MyMBean proxy = JMX.newMBeanProxy(mbs, name, MyMBean.class); 

例如，假设MyMBean看起来像这样：

  public interface MyMBean {
     public String getSomeAttribute();
     public void setSomeAttribute(String value);
     public void someOperation(String param1, int param2);
 } 

然后你可以执行：

• proxy.getSomeAttribute() ，这将致电mbs. getAttribute (name, "SomeAttribute") 。
• proxy.setSomeAttribute("whatever") ，这将致电mbs. setAttribute (name, new Attribute("SomeAttribute", "whatever")) 。
• proxy.someOperation("param1", 2)将转换为致电mbs. invoke (name, "someOperation", <etc>) 。

此方法返回的对象是Proxy，其InvocationHandler是MBeanServerInvocationHandler 。

此方法相当于newMBeanProxy(connection, objectName, interfaceClass, false) 。

参数类型

T - 允许编译器知道，例如，如果 interfaceClass参数为 MyMBean.class ，则返回类型为 MyMBean 。

参数

connection - 要转发到的MBean服务器。

objectName - 要转发到的 connection内的MBean的名称。

interfaceClass - MBean导出的管理接口，也将由返回的代理实现。

结果

新的代理实例。

异常

IllegalArgumentException - 如果 interfaceClass不是 compliant MBean interface

newMBeanProxy

public static <T> T newMBeanProxy(MBeanServerConnection connection,
                                  ObjectName objectName,
                                  类<T> interfaceClass,
                                  boolean notificationEmitter)

为本地或远程MBean Server中的标准MBean创建代理，该服务器也可能支持NotificationEmitter的方法。

此方法的行为与newMBeanProxy(MBeanServerConnection, ObjectName, Class)相同，但另外，如果notificationEmitter是true ，则假定MBean为NotificationBroadcaster或NotificationEmitter ，返回的代理将实现NotificationEmitter以及interfaceClass 。 在代理上调用NotificationBroadcaster.addNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)将导致调用MBeanServerConnection.addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object) ，同样对NotificationBroadcaster和NotificationEmitter的其他方法调用 。

参数类型

T - 允许编译器知道，例如，如果 interfaceClass参数为 MyMBean.class ，则返回类型为 MyMBean 。

参数

connection - 要转发到的MBean服务器。

objectName - 要转发到的 connection内的MBean的名称。

interfaceClass - MBean导出的管理接口，也将由返回的代理实现。

notificationEmitter -使返回的代理实现NotificationEmitter经由其方法转发connection 。

结果

新的代理实例。

异常

IllegalArgumentException - 如果 interfaceClass不是 compliant MBean interface

newMXBeanProxy

public static <T> T newMXBeanProxy(MBeanServerConnection connection,
                                   ObjectName objectName,
                                   类<T> interfaceClass)

为本地或远程MBean Server中的MXBean创建代理。

如果您的MBean Server mbs包含带有50190578353的 name的MXBean，并且如果Java接口MyMXBean描述了MXBean的管理接口，则可以为MXBean构造代理，如下所示：

  MyMXBean proxy = JMX.newMXBeanProxy(mbs, name, MyMXBean.class); 

例如，假设MyMXBean看起来像这样：

  public interface MyMXBean {
     public String getSimpleAttribute();
     public void setSimpleAttribute(String value);
     public MemoryUsage getMappedAttribute();
     public void setMappedAttribute(MemoryUsage memoryUsage);
     public MemoryUsage someOperation(String param1, MemoryUsage param2);
 } 

然后：

• proxy.getSimpleAttribute()将致电mbs. getAttribute (name, "SimpleAttribute") 。

• proxy.setSimpleAttribute("whatever")将致电mbs. setAttribute (name, new Attribute("SimpleAttribute", "whatever")) 。

  因为String是一个简单类型 ，在SimpleType的意义上，它不会在MXBean的上下文中更改。 对于属性SimpleAttribute ，MXBean代理的行为与标准MBean代理（请参阅newMBeanProxy ） SimpleAttribute 。

• proxy.getMappedAttribute()将致电mbs.getAttribute("MappedAttribute") 。 MXBean映射规则意味着属性MappedAttribute的实际类型将为CompositeData ，这就是mbs.getAttribute调用将返回的内容。 然后，代理将使用MXBean映射规则将CompositeData转换回预期类型MemoryUsage 。

• 同样， proxy.setMappedAttribute(memoryUsage)将转换MemoryUsage参数为CompositeData之前调用mbs.setAttribute 。

• proxy.someOperation("whatever", memoryUsage)将MemoryUsage参数转换为CompositeData并调用mbs.invoke 。 mbs.invoke返回的值也将是CompositeData ，代理将使用MXBean映射规则将其转换为预期类型MemoryUsage 。

此方法返回的对象是Proxy，其InvocationHandler是MBeanServerInvocationHandler 。

此方法相当于newMXBeanProxy(connection, objectName, interfaceClass, false) 。

参数类型

T - 允许编译器知道，例如，如果 interfaceClass参数为 MyMXBean.class ，则返回类型为 MyMXBean 。

参数

connection - 要转发到的MBean服务器。

objectName - 要转发到的 connection内的MBean的名称。

interfaceClass - MXBean接口，也将由返回的代理实现。

结果

新的代理实例。

异常

IllegalArgumentException - 如果interfaceClass不是compliant MXBean interface

newMXBeanProxy

public static <T> T newMXBeanProxy(MBeanServerConnection connection,
                                   ObjectName objectName,
                                   类<T> interfaceClass,
                                   boolean notificationEmitter)

为本地或远程MBean Server中的MXBean创建代理，该服务器也可能支持NotificationEmitter的方法。

此方法与newMXBeanProxy(MBeanServerConnection, ObjectName, Class)的行为相同，但另外，如果notificationEmitter是true ，则假定MXBean为NotificationBroadcaster或NotificationEmitter ，返回的代理将实现NotificationEmitter以及interfaceClass 。 在代理上调用NotificationBroadcaster.addNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)将导致调用MBeanServerConnection.addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object) ，同样对NotificationBroadcaster和NotificationEmitter的其他方法调用 。

参数类型

T - 允许编译器知道，如果 interfaceClass参数为 MyMXBean.class ，则返回类型为 MyMXBean 。

参数

connection - 要转发到的MBean服务器。

objectName - 要转发到的 connection内的MBean的名称。

interfaceClass - MXBean接口，也将由返回的代理实现。

notificationEmitter -使返回的代理实现NotificationEmitter经由其方法转发connection 。

结果

新的代理实例。

异常

IllegalArgumentException - 如果interfaceClass不是compliant MXBean interface

isMXBeanInterface

public static boolean isMXBeanInterface(类<?> interfaceClass)

测试接口是否是MXBean接口。 接口是MXBean接口，如果它是公共的，注释为@MXBean或@MXBean(true)或者如果它没有@MXBean注释，并且其名称以“ MXBean ”结尾。

参数

interfaceClass - 候选界面。

结果

如果interfaceClass是compliant MXBean interface，则为true

异常

NullPointerException - 如果 interfaceClass为空。