Интерфейс ModelMBean

public interface ModelMBean
extends DynamicMBean, PersistentMBean, ModelMBeanNotificationBroadcaster

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

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

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

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

Методы

setModelMBeanInfo

void setModelMBeanInfo(ModelMBeanInfo inModelMBeanInfo)
                throws MBeanException,
                       RuntimeOperationsException

Параметры:

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

Выбрасывает:

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

RuntimeOperationsException -

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

setManagedResource

void setManagedResource(Object mr,
                        String mr_type)
                 throws MBeanException,
                        RuntimeOperationsException,
                        InstanceNotFoundException,
                        InvalidTargetObjectTypeException

Устанавливает обработку экземпляра объекта, для которого будут выполняться все методы в этом интерфейсе управления ModelMBean (MBeanInfo и описатели).

Параметры:

mr - Объект, являющийся управляемым ресурсом

mr_type - Тип ссылки на управляемый ресурс. Может быть: ObjectReference, Handle, IOR, EJBHandle, RMIReference. Если сервер MBean не может обработать переданный mr_type, будет выброшено InvalidTargetTypeException.

Выбрасывает:

MBeanException - Инициализатор объекта выбросил исключение.

RuntimeOperationsException - Оборачивает IllegalArgumentException: тип управляемого ресурса, переданный в качестве параметра, равен null.

InstanceNotFoundException - Объект управляемого ресурса не найден

InvalidTargetObjectTypeException - Тип управляемого ресурса не может быть обработан ModelMBean или JMX-агентом.