Интерфейс 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 и описатели).
`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-агентом.