Интерфейс ModelMBean

Все суперинтерфейсы:: DynamicMBean, ModelMBeanNotificationBroadcaster, NotificationBroadcaster, PersistentMBean

Все известные реализующие классы:: RequiredModelMBean

public interface ModelMBean extends DynamicMBean, PersistentMBean, ModelMBeanNotificationBroadcaster

Этот интерфейс должен быть реализован объектами ModelMBeans. Реализация этого интерфейса должна поставляться с каждым JMX агентом.

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

Каждый ModelMBean, который инициализирован в MBeanServer, становится управляемым: его атрибуты и операции становятся удаленно доступными через коннекторы/адаптеры, подключенные к этому MBeanServer. Объект Java не может быть зарегистрирован в MBeanServer, если он не является совместимым с JMX MBean. Инициализируя ModelMBean, ресурсы гарантируют, что MBean является валидным.

MBeanException и RuntimeOperationsException должны быть брошены для каждого публичного метода. Это позволяет оборачивать исключения из распределенных коммуникаций (RMI, EJB и т.д.). Эти исключения не обязательно должны быть брошены реализацией, за исключением сценариев, описанных в спецификации и javadoc.

С:: 1.5

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`setManagedResource(Object mr, String mr_type)`	Устанавливает обработчик экземпляра объекта, для выполнения всех методов в этом интерфейсе управления ModelMBean (MBeanInfo и Descriptors).
`void`	`setModelMBeanInfo(ModelMBeanInfo inModelMBeanInfo)`	Инициализирует объект ModelMBean, используя переданный ModelMBeanInfo.

Методы, объявленные в интерфейсе 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

Инициализирует объект ModelMBean, используя переданный ModelMBeanInfo. Этот метод позволяет задать настраиваемый ModelMBeanInfo для ModelMBean, пока он не зарегистрирован в MBeanServer.
После настройки и задания ModelMBeanInfo (с дескрипторами) для ModelMBean, ModelMBean может быть зарегистрирован в MBeanServer.

Если ModelMBean в настоящее время зарегистрирован, этот метод выбрасывает RuntimeOperationsException с обернутым IllegalStateException

Параметры:

inModelMBeanInfo - Объект ModelMBeanInfo, который будет использоваться ModelMBean.

Исключения:

MBeanException - Оборачивает исключение распределенной коммуникации.

RuntimeOperationsException -

Оборачивает IllegalArgumentException, если переданный MBeanInfo равен null.
Оборачивает IllegalStateException, если ModelMBean в настоящее время зарегистрирован в MBeanServer.

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 агентом.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.management/javax/management/modelmbean/ModelMBean.html