compact3

javax.management.modelmbean

Class ModelMBeanInfoSupport

java.lang.Object

javax.management.MBeanInfo

javax.management.modelmbean.ModelMBeanInfoSupport

All Implemented Interfaces:

Serializable， Cloneable， DescriptorRead， ModelMBeanInfo

public class ModelMBeanInfoSupport
extends MBeanInfo
implements ModelMBeanInfo

这类表示modelmbeans元数据。元数据对象上已添加的描述符。

java资源希望能够实例化ModelMBean MBeanServer creatembean方法的使用。资源建立了ModelMBeanInfo和描述符为ModelMBean实例。属性和操作通过ModelMBean ModelMBeanInfo暴露可从MBean，连接器/适配器像其他MBeans。通过描述，在托管的应用价值和方法可以被定义和映射到的ModelMBean属性和操作。这个映射可以定义在一个文件或程序在运行时动态的发展过程中。

这是每个ModelMBean MBeanServer实例化成为可控的：它的属性和操作成为远程访问连接，通过MBeanServer连接器/适配器。一个java对象不能注册MBeanServer除非是JMX兼容MBean。通过实例化一个ModelMBean，资源保证MBean是有效的。mbeanexception和runtimeoperationsexception必须扔在每个公共方法。这使得包装从分布式通信异常（RMI、EJB、等）

这个班的serialVersionUID是-1935722590756516193L。

从以下版本开始：

一点五

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor and Description
ModelMBeanInfoSupport(ModelMBeanInfo mbi) 构建ModelMBeanInfoSupport是给定ModelMBeanInfo重复。
ModelMBeanInfoSupport(String className, String description, ModelMBeanAttributeInfo[] attributes, ModelMBeanConstructorInfo[] constructors, ModelMBeanOperationInfo[] operations, ModelMBeanNotificationInfo[] notifications) 创建一个modelmbeaninfosupport与所提供的信息，但该描述符是一个默认的。
ModelMBeanInfoSupport(String className, String description, ModelMBeanAttributeInfo[] attributes, ModelMBeanConstructorInfo[] constructors, ModelMBeanOperationInfo[] operations, ModelMBeanNotificationInfo[] notifications, Descriptor mbeandescriptor) 创建一个与所提供的信息，给出了参数的广义modelmbeaninfosupport。

方法摘要

Modifier and Type	Method and Description
Object	clone() 返回此实例的浅克隆。
ModelMBeanAttributeInfo	getAttribute(String inName) 返回请求的名称modelmbeanattributeinfo。
ModelMBeanConstructorInfo	getConstructor(String inName) 返回请求的名字的modelmbeanconstructorinfo。
Descriptor	getDescriptor() 得到这个mbeaninfo描述符。
Descriptor	getDescriptor(String inDescriptorName) 返回由名称所请求的描述符。
Descriptor	getDescriptor(String inDescriptorName, String inDescriptorType) 返回的名称和descriptortype请求描述符。
Descriptor[]	getDescriptors(String inDescriptorType) 返回一个描述符阵列组成的所有描述符的类型indescriptortype ModelMBeanInfo。
Descriptor	getMBeanDescriptor() 返回的描述符包含MBean ModelMBean宽政策。
ModelMBeanNotificationInfo	getNotification(String inName) 返回请求的名称modelmbeannotificationinfo。
ModelMBeanOperationInfo	getOperation(String inName) 返回请求的名称modelmbeanoperationinfo。
void	setDescriptor(Descriptor inDescriptor, String inDescriptorType) 集描述为ModelMBean型indescriptortype信息阵。
void	setDescriptors(Descriptor[] inDescriptors) 添加或更换在ModelMBeanInfo描述符。
void	setMBeanDescriptor(Descriptor inMBeanDescriptor) 集ModelMBean的描述符。

Methods inherited from class javax.management.MBeanInfo

equals, getAttributes, getClassName, getConstructors, getDescription, getNotifications, getOperations, hashCode, toString

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface javax.management.modelmbean.ModelMBeanInfo

getAttributes, getClassName, getConstructors, getDescription, getNotifications, getOperations

Constructor Detail

ModelMBeanInfoSupport

public ModelMBeanInfoSupport(ModelMBeanInfo mbi)

