Класс ModelMBeanInfoSupport

java.lang.Object
- javax.management.MBeanInfo
- - javax.management.modelmbean.ModelMBeanInfoSupport

Все реализуемые интерфейсы:: Serializable, Cloneable, DescriptorRead, ModelMBeanInfo

public class ModelMBeanInfoSupport
extends MBeanInfo
implements ModelMBeanInfo

Этот класс представляет метаданные для ModelMBean. Дескрипторы были добавлены к объектам метаданных.

Java-ресурсы, желающие быть управляемыми, инициализируют ModelMBean с помощью метода createMBean сервера управления MBean. Затем ресурс устанавливает ModelMBeanInfo и дескрипторы для экземпляра ModelMBean. Атрибуты и операции, доступные через ModelMBeanInfo для ModelMBean, доступны из MBean, коннекторов/адаптеров, как и другие MBean. Через дескрипторы можно определить и сопоставить значения и методы в управляемом приложении с атрибутами и операциями ModelMBean. Это сопоставление может быть определено во время разработки в файле или динамически и программно во время выполнения.

Каждый ModelMBean, который инициализирован на сервере управления MBean, становится управляемым: его атрибуты и операции становятся удалённо доступными через коннекторы/адаптеры, подключенные к этому серверу управления MBean. Объект Java не может быть зарегистрирован на сервере управления MBean, если он не является совместимым с JMX MBean. Инициализация ModelMBean гарантирует, что MBean является валидным. MBeanException и RuntimeOperationsException должны быть брошены в каждом публичном методе. Это позволяет обернуть исключения из распределённых коммуникаций (RMI, EJB и т.д.).

serialVersionUID этого класса — -1935722590756516193L.

С момента:: 1.5
См. также:: Сериализованная форма

Конструкторы

Конструктор	Описание
`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 с предоставленной информацией и дескриптором, переданным в параметре.
`ModelMBeanInfoSupport(ModelMBeanInfo mbi)`	Создаёт ModelMBeanInfoSupport, являющийся дубликатом указанного ModelMBeanInfo.

Методы

Модификатор и тип	Метод	Описание
`Object`	`clone()`	Возвращает неглубокую копию этого экземпляра.
`ModelMBeanConstructorInfo`	`getConstructor(String inName)`	Возвращает ModelMBeanConstructorInfo, запрошенный по имени.
`Descriptor`	`getDescriptor()`	Получает дескриптор этого MBeanInfo.
`Descriptor`	`getDescriptor(String inDescriptorName)`	Возвращает дескриптор, запрошенный по имени.

Методы, объявленные в классе javax.management.MBeanInfo

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

Методы, объявленные в классе java.lang.Object

finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы, объявленные в интерфейсе javax.management.modelmbean.ModelMBeanInfo

getAttribute, getAttributes, getClassName, getConstructors, getDescription, getDescriptor, getDescriptors, getMBeanDescriptor, getNotification, getNotifications, getOperation, getOperations, setDescriptor, setDescriptors, setMBeanDescriptor

Конструкторы

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 с предоставленной информацией, но дескриптор — по умолчанию. Дескриптор по умолчанию: name=className, descriptorType="mbean", displayName=className, persistPolicy="never", log="F", visibility="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 - дескриптор, используемый в качестве MBeanDescriptor, содержащий политику для всего MBean. Если дескриптор null, будет создан дескриптор по умолчанию. Дескриптор по умолчанию: name=className, descriptorType="mbean", displayName=className, persistPolicy="never", log="F", visibility="1". Если дескриптор не содержит все эти поля, отсутствующие поля добавляются с этими значениями по умолчанию.
Исключения:: RuntimeOperationsException - Обертывает IllegalArgumentException для некорректного дескриптора, переданного в параметре. (см. getMBeanDescriptor для определения валидного дескриптора MBean.)

Методы

clone

public Object clone()

Возвращает неглубокую копию этого экземпляра. Дескриптор и содержащие массивы (ModelMBeanAttributeInfo[] и т.д.) не клонируются. Этот метод в основном интересен для изменения дескриптора копии через setDescriptor без изменения дескриптора исходного объекта.

Указано в:: clone в интерфейсе ModelMBeanInfo
Переопределяет:: clone в классе MBeanInfo
Возвращает:: неглубокую копию этого экземпляра.
См. также:: Cloneable

getDescriptor

public Descriptor getDescriptor(String inDescriptorName)
                         throws MBeanException,
                                RuntimeOperationsException

Возвращает дескриптор, запрошенный по имени.

Параметры:: inDescriptorName - имя дескриптора.
Возвращает:: дескриптор, содержащий дескриптор для ModelMBean с тем же именем. Если дескриптор не найден, возвращается null.
Исключения:: MBeanException - Обертывает исключение распределённой коммуникации.; RuntimeOperationsException - Обертывает IllegalArgumentException для null имени.
См. также:: ModelMBeanInfo.setDescriptor(javax.management.Descriptor, java.lang.String)

getConstructor

public ModelMBeanConstructorInfo getConstructor(String inName)
                                         throws MBeanException,
                                                RuntimeOperationsException

Возвращает ModelMBeanConstructorInfo, запрошенный по имени. Если для данного имени не существует ModelMBeanConstructorInfo, возвращается null.

Параметры:: inName - имя конструктора.
Возвращает:: информацию о конструкторе с указанным именем или null, если конструктор не найден.
Исключения:: MBeanException - Обертывает исключение распределённой коммуникации.; RuntimeOperationsException - Обертывает IllegalArgumentException для null имени конструктора.

getDescriptor

public Descriptor getDescriptor()

Описание скопировано из класса: MBeanInfo

Получает дескриптор этого MBeanInfo. Изменение возвращаемого значения не повлияет на исходный дескриптор.

Указано в:: getDescriptor в интерфейсе DescriptorRead
Переопределяет:: getDescriptor в классе MBeanInfo
Возвращает:: дескриптор, который либо неизменяемый, либо копия исходного.
С момента:: 1.6