站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

JMX (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

概述  软件包   类  使用  树  已过时  索引  帮助 
JavaTM Platform
Standard Ed. 6
 上一个类   下一个类 框架    无框架    
摘要： 嵌套 | 字段 | 构造方法 | 方法 详细信息： 字段 | 构造方法 | 方法

javax.management
类 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(Class<?> interfaceClass)
          测试某接口是否是 MXBean 接口。
static
<T> T
newMBeanProxy(MBeanServerConnection connection, ObjectName objectName, Class<T> interfaceClass)
          在本地或远程 MBean Server 中为 Standard MBean 构造一个代理。
static
<T> T
newMBeanProxy(MBeanServerConnection connection, ObjectName objectName, Class<T> interfaceClass, boolean notificationBroadcaster)
          在同样支持 NotificationEmitter 方法的本地或远程 MBean Server 中为 Standard MBean 构造一个代理。
static
<T> T
newMXBeanProxy(MBeanServerConnection connection, ObjectName objectName, Class<T> interfaceClass)
          在本地或远程 MBean Server 中为 MXBean 构造一个代理。
static
<T> T
newMXBeanProxy(MBeanServerConnection connection, ObjectName objectName, Class<T> interfaceClass, boolean notificationBroadcaster)
          在同样支持 NotificationEmitter 方法的本地或远程 MBean Server 中为 MXBean 构造一个代理。
 
从类 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,
                                  Class<T> interfaceClass)

在本地或远程 MBean Server 中为 Standard MBean 构造一个代理。

如果 MBean 服务器 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);
 }

那么可以执行：

  • 将导致调用 mbs.getAttribute(name, &quot;SomeAttribute&quot;) 的 proxy.getSomeAttribute()。
  • 将导致调用 mbs.setAttribute(name, new Attribute(&quot;SomeAttribute&quot;, &quot;whatever&quot;)) 的 proxy.setSomeAttribute(&quot;whatever&quot;)。
  • 将转换为对 mbs.invoke(name, &quot;someOperation&quot;, <etc>) 的调用的 proxy.someOperation(&quot;param1&quot;, 2)。

此方法返回的对象是一个其 InvocationHandler 为 MBeanServerInvocationHandler 的 Proxy。

此方法等效于 newMBeanProxy(connection, objectName, interfaceClass, false)。

类型参数：
T - 让编译器知道如果 interfaceClass 参数为 MyMBean.class，则返回类型为 MyMBean。
参数：
connection - 作为转发目的地的目标 MBean 服务器。
objectName - 作为转发目的地的 connection 中的 MBean 名。
interfaceClass - MBean 输出的管理接口，也由返回的代理来实现。
返回：
新的代理实例。

newMBeanProxy

public static <T> T newMBeanProxy(MBeanServerConnection connection,
                                  ObjectName objectName,
                                  Class<T> interfaceClass,
                                  boolean notificationBroadcaster)

在同样支持 NotificationEmitter 方法的本地或远程 MBean Server 中为 Standard MBean 构造一个代理。

此方法的行为与 newMBeanProxy(MBeanServerConnection, ObjectName, Class) 相同，但除此以外，如果 notificationBroadcaster 为 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 输出的管理接口，也由返回的代理来实现。
notificationBroadcaster - 使返回的代理实现 NotificationEmitter，方法是通过 connection 转发其方法。
返回：
新的代理实例。

newMXBeanProxy

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

在本地或远程 MBean Server 中为 MXBean 构造一个代理。

如果 MBean 服务器 mbs 包含 ObjectName 为 name 的 MXBean，并且如果该 MXBean 的管理接口由 Java 接口 MyMXBean 所描述，则可以像下面这样为该 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, &quot;SimpleAttribute&quot;)。

  • proxy.setSimpleAttribute(&quot;whatever&quot;) 将导致调用 mbs.setAttribute(name, new Attribute("SimpleAttribute", "whatever"))。

    因为 String 是一个简单类型（即 SimpleType），所以不会在 MXBean 的上下文中更改它。MXBean 代理的行为与属性 SimpleAttribute 的 Standard MBean 代理（请参阅 newMBeanProxy）的行为相同。

  • proxy.getMappedAttribute() 将导致调用 mbs.getAttribute(&quot;MappedAttribute&quot;)。MXBean 映射规则意味着属性 MappedAttribute 的实际类型将是 CompositeData，并且这是 mbs.getAttribute 调用将返回的内容。该代理然后会使用 MXBean 映射规则将 CompositeData 转换回所期望类型的 MemoryUsage。

  • 类似地，proxy.setMappedAttribute(memoryUsage) 将在调用 mbs.setAttribute 之前将 MemoryUsage 参数转换为 CompositeData。

  • proxy.someOperation(&quot;whatever&quot;, memoryUsage) 将 MemoryUsage 参数转换为 CompositeData 并调用 mbs.invoke。mbs.invoke 返回的值也将是 CompositeData，并且代理会使用 MXBean 映射规则将此值转换为所期望类型的 MemoryUsage。

此方法返回的对象是一个 InvocationHandler 为 MBeanServerInvocationHandler 的 Proxy。

此方法等效于 newMXBeanProxy(connection, objectName, interfaceClass, false)。

类型参数：
T - 让编译器知道如果 interfaceClass 参数为 MyMXBean.class，则返回类型为 MyMXBean。
参数：
connection - 作为转发目的地的目标 MBean 服务器。
objectName - 作为转发目的地的 connection 中的 MBean 名。
interfaceClass - MXBean 接口，也由返回的代理来实现。
返回：
新的代理实例。

newMXBeanProxy

public static <T> T newMXBeanProxy(MBeanServerConnection connection,
                                   ObjectName objectName,
                                   Class<T> interfaceClass,
                                   boolean notificationBroadcaster)

在同样支持 NotificationEmitter 方法的本地或远程 MBean Server 中为 MXBean 构造一个代理。

此方法的行为与 newMXBeanProxy(MBeanServerConnection, ObjectName, Class) 相同，但除此以外，如果 notificationBroadcaster 为 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 接口，也由返回的代理来实现。
notificationBroadcaster - 使返回的代理实现 NotificationEmitter，方法是通过 connection 转发它的方法。
返回：
新的代理实例。

isMXBeanInterface

public static boolean isMXBeanInterface(Class<?> interfaceClass)

测试某接口是否是 MXBean 接口。如果接口为已注释的 @MXBean 或 @MXBean(true)，或者接口没有 @MXBean 注释且其名称以 "MXBean" 结尾，则该接口为 MXBean 接口。

参数：
interfaceClass - 侯选接口。
返回：
如果 interfaceClass 是一个接口且满足所描述的条件，则返回 true。
抛出：
NullPointerException - 如果 interfaceClass 为 null。
概述  软件包   类  使用  树  已过时  索引  帮助 
JavaTM Platform
Standard Ed. 6
 上一个类   下一个类 框架    无框架    
摘要： 嵌套 | 字段 | 构造方法 | 方法 详细信息： 字段 | 构造方法 | 方法
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。