模块  java.management
软件包  javax.management

Class MBeanInfo

  • 实现的所有接口
    Serializable ， Cloneable ， DescriptorRead
    已知直接子类：
    ModelMBeanInfoSupport ， OpenMBeanInfoSupport 
    public class MBeanInfo
extends Object
implements Cloneable, Serializable, DescriptorRead

    描述MBean公开的管理接口; 也就是说，可用于管理操作的属性和操作集。 此类的实例是不可变的。 子类可能是可变的，但不建议这样做。

    通常，任何给定MBean的MBeanInfo在该MBean的生命周期内不会发生变化。 动态MBean可以改变他们的MBeanInfo ，并在这种情况下，建议他们发出Notification有type的"jmx.mbean.info.changed"和userData是新MBeanInfo 。 这不是必需的，但为MBean的客户端提供了传统方法来发现更改。 又见immutableInfo个infoTimeout在田里MBeanInfo Descriptor 。

    动态MBean的MBeanInfo的内容由其getMBeanInfo()方法确定。 这包括Open MBean和Model MBean，它们是各种Dynamic MBean。

    标准MBean的MBeanInfo的内容由MBean服务器确定，如下所示：

    未指定由getDescription()返回的描述以及所包含的属性和操作的描述。

    未指定标准MBean的MBeanInfo的其余详细信息。 这包括任何包含的构造函数和通知的描述; 构造函数和操作的参数名称; 和构造函数参数的描述。

    从以下版本开始：
    1.5
    另请参见：
    Serialized Form

    • 构造方法详细信息

      • MBeanInfo

        public MBeanInfo​(String className,
                 String description,
                 MBeanAttributeInfo[] attributes,
                 MBeanConstructorInfo[] constructors,
                 MBeanOperationInfo[] operations,
                 MBeanNotificationInfo[] notifications)
          throws IllegalArgumentException
        构造一个 MBeanInfo 。
        参数
        className - 此MBeanInfo描述的MBean的Java类的名称。 此值可以是任何语法上合法的Java类名。 它不必是MBean服务器或MBean的ClassLoader已知的Java类。 如果它是MBean的ClassLoader已知的Java类，则建议但不要求该类的公共方法包括那些将出现在实现此MBeanInfo中的属性和操作的Standard MBean中的方法。
        description - MBean的可读描述（可选）。
        attributes - MBean的公开属性列表。 这可能为null，与零长度数组具有相同的效果。
        constructors - MBean的公共构造函数列表。 这可能为null，与零长度数组具有相同的效果。
        operations - MBean的操作列表。 这可能为null，与零长度数组具有相同的效果。
        notifications - 发出的通知列表。 这可能为null，与零长度数组具有相同的效果。
        异常
        IllegalArgumentException

      • MBeanInfo

        public MBeanInfo​(String className,
                 String description,
                 MBeanAttributeInfo[] attributes,
                 MBeanConstructorInfo[] constructors,
                 MBeanOperationInfo[] operations,
                 MBeanNotificationInfo[] notifications,
                 Descriptor descriptor)
          throws IllegalArgumentException
        构造一个 MBeanInfo 。
        参数
        className - 此MBeanInfo描述的MBean的Java类的名称。 此值可以是任何语法上合法的Java类名。 它不必是MBean服务器或MBean的ClassLoader已知的Java类。 如果它是MBean的ClassLoader已知的Java类，则建议但不要求该类的公共方法包括那些将出现在实现此MBeanInfo中的属性和操作的Standard MBean中的方法。
        description - MBean的可读描述（可选）。
        attributes - MBean的公开属性列表。 这可能为null，与零长度数组具有相同的效果。
        constructors - MBean的公共构造函数列表。 这可能为null，与零长度数组具有相同的效果。
        operations - MBean的操作列表。 这可能为null，与零长度数组具有相同的效果。
        notifications - 发出的通知列表。 这可能为null，与零长度数组具有相同的效果。
        descriptor - MBean的描述符。 这可以是null，这相当于空描述符。
        异常
        IllegalArgumentException
        从以下版本开始：
        1.6

    • 方法详细信息

      • clone

        public Object clone()

        返回此实例的浅层克隆。 通过简单地调用super.clone()获得克隆，从而调用由Object.clone()实现的默认本机浅克隆机制。 没有对任何内部字段进行更深入的克隆。

        由于此类是不可变的，因此克隆方法主要是子类感兴趣的。

        重写：
        clone在类 Object
        结果
        这个实例的克隆。
        另请参见：
        Cloneable

      • getClassName

        public String getClassName()
        返回此 MBeanInfo描述的MBean的Java类的名称。
        结果
        班级名称。

      • getDescription

        public String getDescription()
        返回MBean的可读描述。
        结果
        说明。

      • getAttributes

        public MBeanAttributeInfo[] getAttributes()
        返回为管理公开的属性列表。 每个属性由MBeanAttributeInfo对象描述。 返回的数组是内部数组的浅表副本，这意味着它是对MBeanAttributeInfo对象的内部引用数组的副本，但不会复制每个引用的MBeanAttributeInfo对象。
        结果
        一组 MBeanAttributeInfo对象。

      • getOperations

        public MBeanOperationInfo[] getOperations()
        返回MBean的操作列表。 每个操作由MBeanOperationInfo对象描述。 返回的数组是内部数组的浅表副本，这意味着它是对MBeanOperationInfo对象的内部引用数组的副本，但不会复制每个引用的MBeanOperationInfo对象。
        结果
        一组 MBeanOperationInfo对象。

      • getConstructors

        public MBeanConstructorInfo[] getConstructors()

        返回MBean的公共构造函数列表。 每个构造函数由MBeanConstructorInfo对象描述。

        返回的数组是内部数组的浅表副本，这意味着它是对MBeanConstructorInfo对象的内部引用数组的副本，但不会复制每个引用的对象MBeanConstructorInfo 。

        返回的列表不一定是详尽无遗的。 也就是说，MBean可能具有不在列表中的公共构造函数。 在这种情况下，MBean服务器可以使用该构造函数构造此MBean类的另一个实例，即使它未在此处列出。

        结果
        一组 MBeanConstructorInfo对象。

      • getNotifications

        public MBeanNotificationInfo[] getNotifications()
        返回MBean发出的通知列表。 每个通知由MBeanNotificationInfo对象描述。 返回的数组是内部数组的浅表副本，这意味着它是对MBeanNotificationInfo对象的内部引用数组的副本，但不会复制每个引用的MBeanNotificationInfo对象。
        结果
        一组 MBeanNotificationInfo对象。

      • getDescriptor

        public Descriptor getDescriptor()
        获取此MBeanInfo的描述符。 更改返回值将不会影响原始描述符。
        Specified by:
        getDescriptor接口 DescriptorRead
        结果
        描述符是不可变的或原始的副本。
        从以下版本开始：
        1.6