模块  java.management
软件包  javax.management

Class MBeanInfo

  • 实现的所有接口
    SerializableCloneableDescriptorRead
    已知直接子类:
    ModelMBeanInfoSupportOpenMBeanInfoSupport

    public class MBeanInfo
    extends Object
    implements Cloneable, Serializable, DescriptorRead

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

    通常,任何给定MBean的MBeanInfo在该MBean的生命周期内不会发生变化。 动态MBean可以改变他们的MBeanInfo ,并在这种情况下,建议他们发出Notificationtype"jmx.mbean.info.changed"userData是新MBeanInfo 这不是必需的,但为MBean的客户端提供了传统方法来发现更改。 又见immutableInfoinfoTimeout在田里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