模块 java.management

软件包 javax.management.modelmbean

Interface ModelMBean

All Superinterfaces:

DynamicMBean ， ModelMBeanNotificationBroadcaster ， NotificationBroadcaster ， PersistentMBean

所有已知实现类：

RequiredModelMBean

public interface ModelMBean
extends DynamicMBean, PersistentMBean, ModelMBeanNotificationBroadcaster

此接口必须由ModelMBeans实现。 每个JMX代理都必须附带此接口的实现。

希望可管理的Java资源使用MBeanServer的createMBean方法实例化ModelMBean。 然后，资源为ModelMBean实例设置ModelMBeanInfo（带有描述符）。 可以从MBean，连接器/适配器（如其他MBean）访问通过ModelMBean的ModelMBeanInfo公开的属性和操作。 通过ModelMBeanInfo描述符，可以定义托管应用程序中的值和方法，并将其映射到ModelMBean的属性和操作。 此映射可以在开发期间在XML格式的文件中定义，也可以在运行时以动态和编程方式定义。

在MBeanServer中实例化的每个ModelMBean都变得易于管理：其属性和操作可通过连接到该MBeanServer的连接器/适配器远程访问。 除非符合JMX的MBean，否则无法在MBeanServer中注册Java对象。 通过实例化ModelMBean，可以保证MBean的有效性。

必须在每个公共方法上抛出MBeanException和RuntimeOperationsException。 这允许从分布式通信（RMI，EJB等）中包装异常。 除了在规范和javadoc中描述的场景之外，实现不必抛出这些异常。

从以下版本开始：

1.5

方法摘要

变量和类型	方法	描述
void	setManagedResource(Object mr, String mr_type)	设置对象的实例句柄，以便在此ModelMBean管理接口（MBeanInfo和Descriptors）中执行所有方法。
void	setModelMBeanInfo(ModelMBeanInfo inModelMBeanInfo)	使用传入的ModelMBeanInfo初始化ModelMBean对象。

声明方法的接口 javax.management.DynamicMBean

getAttribute, getAttributes, getMBeanInfo, invoke, setAttribute, setAttributes

声明方法的接口 javax.management.modelmbean.ModelMBeanNotificationBroadcaster

addAttributeChangeNotificationListener, removeAttributeChangeNotificationListener, sendAttributeChangeNotification, sendAttributeChangeNotification, sendNotification, sendNotification

声明方法的接口 javax.management.NotificationBroadcaster

addNotificationListener, getNotificationInfo, removeNotificationListener

声明方法的接口 javax.management.PersistentMBean

load, store

方法详细信息

setModelMBeanInfo

void setModelMBeanInfo(ModelMBeanInfo inModelMBeanInfo)
                throws MBeanException,
                       RuntimeOperationsException

使用传入的ModelMBeanInfo初始化ModelMBean对象。只要没有向MBeanServer注册，此方法就可以在ModelMBean上设置自定义的ModelMBeanInfo。
一旦ModelMBean的ModelMBeanInfo（带有描述符）被自定义并在ModelMBean上设置，ModelMBean就可以在MBeanServer中注册。

如果ModelMBean当前已注册，则此方法抛出RuntimeOperationsException包装IllegalStateException

参数

inModelMBeanInfo - ModelMBean要使用的ModelMBeanInfo对象。

异常

MBeanException - 包装分布式通信异常。

RuntimeOperationsException -

• 如果传入参数的MBeanInfo为null，则包含IllegalArgumentException 。
• 如果ModelMBean当前在MBeanServer中注册，则包含IllegalStateException 。

setManagedResource

void setManagedResource(Object mr,
                        String mr_type)
                 throws MBeanException,
                        RuntimeOperationsException,
                        InstanceNotFoundException,
                        InvalidTargetObjectTypeException

设置对象的实例句柄，以便在此ModelMBean管理接口（MBeanInfo和Descriptors）中执行所有方法。

参数

mr - 作为受管资源的对象

mr_type - 受管资源的引用类型。 可以是：ObjectReference，Handle，IOR，EJBHandle，RMIReference。 如果MBeanServer无法处理传入的mr_type，则将抛出InvalidTargetTypeException。

异常

MBeanException - 对象的初始值设定项引发了异常。

RuntimeOperationsException - 包装IllegalArgumentException：参数中传递的受管资源类型为null。

InstanceNotFoundException - 找不到托管资源对象

InvalidTargetObjectTypeException - ModelMBean或JMX代理无法处理受管资源类型。