RequiredModelMBean (Платформа Java SE 8 b92)

java.lang. Объект
- javax.management.modelmbean.RequiredModelMBean

Все Реализованные Интерфейсы:

DynamicMBean, MBeanRegistration, ModelMBean, ModelMBeanNotificationBroadcaster, NotificationBroadcaster, NotificationEmitter, PersistentMBean
```
public class RequiredModelMBean
extends Object
implements ModelMBean, MBeanRegistration, NotificationEmitter
```
Этот class является реализацией ModelMBean. Соответствующая реализация ModelMBean должна быть поставлена с каждым Агентом JMX, и class нужно назвать RequiredModelMBean.
Ресурсы Java, желающие быть управляемыми, инстанцируют RequiredModelMBean, используя createMBean метод MBeanServer. Ресурс тогда устанавливает MBeanInfo и Дескрипторы для экземпляра RequiredModelMBean. Атрибуты и операции, представленные через ModelMBeanInfo для ModelMBean, доступны от MBeans, соединителей/адаптеров как другой MBeans. Через Дескрипторы значения и методы в управляемом приложении могут быть определены и отображены на атрибуты и операции ModelMBean. Это отображение может быть определено в XML отформатированный файл или динамически и программно во времени выполнения.
Каждый RequiredModelMBean, который инстанцируют в MBeanServer, становится управляемым:
его атрибуты и операции становятся удаленно доступными через соединители/адаптеры, соединенные с тем MBeanServer.
Объект Java не может быть зарегистрирован в MBeanServer, если это не совместимый MBean JMX. Инстанцируя RequiredModelMBean, ресурсам гарантируют это, MBean допустим. MBeanException и RuntimeOperationsException должны быть брошены в каждый открытый метод. Это учитывает переносящиеся исключения из распределенной связи (RMI, EJB, и т.д.)

С тех пор:

1.5

Сводка конструктора

Конструкторы
Конструктор и Описание
`RequiredModelMBean()` Конструкции `RequiredModelMBean` с пустым ModelMBeanInfo.
`RequiredModelMBean(ModelMBeanInfo mbi)` Создает объект RequiredModelMBean использование ModelMBeanInfo, в котором передают.

Сводка метода

Все Методы Методы экземпляра Конкретные Методы
Модификатор и Тип	Метод и Описание
`void`	`addAttributeChangeNotificationListener(NotificationListener inlistener, String inAttributeName, Object inhandback)` Регистрирует объект, который реализует интерфейс NotificationListener как слушателя.
`void`	`addNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback)` Регистрирует объект, который реализует интерфейс NotificationListener как слушателя.
`Объект`	`getAttribute(String attrName)` Возвращает значение определенного атрибута, определенного для этого ModelMBean.
`AttributeList`	`getAttributes(String[] attrNames)` Возвращает значения нескольких атрибутов в ModelMBean.
`protected ClassLoaderRepository`	`getClassLoaderRepository()` Возвратите Репозитарий Загрузчика Класса, используемый, чтобы выполнить загрузку class.
`MBeanInfo`	`getMBeanInfo()` Возвращает атрибуты, операции, конструкторов и уведомления, что этот RequiredModelMBean представляет для управления.
`MBeanNotificationInfo[]`	`getNotificationInfo()` Возвращает массив Уведомлений, всегда сгенерированных RequiredModelMBean.
`Объект`	`invoke(String opName, Object[] opArgs, String[] sig)` Вызывает метод на или через RequiredModelMBean и возвращает результат выполнения метода.
`void`	`load()` Инстанцирует этого экземпляра MBean с данными, найденными для MBean в персистентном хранилище.
`void`	`postDeregister()` Позволяет MBean выполнять любые операции, необходимые будучи незарегистрированным в сервере MBean.
`void`	`postRegister(Boolean registrationDone)` Позволяет MBean выполнять любые операции, необходимые, будучи зарегистрированным в сервере MBean или после того, как регистрация перестала работать.
`void`	`preDeregister()` Позволяет MBean выполнять любые операции, в которых он нуждается перед стать незарегистрированным сервером MBean.
`ObjectName`	`preRegister(MBeanServer server, ObjectName name)` Позволяет MBean выполнять любые операции, в которых он нуждается прежде, чем быть зарегистрированным в сервере MBean.
`void`	`removeAttributeChangeNotificationListener(NotificationListener inlistener, String inAttributeName)` Удаляет слушателя для attributeChangeNotifications из RequiredModelMBean.
`void`	`removeNotificationListener(NotificationListener listener)` Удаляет слушателя для Уведомлений из RequiredModelMBean.
`void`	`removeNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback)` Удаляет слушателя из этого MBean.
`void`	`sendAttributeChangeNotification(Attribute inOldVal, Attribute inNewVal)` Отправляет attributeChangeNotification, который содержит старое значение и новое значение для атрибута зарегистрированным слушателям AttributeChangeNotification на ModelMBean.
`void`	`sendAttributeChangeNotification(AttributeChangeNotification ntfyObj)` Отправляет attributeChangeNotification, в котором передают зарегистрированным attributeChangeNotification слушателям на ModelMBean.
`void`	`sendNotification(Notification ntfyObj)` Отправляет Уведомление, в котором передают зарегистрированным слушателям Уведомления на ModelMBean как jmx.modelmbean.generic уведомление.
`void`	`sendNotification(String ntfyText)` Отправляет Уведомление, которое содержит текстовую строку, в которой передают зарегистрированным слушателям Уведомления на ModelMBean.
`void`	`setAttribute(Attribute attribute)` Устанавливает значение определенного атрибута именованного ModelMBean.
`AttributeList`	`setAttributes(AttributeList attributes)` Устанавливает значения массива атрибутов этого ModelMBean.
`void`	`setManagedResource(Object mr, String mr_type)` Устанавливает описатель экземпляра объекта, против которого можно выполнить все методы в этом интерфейсе управления ModelMBean (MBeanInfo и Дескрипторы).
`void`	`setModelMBeanInfo(ModelMBeanInfo mbi)` Инициализирует объект ModelMBean использование ModelMBeanInfo, в котором передают.
`void`	`store()` Получает текущее состояние этого экземпляра MBean и выписывает это к персистентному хранилищу.