构建ModelMBeanInfoSupport是给定ModelMBeanInfo重复。返回的对象是给定对象的一个浅拷贝。无论是广义还是包含阵列（ ModelMBeanAttributeInfo[]等）进行克隆。该方法主要是对修改返回的实例的描述通过 setDescriptor不影响原来的对象描述符。

参数

mbi - ModelMBeanInfo实例的创建初始化ModelMBeanInfo。

ModelMBeanInfoSupport

public ModelMBeanInfoSupport(String className,
                             String description,
                             ModelMBeanAttributeInfo[] attributes,
                             ModelMBeanConstructorInfo[] constructors,
                             ModelMBeanOperationInfo[] operations,
                             ModelMBeanNotificationInfo[] notifications)

创建一个modelmbeaninfosupport与所提供的信息，但该描述符是一个默认的。默认的描述是：名称= className，descriptortype =“MBean，DisplayName = className，persistpolicy =“从不”，日志=“F”，知名度=“1”

参数

className - MBean类名

description - ModelMBean人类可读的描述

attributes阵列具有modelmbeanattributeinfo对象描述符

constructors阵列具有modelmbeanconstructorinfo对象描述符

operations阵列具有modelmbeanoperationinfo对象描述符

notifications阵列具有modelmbeannotificationinfo对象描述符

ModelMBeanInfoSupport

public ModelMBeanInfoSupport(String className,
                             String description,
                             ModelMBeanAttributeInfo[] attributes,
                             ModelMBeanConstructorInfo[] constructors,
                             ModelMBeanOperationInfo[] operations,
                             ModelMBeanNotificationInfo[] notifications,
                             Descriptor mbeandescriptor)

创建一个与所提供的信息，给出了参数的广义modelmbeaninfosupport。

参数

className - MBean类名

description - ModelMBean人类可读的描述

attributes阵列具有modelmbeanattributeinfo对象描述符

constructors阵列具有modelmbeanconstructorinfo对象描述符

operations阵列具有modelmbeanoperationinfo对象描述符

notifications阵列具有modelmbeannotificationinfo对象描述符

mbeandescriptor描述符作为含MBean的广泛政策mbeandescriptor。如果描述符是空的，将构造一个默认的描述符。默认的描述是：名称= className，descriptortype =“MBean，DisplayName = className，persistpolicy =“从不”，日志=“F”，知名度=“1”。如果描述符不包含所有这些字段，则在这些默认值中添加丢失的字段。

异常

RuntimeOperationsException包无效描述符传递参数时。（看到一个有效的MBean描述符的定义 getMBeanDescriptor）

方法详细信息

clone

public Object clone()

返回此实例的浅克隆。无论是广义还是包含阵列（ ModelMBeanAttributeInfo[]等）进行克隆。该方法主要是对修改的克隆通过 setDescriptor描述符不影响原来的对象描述符。

Specified by:

clone 接口 ModelMBeanInfo

重写：

clone 方法重写，继承类 MBeanInfo

结果

这个实例的浅克隆。

另请参见：

Cloneable

getDescriptors

public Descriptor[] getDescriptors(String inDescriptorType)
                            throws MBeanException,
                                   RuntimeOperationsException

从接口复制的描述： ModelMBeanInfo

返回一个描述符阵列组成的所有描述符的类型indescriptortype ModelMBeanInfo。

Specified by:

getDescriptors 接口 ModelMBeanInfo

参数

inDescriptorType值descriptortype场必须设置为描述符被退回。必须“MBean”、“属性”、“操作”、“构造函数”或“通知”。如果它是空的或空的，那么所有类型将被返回。

结果

描述符数组包含的所有描述符如果型indescriptortype ModelMBean。

异常

MBeanException套分布式通信异常。

RuntimeOperationsException -包装时在参数descriptortype不是一个：“MBean”、“属性”、“操作”、“建设者”、“通知”，空。

另请参见：

ModelMBeanInfo.setDescriptors(javax.management.Descriptor[])

setDescriptors

public void setDescriptors(Descriptor[] inDescriptors)
                    throws MBeanException,
                           RuntimeOperationsException

从接口复制的描述： ModelMBeanInfo

添加或更换在ModelMBeanInfo描述符。

Specified by:

setDescriptors 接口 ModelMBeanInfo

参数

inDescriptors -被设置在ModelMBeanInfo描述符。列表的空元素将被忽略。所有的描述符的名称必须和descriptortype领域。

异常

MBeanException套分布式通信异常。

