Интерфейс ModelMBean

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

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

public interface ModelMBean extends DynamicMBean, PersistentMBean, ModelMBeanNotificationBroadcaster

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

Java-ресурсы, которые хотят быть управляемыми, инициализируют ModelMBean, используя метод createMBean сервера MBean. Ресурс затем устанавливает ModelMBeanInfo (с дескрипторами) для экземпляра ModelMBean. Атрибуты и операции, экспонированные через ModelMBeanInfo для ModelMBean, доступны из MBean, коннекторов/адаптеров, как и другие MBean. Через дескрипторы 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 и дескрипторы).
`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 и дескрипторы).

Параметры:: mr - Объект, являющийся управляемым ресурсом; mr_type - Тип ссылки на управляемый ресурс. Может быть: ObjectReference, Handle, IOR, EJBHandle, RMIReference. Если MBeanServer не может обработать переданный тип mr_type, будет брошено исключение InvalidTargetTypeException.
Исключение:: MBeanException - Инициализатор объекта бросил исключение.; RuntimeOperationsException - Обертывает IllegalArgumentException: Тип управляемого ресурса, переданный в качестве параметра, равен null.; InstanceNotFoundException - Объект управляемого ресурса не найден.; InvalidTargetObjectTypeException - Тип управляемого ресурса не может быть обработан ModelMBean или JMX-агентом.

© 1993, 2023, 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://docs.oracle.com/en/java/javase/21/docs/api/java.management/javax/management/modelmbean/ModelMBean.html