Методы, наследованные от class java.lang. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - RequiredModelMBean
```
public RequiredModelMBean()
                   throws MBeanException,
                          RuntimeOperationsException
```
    Конструкции RequiredModelMBean с пустым ModelMBeanInfo.
    MBeanInfo RequiredModelMBean и Дескрипторы могут быть настроены, используя setModelMBeanInfo(javax.management.modelmbean.ModelMBeanInfo) метод. После того, как MBeanInfo RequiredModelMBean и Дескрипторы настраиваются, RequiredModelMBean может быть зарегистрирован в MBeanServer.
    
    Броски:
    
    MBeanException - Обертывает распределенное коммуникационное Исключение.
    
    RuntimeOperationsException - Обертки a RuntimeException во время конструкции объекта.
  - RequiredModelMBean
```
public RequiredModelMBean(ModelMBeanInfo mbi)
                   throws MBeanException,
                          RuntimeOperationsException
```
    Создает объект RequiredModelMBean использование ModelMBeanInfo, в котором передают. Пока RequiredModelMBean еще не регистрируется в MBeanServer, MBeanInfo RequiredModelMBean и Дескрипторы могут быть настроены, используя setModelMBeanInfo(javax.management.modelmbean.ModelMBeanInfo) метод. После того, как MBeanInfo RequiredModelMBean и Дескрипторы настраиваются, RequiredModelMBean может быть зарегистрирован в MBeanServer.
    
    Параметры:
    
    mbi - ModelMBeanInfo возражают, чтобы использоваться RequiredModelMBean. Данный ModelMBeanInfo клонируется и изменяется как определено setModelMBeanInfo(javax.management.modelmbean.ModelMBeanInfo)
    
    Броски:
    
    MBeanException - Обертывает распределенное коммуникационное Исключение.
    
    RuntimeOperationsException - Переносится {соединяют java.lang. IllegalArgumentException}: MBeanInfo, который передают в параметре, является нулем.
- Деталь метода
  - setModelMBeanInfo
```
public void setModelMBeanInfo(ModelMBeanInfo mbi)
                       throws MBeanException,
                              RuntimeOperationsException
```
    Инициализирует объект ModelMBean использование ModelMBeanInfo, в котором передают. Этот метод позволяет установить специализированный ModelMBeanInfo на ModelMBean, пока это не регистрируется в MBeanServer.
    Как только ModelMBeanInfo ModelMBean (с Дескрипторами) настраиваются и устанавливаются на ModelMBean, ModelMBean быть зарегистрированными в MBeanServer.
    Если ModelMBean в настоящий момент регистрируется, этот метод бросает a RuntimeOperationsException обертывание IllegalStateException
    Если данный inModelMBeanInfo не содержит никого ModelMBeanNotificationInfo для GENERIC или ATTRIBUTE_CHANGE уведомления, тогда RequiredModelMBean предоставит свое собственное значение по умолчанию ModelMBeanNotificationInfos для тех недостающие уведомления.
    Определенный:
    
    setModelMBeanInfo в интерфейсе ModelMBean
    
    Параметры:
    
    mbi - ModelMBeanInfo возражают, чтобы использоваться ModelMBean.
    
    Броски:
    
    MBeanException - Обертывает распределенное коммуникационное Исключение.
    RuntimeOperationsException -
    Обертки IllegalArgumentException если MBeanInfo, который передают в параметре, является нулем.
    
    Обертки IllegalStateException если ModelMBean в настоящий момент регистрируется в MBeanServer.
  - setManagedResource