RuntimeOperationsException包为空或无效描述符IllegalArgumentException。

另请参见：

ModelMBeanInfo.getDescriptors(java.lang.String)

getDescriptor

public Descriptor getDescriptor(String inDescriptorName)
                         throws MBeanException,
                                RuntimeOperationsException

返回由名称所请求的描述符。

参数

inDescriptorName -描述符的名字。

结果

包含一个同名的ModelMBean描述符的描述符。如果没有找到描述符，则返回。

异常

MBeanException套分布式通信异常。

RuntimeOperationsException包空的名字时。

另请参见：

setDescriptor(javax.management.Descriptor, java.lang.String)

getDescriptor

public Descriptor getDescriptor(String inDescriptorName,
                                String inDescriptorType)
                         throws MBeanException,
                                RuntimeOperationsException

从接口复制的描述： ModelMBeanInfo

返回的名称和descriptortype请求描述符。

Specified by:

getDescriptor 接口 ModelMBeanInfo

参数

inDescriptorName -描述符的名字。

inDescriptorType -描述符请求类型。如果这是空的或空的，那么所有类型都被搜索。有效的类型的MBean '，'属性'，'构造函数'操作'，和'通知'。此值将等于在描述符，返回“descriptortype”字段。

结果

包含具有相同的名称和descriptortype ModelMBean描述符的描述符。如果没有找到描述符，则返回。

异常

MBeanException套分布式通信异常。

RuntimeOperationsException包为空描述符名称或空的或无效的类型时。类型必须是“管理”、“属性”、“建设者”、“操作”，或“通知”。

另请参见：

ModelMBeanInfo.setDescriptor(javax.management.Descriptor, java.lang.String)

setDescriptor

public void setDescriptor(Descriptor inDescriptor,
                          String inDescriptorType)
                   throws MBeanException,
                          RuntimeOperationsException

从接口复制的描述： ModelMBeanInfo

集描述为ModelMBean型indescriptortype信息阵。相应的信息setdescriptor ModelMBean *的方法来设置指定的描述符。

Specified by:

setDescriptor 接口 ModelMBeanInfo

参数

inDescriptor的描述符被设置在ModelMBean。它不能为空。所有的描述符的名称必须和descriptortype领域。

inDescriptorType的描述符被设置的类型。如果这是零那么描述符中的descriptortype场用。如果指定此值必须在描述中descriptortype字段集。必须“MBean”、“属性”、“建设者”、“操作”，或“通知”。

异常

MBeanException套分布式通信异常。

RuntimeOperationsException包非法或空参数或者广义的名称字段不在相应的mbeanattributeinfo或mbeanconstructorinfo或mbeannotificationinfo或mbeanoperationinfo发现时。

另请参见：

ModelMBeanInfo.getDescriptor(java.lang.String, java.lang.String)

getAttribute

public ModelMBeanAttributeInfo getAttribute(String inName)
                                     throws MBeanException,
                                            RuntimeOperationsException

从接口复制的描述： ModelMBeanInfo

返回请求的名称modelmbeanattributeinfo。

Specified by:

getAttribute 接口 ModelMBeanInfo

参数

inName - ModelMBeanAttributeInfo的名字取得。如果这个名字没有modelmbeanattributeinfo存在返回。

结果

属性信息的命名属性，或无效，如果没有。

异常

MBeanException套分布式通信异常。

RuntimeOperationsException包为空属性的名字时。

getOperation

public ModelMBeanOperationInfo getOperation(String inName)
                                     throws MBeanException,
                                            RuntimeOperationsException

从接口复制的描述： ModelMBeanInfo

返回请求的名称modelmbeanoperationinfo。

Specified by:

getOperation 接口 ModelMBeanInfo

参数

inName - ModelMBeanOperationInfo的名字取得。如果这个名字没有modelmbeanoperationinfo存在返回。

结果

用于命名操作的操作信息，或者如果没有。

异常

MBeanException套分布式通信异常。

RuntimeOperationsException包为空操作名称IllegalArgumentException。

getConstructor

public ModelMBeanConstructorInfo getConstructor(String inName)
                                         throws MBeanException,
                                                RuntimeOperationsException

返回请求的名字的modelmbeanconstructorinfo。如果这个名字没有modelmbeanconstructorinfo存在返回。

参数

inName -构造函数的名字。

结果

如果没有任何函数，则为所命名的构造函数的构造函数信息。