```
public void setManagedResource(Object mr,
                               String mr_type)
                        throws MBeanException,
                               RuntimeOperationsException,
                               InstanceNotFoundException,
                               InvalidTargetObjectTypeException
```
    Устанавливает описатель экземпляра объекта, против которого можно выполнить все методы в этом интерфейсе управления ModelMBean (MBeanInfo и Дескрипторы).
    
    Определенный:
    
    setManagedResource в интерфейсе ModelMBean
    
    Параметры:
    
    mr - Объект, который является управляемым ресурсом
    
    mr_type - Тип ссылки для управляемого ресурса.
    Может быть: "ObjectReference", "Дескриптор", "IOR", "EJBHandle", или "RMIReference".
    В этой реализации только поддерживается "ObjectReference".
    
    Броски:
    
    MBeanException - Инициализатор объекта выдал исключение.
    
    InstanceNotFoundException - Объект управляемого ресурса не мог быть найден
    
    InvalidTargetObjectTypeException - Тип управляемого ресурса должен быть "ObjectReference".
    
    RuntimeOperationsException - Обертки a RuntimeException устанавливая ресурс.
  - загрузка
```
public void load()
          throws MBeanException,
                 RuntimeOperationsException,
                 InstanceNotFoundException
```
    Инстанцирует этого экземпляра MBean с данными, найденными для MBean в персистентном хранилище. Загруженные данные могли включать значения работы и атрибут.
    
    Этот метод нужно вызвать во время конструкции или инициализации этого экземпляра, и прежде, чем MBean будет зарегистрирован в MBeanServer.
    
    Если реализация этого class не поддерживает персистентность, MBeanException обертывание a ServiceNotFoundException бросается.
    
    Определенный:
    
    load в интерфейсе PersistentMBean
    
    Броски:
    
    MBeanException - Обертки другое исключение, или персистентность не поддерживается
    
    RuntimeOperationsException - Исключения оберток из механизма персистентности
    
    InstanceNotFoundException - Не мог найти или загрузить этот MBean из персистентного хранения
  - хранилище
```
public void store()
           throws MBeanException,
                  RuntimeOperationsException,
                  InstanceNotFoundException
```
    Получает текущее состояние этого экземпляра MBean и выписывает это к персистентному хранилищу. Сохраненное состояние могло включать значения работы и атрибут.
    
    Если реализация этого class не поддерживает персистентность, MBeanException обертывание a ServiceNotFoundException бросается.
    
    Политика персистентности от MBean и дескриптора атрибута используется, чтобы вести выполнение этого метода. MBean должен быть сохранен, если 'persistPolicy' поле:
```
  != "never"
   = "always"
   = "onTimer" and now > 'lastPersistTime' + 'persistPeriod'
   = "NoMoreOftenThan" and now > 'lastPersistTime' + 'persistPeriod'
   = "onUnregister"
 
```
    Не храните MBean, если 'persistPolicy' поле:
```
    = "never"
    = "onUpdate"
    = "onTimer" && now < 'lastPersistTime' + 'persistPeriod'
 
```
    Specified by:
    
    store in interface PersistentMBean
    
    Throws:
    
    MBeanException - Wraps another exception, or persistence is not supported
    
    RuntimeOperationsException - Wraps exceptions from the persistence mechanism
    
    InstanceNotFoundException - Could not find/access the persistent store
  - getMBeanInfo
```
public MBeanInfo getMBeanInfo()
```
    Returns the attributes, operations, constructors and notifications that this RequiredModelMBean exposes for management.
    
    Specified by:
    
    getMBeanInfo in interface DynamicMBean
    
    Returns:
    
    An instance of ModelMBeanInfo allowing retrieval all attributes, operations, and Notifications of this MBean.
  - invoke
```
public Object invoke(String opName,
                     Object[] opArgs,
                     String[] sig)
              throws MBeanException,
                     ReflectionException
```
    Invokes a method on or through a RequiredModelMBean and returns the result of the method execution.
    If the given method to be invoked, together with the provided signature, matches one of RequiredModelMbean accessible methods, this one will be call. Otherwise the call to the given method will be tried on the managed resource.
    The last value returned by an operation may be cached in the operation's descriptor which is in the ModelMBeanOperationInfo's descriptor. The valid value will be in the 'value' field if there is one. If the 'currencyTimeLimit' field in the descriptor is:
    - <0 Then the value is not cached and is never valid. The operation method is invoked. The 'value' and 'lastUpdatedTimeStamp' fields are cleared.
    - =0 Then the value is always cached and always valid. The 'value' field is returned. If there is no 'value' field then the operation method is invoked for the attribute. The 'lastUpdatedTimeStamp' field and `value' fields are set to the operation's return value and the current time stamp.
    - >0 Represents the number of seconds that the 'value' field is valid. The 'value' field is no longer valid when 'lastUpdatedTimeStamp' + 'currencyTimeLimit' > Now.
      
      When 'value' is valid, 'value' is returned.
      
      When 'value' is no longer valid then the operation method is invoked. The 'lastUpdatedTimeStamp' field and `value' fields are updated.
    Note: because of inconsistencies in previous versions of this specification, it is recommended not to use negative or zero values for currencyTimeLimit. To indicate that a cached value is never valid, omit the currencyTimeLimit field. To indicate that it is always valid, use a very large number for this field.
    Specified by:
    
    invoke in interface DynamicMBean
    
    Parameters:
    
    opName - The name of the method to be invoked. The name can be the fully qualified method name including the classname, or just the method name if the classname is defined in the 'class' field of the operation descriptor.
    
    opArgs - An array containing the parameters to be set when the operation is invoked
    
    sig - An array containing the signature of the operation. The class objects will be loaded using the same class loader as the one used for loading the MBean on which the operation was invoked.
    
    Returns:
    
    The object returned by the method, which represents the result of invoking the method on the specified managed resource.
    
    Throws:
    MBeanException - Wraps one of the following Exceptions:
    
    An Exception thrown by the managed object's invoked method.
    
    ServiceNotFoundException: No ModelMBeanOperationInfo or no descriptor defined for the specified operation or the managed resource is null.
    
    InvalidTargetObjectTypeException: The 'targetType' field value is not 'objectReference'.
    ReflectionException - Wraps an Exception thrown while trying to invoke the method.
    
    RuntimeOperationsException - Wraps an IllegalArgumentException Method name is null.
  - getAttribute
```
public Object getAttribute(String attrName)
                    throws AttributeNotFoundException,
                           MBeanException,
                           ReflectionException
```
    Returns the value of a specific attribute defined for this ModelMBean. The last value returned by an attribute may be cached in the attribute's descriptor. The valid value will be in the 'value' field if there is one. If the 'currencyTimeLimit' field in the descriptor is:
    - <0 Then the value is not cached and is never valid. The getter method is invoked for the attribute. The 'value' and 'lastUpdatedTimeStamp' fields are cleared.
    - =0 Then the value is always cached and always valid. The 'value' field is returned. If there is no'value' field then the getter method is invoked for the attribute. The 'lastUpdatedTimeStamp' field and `value' fields are set to the attribute's value and the current time stamp.
    - >0 Represents the number of seconds that the 'value' field is valid. The 'value' field is no longer valid when 'lastUpdatedTimeStamp' + 'currencyTimeLimit' > Now.
      
      When 'value' is valid, 'value' is returned.
      
      When 'value' is no longer valid then the getter method is invoked for the attribute. The 'lastUpdatedTimeStamp' field and `value' fields are updated.
    Note: because of inconsistencies in previous versions of this specification, it is recommended not to use negative or zero values for currencyTimeLimit. To indicate that a cached value is never valid, omit the currencyTimeLimit field. To indicate that it is always valid, use a very large number for this field.
    
    If the 'getMethod' field contains the name of a valid operation descriptor, then the method described by the operation descriptor is executed. The response from the method is returned as the value of the attribute. If the operation fails or the returned value is not compatible with the declared type of the attribute, an exception will be thrown.
    
    If no 'getMethod' field is defined then the default value of the attribute is returned. If the returned value is not compatible with the declared type of the attribute, an exception will be thrown.
    
    The declared type of the attribute is the String returned by MBeanAttributeInfo.getType(). A value is compatible with this type if one of the following is true:
    - the value is null;
    - the declared name is a primitive type name (such as "int") and the value is an instance of the corresponding wrapper type (such as java.lang.Integer);
    - the name of the value's class is identical to the declared name;
    - the declared name can be loaded by the value's class loader and produces a class to which the value can be assigned.
    In this implementation, in every case where the getMethod needs to be called, because the method is invoked through the standard "invoke" method and thus needs operationInfo, an operation must be specified for that getMethod so that the invocation works correctly.
    Specified by:
    
    getAttribute in interface DynamicMBean
    
    Parameters:
    
    attrName - A String specifying the name of the attribute to be retrieved. It must match the name of a ModelMBeanAttributeInfo.
    
    Returns:
    
    The value of the retrieved attribute from the descriptor 'value' field or from the invocation of the operation in the 'getMethod' field of the descriptor.
    
    Throws:
    AttributeNotFoundException - The specified attribute is not accessible in the MBean. The following cases may result in an AttributeNotFoundException:
    
    No ModelMBeanInfo was found for the Model MBean.
    
    No ModelMBeanAttributeInfo was found for the specified attribute name.
    
    The ModelMBeanAttributeInfo isReadable method returns 'false'.
    MBeanException - Wraps one of the following Exceptions:
    
    InvalidAttributeValueException: A wrong value type was received from the attribute's getter method or no 'getMethod' field defined in the descriptor for the attribute and no default value exists.
    
    ServiceNotFoundException: No ModelMBeanOperationInfo defined for the attribute's getter method or no descriptor associated with the ModelMBeanOperationInfo or the managed resource is null.
    
    InvalidTargetObjectTypeException The 'targetType' field value is not 'objectReference'.
    
    An Exception thrown by the managed object's getter.
    ReflectionException - Wraps an Exception thrown while trying to invoke the getter.
    
    RuntimeOperationsException - Wraps an IllegalArgumentException: The attribute name in parameter is null.
    
    See Also:
    
    setAttribute(javax.management.Attribute)
  - getAttributes