异常

MBeanException套分布式通信异常。

RuntimeOperationsException包的一个空的构造函数的名字时。

getNotification

public ModelMBeanNotificationInfo getNotification(String inName)
                                           throws MBeanException,
                                                  RuntimeOperationsException

从接口复制的描述： ModelMBeanInfo

返回请求的名称modelmbeannotificationinfo。

Specified by:

getNotification 接口 ModelMBeanInfo

参数

inName - ModelMBeanNotificationInfo的名字取得。如果这个名字没有modelmbeannotificationinfo存在返回。

结果

指定的通知的信息，或为空，如果没有。

异常

MBeanException套分布式通信异常。

RuntimeOperationsException包为空通知名IllegalArgumentException。

getDescriptor

public Descriptor getDescriptor()

从阶级复制的描述： MBeanInfo

得到这个mbeaninfo描述符。更改返回的值将不会对原始描述符产生影响。

Specified by:

getDescriptor 接口 DescriptorRead

重写：

getDescriptor 方法重写，继承类 MBeanInfo

结果

一个描述符，它要么是不变的，要么是一个原始的副本。

从以下版本开始：

一点六

getMBeanDescriptor

public Descriptor getMBeanDescriptor()
                              throws MBeanException

从接口复制的描述： ModelMBeanInfo

返回的描述符包含MBean ModelMBean宽政策。这个描述符包含关于持久MBean和默认策略和缓存元数据。

描述符中的字段被定义，但不限于以下几个字段。请注意，当此表中的类型是数字时，也可以使用一个长的十进制表示形式的字符串。

Name	Type	Meaning
name	String	MBean name.
descriptorType	String	Must be "mbean".
displayName	String	Name of MBean to be used in displays.
persistPolicy	String	One of: OnUpdate|OnTimer|NoMoreOftenThan|OnUnregister|Always|Never. See the section "MBean Descriptor Fields" in the JMX specification document.
persistLocation	String	The fully qualified directory name where the MBean should be persisted (if appropriate).
persistFile	String	File name into which the MBean should be persisted.
persistPeriod	Number	Frequency of persist cycle in seconds, for OnTime and NoMoreOftenThan PersistPolicy
currencyTimeLimit	Number	How long cached value is valid: <0 never, =0 always, >0 seconds.
log	String	t: log all notifications, f: log no notifications.
logfile	String	Fully qualified filename to log events to.
visibility	Number	1-4 where 1: always visible 4: rarely visible.
export	String	Name to be used to export/expose this MBean so that it is findable by other JMX Agents.
presentationString	String	XML formatted string to allow presentation of data to be associated with the MBean.

默认的描述是：名称= className，descriptortype =“MBean，DisplayName = className，persistpolicy =“从不”，日志=“F”，可视为“1”如果描述不包含所有的这些领域，他们将加入这些默认值。

注：由于在本规范的早期版本不一致，建议不要使用负数或零值currencyTimeLimit。显示缓存的值是永远有效，省略currencyTimeLimit场。为了表示它始终是有效的，为这个字段使用一个非常大的数字。

Specified by:

getMBeanDescriptor 接口 ModelMBeanInfo

结果

MBean描述符。

异常

MBeanException套分布式通信异常。

另请参见：

ModelMBeanInfo.setMBeanDescriptor(javax.management.Descriptor)

setMBeanDescriptor

public void setMBeanDescriptor(Descriptor inMBeanDescriptor)
                        throws MBeanException,
                               RuntimeOperationsException

从接口复制的描述： ModelMBeanInfo

集ModelMBean的描述符。这个描述符包含默认，MBean元数据广泛持久MBean和默认策略和缓存。此操作完成了描述符的完整替换，没有完成合并。如果要设置为是为空的描述符，则将创建默认的描述符。默认的描述是：名称= className，descriptortype =“MBean，DisplayName = className，persistpolicy =“从不”，日志=“F”，可视为“1”如果描述不包含所有的这些领域，他们将加入这些默认值。看到有效的字段名称描述方法 getMBeanDescriptor javadoc。

Specified by:

setMBeanDescriptor 接口 ModelMBeanInfo

参数

inMBeanDescriptor的描述符集。

异常

MBeanException套分布式通信异常。

RuntimeOperationsException包描述符无效时。

另请参见：

ModelMBeanInfo.getMBeanDescriptor()