```
public AttributeList getAttributes(String[] attrNames)
```
    Returns the values of several attributes in the ModelMBean. Executes a getAttribute for each attribute name in the attrNames array passed in.
    
    Specified by:
    
    getAttributes in interface DynamicMBean
    
    Parameters:
    
    attrNames - A String array of names of the attributes to be retrieved.
    
    Returns:
    
    The array of the retrieved attributes.
    
    Throws:
    
    RuntimeOperationsException - Wraps an IllegalArgumentException: The object name in parameter is null or attributes in parameter is null.
    
    See Also:
    
    setAttributes(javax.management.AttributeList)
  - setAttribute
```
public void setAttribute(Attribute attribute)
                  throws AttributeNotFoundException,
                         InvalidAttributeValueException,
                         MBeanException,
                         ReflectionException
```
    Sets the value of a specific attribute of a named ModelMBean. If the 'setMethod' field of the attribute's descriptor contains the name of a valid operation descriptor, then the method described by the operation descriptor is executed. In this implementation, the operation descriptor must be specified correctly and assigned to the modelMBeanInfo so that the 'setMethod' works correctly. The response from the method is set as the value of the attribute in the descriptor.
    If currencyTimeLimit is > 0, then the new value for the attribute is cached in the attribute descriptor's 'value' field and the 'lastUpdatedTimeStamp' field is set to the current time stamp.
    If the persist field of the attribute's descriptor is not null then Persistence policy from the attribute descriptor is used to guide storing the attribute in a persistent store.
    Store the MBean if 'persistPolicy' field is:
    - != "never"
    - = "always"
    - = "onUpdate"
    - = "onTimer" and now > 'lastPersistTime' + 'persistPeriod'
    - = "NoMoreOftenThan" and now > 'lastPersistTime' + 'persistPeriod'
    Do not store the MBean if 'persistPolicy' field is:
    - = "never"
    - = "onTimer" && now < 'lastPersistTime' + 'persistPeriod'
    - = "onUnregister"
    - = "NoMoreOftenThan" and now < 'lastPersistTime' + 'persistPeriod'
    The ModelMBeanInfo of the Model MBean is stored in a file.
    Specified by:
    
    setAttribute in interface DynamicMBean
    
    Parameters:
    
    attribute - The Attribute instance containing the name of the attribute to be set and the value it is to be set to.
    
    Throws:
    AttributeNotFoundException - The specified attribute is not accessible in the MBean.
    The following cases may result in an AttributeNotFoundException:
    
    No ModelMBeanAttributeInfo is found for the specified attribute.
    
    The ModelMBeanAttributeInfo's isWritable method returns 'false'.
    InvalidAttributeValueException - No descriptor is defined for the specified attribute.
    MBeanException - Wraps one of the following Exceptions:
    
    An Exception thrown by the managed object's setter.
    
    A ServiceNotFoundException if a setMethod field is defined in the descriptor for the attribute and the managed resource is null; or if no setMethod field is defined and caching is not enabled for the attribute. Note that if there is no getMethod field either, then caching is automatically enabled.
    
    InvalidTargetObjectTypeException The 'targetType' field value is not 'objectReference'.
    
    An Exception thrown by the managed object's getter.
    ReflectionException - Wraps an Exception thrown while trying to invoke the setter.
    
    RuntimeOperationsException - Wraps an IllegalArgumentException: The attribute in parameter is null.
    
    See Also:
    
    getAttribute(java.lang.String)
  - setAttributes
```
public AttributeList setAttributes(AttributeList attributes)
```
    Sets the values of an array of attributes of this ModelMBean. Executes the setAttribute() method for each attribute in the list.
    
    Specified by:
    
    setAttributes in interface DynamicMBean
    
    Parameters:
    
    attributes - A list of attributes: The identification of the attributes to be set and the values they are to be set to.
    
    Returns:
    
    The array of attributes that were set, with their new values in Attribute instances.
    
    Throws:
    
    RuntimeOperationsException - Wraps an IllegalArgumentException: The object name in parameter is null or attributes in parameter is null.
    
    See Also:
    
    getAttributes(java.lang.String[])
  - addNotificationListener
```
public void addNotificationListener(NotificationListener listener,
                                    NotificationFilter filter,
                                    Object handback)
                             throws IllegalArgumentException
```
    Registers an object which implements the NotificationListener interface as a listener. This object's 'handleNotification()' method will be invoked when any notification is issued through or by the ModelMBean. This does not include attributeChangeNotifications. They must be registered for independently.
    
    Specified by:
    
    addNotificationListener in interface NotificationBroadcaster
    
    Parameters:
    
    listener - The listener object which will handles notifications emitted by the registered MBean.
    
    filter - The filter object. If null, no filtering will be performed before handling notifications.
    
    handback - The context to be sent to the listener with the notification when a notification is emitted.
    
    Throws:
    
    IllegalArgumentException - The listener cannot be null.
    
    See Also:
    
    removeNotificationListener(javax.management.NotificationListener)
  - removeNotificationListener
```
public void removeNotificationListener(NotificationListener listener)
                                throws ListenerNotFoundException
```
    Removes a listener for Notifications from the RequiredModelMBean.
    
    Specified by:
    
    removeNotificationListener in interface NotificationBroadcaster
    
    Parameters:
    
    listener - The listener name which was handling notifications emitted by the registered MBean. This method will remove all information related to this listener.
    
    Throws:
    
    ListenerNotFoundException - The listener is not registered in the MBean or is null.
    
    See Also:
    
    addNotificationListener(javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object)
  - removeNotificationListener
```
public void removeNotificationListener(NotificationListener listener,
                                       NotificationFilter filter,
                                       Object handback)
                                throws ListenerNotFoundException
```
    Description copied from interface: NotificationEmitter
    
    Removes a listener from this MBean. The MBean must have a listener that exactly matches the given listener, filter, and handback parameters. If there is more than one such listener, only one is removed.
    
    The filter and handback parameters may be null if and only if they are null in a listener to be removed.
    
    Specified by:
    
    removeNotificationListener in interface NotificationEmitter
    
    Parameters:
    
    listener - A listener that was previously added to this MBean.
    
    filter - The filter that was specified when the listener was added.
    
    handback - The handback that was specified when the listener was added.
    
    Throws:
    
    ListenerNotFoundException - The listener is not registered with the MBean, or it is not registered with the given filter and handback.
  - sendNotification
```
public void sendNotification(Notification ntfyObj)
                      throws MBeanException,
                             RuntimeOperationsException
```
    Description copied from interface: ModelMBeanNotificationBroadcaster
    
    Sends a Notification which is passed in to the registered Notification listeners on the ModelMBean as a jmx.modelmbean.generic notification.
    
    Specified by:
    
    sendNotification in interface ModelMBeanNotificationBroadcaster
    
    Parameters:
    
    ntfyObj - The notification which is to be passed to the 'handleNotification' method of the listener object.
    
    Throws:
    
    MBeanException - Wraps a distributed communication Exception.
    
    RuntimeOperationsException - Wraps an IllegalArgumentException: The Notification object passed in parameter is null.
  - sendNotification
```
public void sendNotification(String ntfyText)
                      throws MBeanException,
                             RuntimeOperationsException
```
    Description copied from interface: ModelMBeanNotificationBroadcaster
    
    Sends a Notification which contains the text string that is passed in to the registered Notification listeners on the ModelMBean.
    
    Specified by:
    
    sendNotification in interface ModelMBeanNotificationBroadcaster
    
    Parameters:
    
    ntfyText - The text which is to be passed in the Notification to the 'handleNotification' method of the listener object. the constructed Notification will be: type "jmx.modelmbean.generic" source this ModelMBean instance sequence 1
    
    Throws:
    
    MBeanException - Wraps a distributed communication Exception.
    
    RuntimeOperationsException - Wraps an IllegalArgumentException: The Notification text string passed in parameter is null.
  - getNotificationInfo
```
public MBeanNotificationInfo[] getNotificationInfo()
```
    Returns the array of Notifications always generated by the RequiredModelMBean.
    RequiredModelMBean may always send also two additional notifications:
    - One with descriptor "name=GENERIC,descriptorType=notification,log=T,severity=6,displayName=jmx.modelmbean.generic"
    - Second is a standard attribute change notification with descriptor "name=ATTRIBUTE_CHANGE,descriptorType=notification,log=T,severity=6,displayName=jmx.attribute.change"
    Thus these two notifications are always added to those specified by the application.
    Specified by:
    
    getNotificationInfo in interface NotificationBroadcaster
    
    Returns:
    
    MBeanNotificationInfo[]
  - addAttributeChangeNotificationListener
```
public void addAttributeChangeNotificationListener(NotificationListener inlistener,
                                                   String inAttributeName,
                                                   Object inhandback)
                                            throws MBeanException,
                                                   RuntimeOperationsException,
                                                   IllegalArgumentException
```
    Description copied from interface: ModelMBeanNotificationBroadcaster
    
    Registers an object which implements the NotificationListener interface as a listener. This object's 'handleNotification()' method will be invoked when any attributeChangeNotification is issued through or by the ModelMBean. This does not include other Notifications. They must be registered for independently. An AttributeChangeNotification will be generated for this attributeName.
    
    Specified by:
    
    addAttributeChangeNotificationListener in interface ModelMBeanNotificationBroadcaster
    
    Parameters:
    
    inlistener - The listener object which will handles notifications emitted by the registered MBean.
    
    inAttributeName - The name of the ModelMBean attribute for which to receive change notifications. If null, then all attribute changes will cause an attributeChangeNotification to be issued.
    
    inhandback - The context to be sent to the listener with the notification when a notification is emitted.
    
    Throws:
    
    MBeanException - Wraps a distributed communication Exception.
    
    RuntimeOperationsException - Wraps an IllegalArgumentException The attribute name passed in parameter does not exist.
    
    IllegalArgumentException - The listener cannot be null.
    
    See Also:
    
    ModelMBeanNotificationBroadcaster.removeAttributeChangeNotificationListener(javax.management.NotificationListener, java.lang.String)
  - removeAttributeChangeNotificationListener
```
public void removeAttributeChangeNotificationListener(NotificationListener inlistener,
                                                      String inAttributeName)
                                               throws MBeanException,
                                                      RuntimeOperationsException,
                                                      ListenerNotFoundException
```
    Description copied from interface: ModelMBeanNotificationBroadcaster
    
    Removes a listener for attributeChangeNotifications from the RequiredModelMBean.
    
    Specified by:
    
    removeAttributeChangeNotificationListener in interface ModelMBeanNotificationBroadcaster
    
    Parameters:
    
    inlistener - The listener name which was handling notifications emitted by the registered MBean. This method will remove all information related to this listener.
    
    inAttributeName - The attribute for which the listener no longer wants to receive attributeChangeNotifications. If null the listener will be removed for all attributeChangeNotifications.
    
    Throws:
    
    MBeanException - Wraps a distributed communication Exception.
    
    RuntimeOperationsException - Wraps an IllegalArgumentException If the inAttributeName parameter does not correspond to an attribute name.
    
    ListenerNotFoundException - The listener is not registered in the MBean or is null.
    
    See Also:
    
    ModelMBeanNotificationBroadcaster.addAttributeChangeNotificationListener(javax.management.NotificationListener, java.lang.String, java.lang.Object)
  - sendAttributeChangeNotification
```
public void sendAttributeChangeNotification(AttributeChangeNotification ntfyObj)
                                     throws MBeanException,
                                            RuntimeOperationsException
```
    Description copied from interface: ModelMBeanNotificationBroadcaster
    
    Sends an attributeChangeNotification which is passed in to the registered attributeChangeNotification listeners on the ModelMBean.
    
    Specified by:
    
    sendAttributeChangeNotification in interface ModelMBeanNotificationBroadcaster
    
    Parameters:
    
    ntfyObj - The notification which is to be passed to the 'handleNotification' method of the listener object.
    
    Throws:
    
    MBeanException - Wraps a distributed communication Exception.
    
    RuntimeOperationsException - Wraps an IllegalArgumentException: The AttributeChangeNotification object passed in parameter is null.
  - sendAttributeChangeNotification
```
public void sendAttributeChangeNotification(Attribute inOldVal,
                                            Attribute inNewVal)
                                     throws MBeanException,
                                            RuntimeOperationsException
```
    Description copied from interface: ModelMBeanNotificationBroadcaster
    
    Sends an attributeChangeNotification which contains the old value and new value for the attribute to the registered AttributeChangeNotification listeners on the ModelMBean.
    Specified by:
    
    sendAttributeChangeNotification in interface ModelMBeanNotificationBroadcaster
    
    Parameters:
    
    inOldVal - The original value for the Attribute
    inNewVal - The current value for the Attribute
    
    The constructed attributeChangeNotification will be: type "jmx.attribute.change" source this ModelMBean instance sequence 1 attributeName oldValue.getName() attributeType oldValue's class attributeOldValue oldValue.getValue() attributeNewValue newValue.getValue()
    Throws:
    
    MBeanException - Wraps a distributed communication Exception.
    
    RuntimeOperationsException - Wraps an IllegalArgumentException: An Attribute object passed in parameter is null or the names of the two Attribute objects in parameter are not the same.
  - getClassLoaderRepository
```
protected ClassLoaderRepository getClassLoaderRepository()
```
    Return the Class Loader Repository used to perform class loading. Subclasses may wish to redefine this method in order to return the appropriate ClassLoaderRepository that should be used in this object.
    
    Returns:
    
    the Class Loader Repository.
  - preRegister
```
public ObjectName preRegister(MBeanServer server,
                              ObjectName name)
                       throws Exception
```
    Allows the MBean to perform any operations it needs before being registered in the MBean server. If the name of the MBean is not specified, the MBean can provide a name for its registration. If any exception is raised, the MBean will not be registered in the MBean server.
    In order to ensure proper run-time semantics of RequireModelMBean, Any subclass of RequiredModelMBean overloading or overriding this method should call super.preRegister(server, name) in its own preRegister implementation.
    
    Specified by:
    
    preRegister in interface MBeanRegistration
    
    Parameters:
    
    server - The MBean server in which the MBean will be registered.
    
    name - The object name of the MBean. This name is null if the name parameter to one of the createMBean or registerMBean methods in the MBeanServer interface is null. In that case, this method must return a non-null ObjectName for the new MBean.
    
    Returns:
    
    The name under which the MBean is to be registered. This value must not be null. If the name parameter is not null, it will usually but not necessarily be the returned value.
    
    Throws:
    
    Exception - This exception will be caught by the MBean server and re-thrown as an MBeanRegistrationException.
  - postRegister
```
public void postRegister(Boolean registrationDone)
```
    Allows the MBean to perform any operations needed after having been registered in the MBean server or after the registration has failed.
    In order to ensure proper run-time semantics of RequireModelMBean, Any subclass of RequiredModelMBean overloading or overriding this method should call super.postRegister(registrationDone) in its own postRegister implementation.
    
    Specified by:
    
    postRegister in interface MBeanRegistration
    
    Parameters:
    
    registrationDone - Indicates whether or not the MBean has been successfully registered in the MBean server. The value false means that the registration phase has failed.
  - preDeregister
```
public void preDeregister()
                   throws Exception
```
    Allows the MBean to perform any operations it needs before being unregistered by the MBean server.
    In order to ensure proper run-time semantics of RequireModelMBean, Any subclass of RequiredModelMBean overloading or overriding this method should call super.preDeregister() in its own preDeregister implementation.
    
    Specified by:
    
    preDeregister in interface MBeanRegistration
    
    Throws:
    
    Exception - This exception will be caught by the MBean server and re-thrown as an MBeanRegistrationException.
  - postDeregister
```
public void postDeregister()
```
    Allows the MBean to perform any operations needed after having been unregistered in the MBean server.
    In order to ensure proper run-time semantics of RequireModelMBean, Any subclass of RequiredModelMBean overloading or overriding this method should call super.postDeregister() in its own postDeregister implementation.
    
    Specified by:
    
    postDeregister in interface MBeanRegistration

Представьте ошибку или функцию
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b92

Класс RequiredModelMBean

Сводка конструктора

Сводка метода

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

Деталь конструктора

RequiredModelMBean

RequiredModelMBean

Деталь метода

setModelMBeanInfo

setManagedResource

загрузка

хранилище

getMBeanInfo

invoke

getAttribute

getAttributes

setAttribute

setAttributes

addNotificationListener

removeNotificationListener

removeNotificationListener

sendNotification

sendNotification

getNotificationInfo

addAttributeChangeNotificationListener

removeAttributeChangeNotificationListener

sendAttributeChangeNotification

sendAttributeChangeNotification

getClassLoaderRepository

preRegister

postRegister

preDeregister

postDeregister