Интерфейс MBeanServer

ObjectInstance createMBean(String className, ObjectName name) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException

Определено в:

createMBean в интерфейсе MBeanServerConnection

Параметры:

className — имя класса создаваемого экземпляра MBean.

name — имя объекта MBean. Может быть равно null.

Возвращает:

Объект ObjectInstance, содержащий ObjectName и имя класса Java нового экземпляра MBean. Если содержащийся ObjectName равен n, содержащееся имя класса Java равно getMBeanInfo(n).getClassName().

Вызывает исключения:

RuntimeOperationsException — оборачивает java.lang.IllegalArgumentException: переданный в параметре className равен null, переданный в параметре ObjectName содержит шаблон или для MBean не указано ObjectName.

RuntimeMBeanException — если конструктор MBean, его метод preRegister или postRegister вызвал RuntimeException. Если метод postRegister (интерфейс MBeanRegistration) MBean вызывает RuntimeException, метод createMBean вызовет RuntimeMBeanException, хотя создание и регистрация MBean прошли успешно. В этом случае MBean фактически будет зарегистрирован, несмотря на то что метод createMBean вызвал исключение. Обратите внимание, что RuntimeMBeanException также может быть вызвано методом preRegister; в этом случае MBean не будет зарегистрирован.

RuntimeErrorException — если метод postRegister (интерфейс MBeanRegistration) MBean вызывает Error, метод createMBean вызовет RuntimeErrorException, хотя создание и регистрация MBean прошли успешно. В этом случае MBean фактически будет зарегистрирован, несмотря на то что метод createMBean вызвал исключение. Обратите внимание, что RuntimeErrorException также может быть вызвано методом preRegister; в этом случае MBean не будет зарегистрирован.

ReflectionException — оборачивает java.lang.ClassNotFoundException или java.lang.Exception, возникшее при попытке вызвать конструктор MBean.

InstanceAlreadyExistsException — MBean уже находится под управлением MBean-сервера.

MBeanRegistrationException — метод preRegister (интерфейс MBeanRegistration) MBean вызвал исключение. MBean не будет зарегистрирован.

MBeanException — конструктор MBean вызвал исключение.

NotCompliantMBeanException — этот класс не является MBean, совместимым с JMX.

См. также:

• MBeanRegistration

ObjectInstance createMBean(String className, ObjectName name, ObjectName loaderName) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException, InstanceNotFoundException

Определено в:

createMBean в интерфейсе MBeanServerConnection

Параметры:

className — имя класса создаваемого экземпляра MBean.

name — имя объекта MBean. Может быть равно null.

loaderName — имя объекта используемого загрузчика классов.

Возвращает:

Объект ObjectInstance, содержащий ObjectName и имя класса Java нового экземпляра MBean. Если содержащийся ObjectName равен n, содержащееся имя класса Java равно getMBeanInfo(n).getClassName().

Вызывает исключения:

RuntimeOperationsException — оборачивает java.lang.IllegalArgumentException: переданный в параметре className равен null, переданный в параметре ObjectName содержит шаблон или для MBean не указано ObjectName.

RuntimeMBeanException — если конструктор MBean, его метод preRegister или postRegister вызвал RuntimeException. Если метод postRegister (интерфейс MBeanRegistration) MBean вызывает RuntimeException, метод createMBean вызовет RuntimeMBeanException, хотя создание и регистрация MBean прошли успешно. В этом случае MBean фактически будет зарегистрирован, несмотря на то что метод createMBean вызвал исключение. Обратите внимание, что RuntimeMBeanException также может быть вызвано методом preRegister; в этом случае MBean не будет зарегистрирован.

RuntimeErrorException — если метод postRegister (интерфейс MBeanRegistration) MBean вызывает Error, метод createMBean вызовет RuntimeErrorException, хотя создание и регистрация MBean прошли успешно. В этом случае MBean фактически будет зарегистрирован, несмотря на то что метод createMBean вызвал исключение. Обратите внимание, что RuntimeErrorException также может быть вызвано методом preRegister; в этом случае MBean не будет зарегистрирован.

ReflectionException — оборачивает java.lang.ClassNotFoundException или java.lang.Exception, возникшее при попытке вызвать конструктор MBean.

InstanceAlreadyExistsException — MBean уже находится под управлением MBean-сервера.

MBeanRegistrationException — метод preRegister (интерфейс MBeanRegistration) MBean вызвал исключение. MBean не будет зарегистрирован.

MBeanException — конструктор MBean вызвал исключение.

NotCompliantMBeanException — этот класс не является MBean, совместимым с JMX.

InstanceNotFoundException — указанный загрузчик классов не зарегистрирован на MBean-сервере.

См. также:

• MBeanRegistration

ObjectInstance createMBean(String className, ObjectName name, Object[] params, String[] signature) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException

Определено в:

createMBean в интерфейсе MBeanServerConnection

Параметры:

className — имя класса создаваемого экземпляра MBean.

name — имя объекта MBean. Может быть равно null.

params — массив, содержащий параметры вызываемого конструктора.

signature — массив, содержащий сигнатуру вызываемого конструктора.

Возвращает:

Объект ObjectInstance, содержащий ObjectName и имя класса Java нового экземпляра MBean. Если содержащийся ObjectName равен n, содержащееся имя класса Java равно getMBeanInfo(n).getClassName().

Вызывает исключения:

RuntimeOperationsException — оборачивает java.lang.IllegalArgumentException: переданный в параметре className равен null, переданный в параметре ObjectName содержит шаблон или для MBean не указано ObjectName.

RuntimeMBeanException — если конструктор MBean, его метод preRegister или postRegister вызвал RuntimeException. Если метод postRegister (интерфейс MBeanRegistration) MBean вызывает RuntimeException, метод createMBean вызовет RuntimeMBeanException, хотя создание и регистрация MBean прошли успешно. В этом случае MBean фактически будет зарегистрирован, несмотря на то что метод createMBean вызвал исключение. Обратите внимание, что RuntimeMBeanException также может быть вызвано методом preRegister; в этом случае MBean не будет зарегистрирован.

RuntimeErrorException — если метод postRegister (интерфейс MBeanRegistration) MBean вызывает Error, метод createMBean вызовет RuntimeErrorException, хотя создание и регистрация MBean прошли успешно. В этом случае MBean фактически будет зарегистрирован, несмотря на то что метод createMBean вызвал исключение. Обратите внимание, что RuntimeErrorException также может быть вызвано методом preRegister; в этом случае MBean не будет зарегистрирован.

ReflectionException — оборачивает java.lang.ClassNotFoundException или java.lang.Exception, возникшее при попытке вызвать конструктор MBean.

InstanceAlreadyExistsException — MBean уже находится под управлением MBean-сервера.

MBeanRegistrationException — метод preRegister (интерфейс MBeanRegistration) MBean вызвал исключение. MBean не будет зарегистрирован.

MBeanException — конструктор MBean вызвал исключение.

NotCompliantMBeanException — этот класс не является MBean, совместимым с JMX.

См. также:

• MBeanRegistration

ObjectInstance createMBean(String className, ObjectName name, ObjectName loaderName, Object[] params, String[] signature) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException, InstanceNotFoundException

Определено в:

createMBean в интерфейсе MBeanServerConnection

Параметры:

className — имя класса создаваемого экземпляра MBean.

name — имя объекта MBean. Может быть равно null.

loaderName — имя объекта используемого загрузчика классов.

params — массив, содержащий параметры вызываемого конструктора.

signature — массив, содержащий сигнатуру вызываемого конструктора.

Возвращает:

Объект ObjectInstance, содержащий ObjectName и имя класса Java нового экземпляра MBean. Если содержащийся ObjectName равен n, содержащееся имя класса Java равно getMBeanInfo(n).getClassName().

Вызывает исключения:

RuntimeOperationsException — оборачивает java.lang.IllegalArgumentException: переданный в параметре className равен null, переданный в параметре ObjectName содержит шаблон или для MBean не указано ObjectName.

RuntimeMBeanException — конструктор MBean, его метод preRegister или postRegister вызвал RuntimeException. Если метод postRegister (интерфейс MBeanRegistration) MBean вызывает RuntimeException, метод createMBean вызовет RuntimeMBeanException, хотя создание и регистрация MBean прошли успешно. В этом случае MBean фактически будет зарегистрирован, несмотря на то что метод createMBean вызвал исключение. Обратите внимание, что RuntimeMBeanException также может быть вызвано методом preRegister; в этом случае MBean не будет зарегистрирован.

RuntimeErrorException — если метод postRegister (интерфейс MBeanRegistration) MBean вызывает Error, метод createMBean вызовет RuntimeErrorException, хотя создание и регистрация MBean прошли успешно. В этом случае MBean фактически будет зарегистрирован, несмотря на то что метод createMBean вызвал исключение. Обратите внимание, что RuntimeErrorException также может быть вызвано методом preRegister; в этом случае MBean не будет зарегистрирован.

ReflectionException — оборачивает java.lang.ClassNotFoundException или java.lang.Exception, возникшее при попытке вызвать конструктор MBean.

InstanceAlreadyExistsException — MBean уже находится под управлением MBean-сервера.

MBeanRegistrationException — метод preRegister (интерфейс MBeanRegistration) MBean вызвал исключение. MBean не будет зарегистрирован.

MBeanException — конструктор MBean вызвал исключение.

NotCompliantMBeanException — этот класс не является MBean, совместимым с JMX.

InstanceNotFoundException — указанный загрузчик классов не зарегистрирован на MBean-сервере.

См. также:

• MBeanRegistration

ObjectInstance registerMBean(Object object, ObjectName name) throws InstanceAlreadyExistsException, MBeanRegistrationException, NotCompliantMBeanException

Параметры:

object — MBean, регистрируемый как MBean.

name — имя объекта MBean. Может быть равно null.

Возвращает:

Объект ObjectInstance, содержащий ObjectName и имя класса Java только что зарегистрированного MBean. Если содержащийся ObjectName равен n, содержащееся имя класса Java равно getMBeanInfo(n).getClassName().

Вызывает исключения:

InstanceAlreadyExistsException — MBean уже находится под управлением MBean-сервера.

MBeanRegistrationException — метод preRegister (интерфейс MBeanRegistration) MBean вызвал исключение. MBean не будет зарегистрирован.

RuntimeMBeanException — если метод postRegister (интерфейс MBeanRegistration) MBean вызывает RuntimeException, метод registerMBean вызовет RuntimeMBeanException, хотя регистрация MBean прошла успешно. В этом случае MBean фактически будет зарегистрирован, несмотря на то что метод registerMBean вызвал исключение. Обратите внимание, что RuntimeMBeanException также может быть вызвано методом preRegister; в этом случае MBean не будет зарегистрирован.

RuntimeErrorException — если метод postRegister (интерфейс MBeanRegistration) MBean вызывает Error, метод registerMBean вызовет RuntimeErrorException, хотя регистрация MBean прошла успешно. В этом случае MBean фактически будет зарегистрирован, несмотря на то что метод registerMBean вызвал исключение. Обратите внимание, что RuntimeErrorException также может быть вызвано методом preRegister; в этом случае MBean не будет зарегистрирован.

NotCompliantMBeanException — этот объект не является MBean, совместимым с JMX.

RuntimeOperationsException — оборачивает java.lang.IllegalArgumentException: переданный в параметре объект равен null или имя объекта не указано.

См. также:

• MBeanRegistration

void unregisterMBean(ObjectName name) throws InstanceNotFoundException, MBeanRegistrationException

Определено в:

unregisterMBean в интерфейсе MBeanServerConnection

Параметры:

name — имя объекта MBean, регистрацию которого нужно отменить.

Вызывает исключения:

RuntimeOperationsException — оборачивает java.lang.IllegalArgumentException: имя объекта в параметре равно null или MBean, регистрацию которого пытаются отменить, является MBean MBeanServerDelegate.

RuntimeMBeanException — если метод postDeregister (интерфейс MBeanRegistration) MBean вызывает RuntimeException, метод unregisterMBean вызовет RuntimeMBeanException, хотя регистрация MBean была успешно отменена. В этом случае регистрация MBean фактически будет отменена, несмотря на то что метод unregisterMBean вызвал исключение. Обратите внимание, что RuntimeMBeanException также может быть вызвано методом preDeregister; в этом случае MBean останется зарегистрированным.

RuntimeErrorException — если метод postDeregister (интерфейс MBeanRegistration) MBean вызывает Error, метод unregisterMBean вызовет RuntimeErrorException, хотя регистрация MBean была успешно отменена. В этом случае регистрация MBean фактически будет отменена, несмотря на то что метод unregisterMBean вызвал исключение. Обратите внимание, что RuntimeMBeanException также может быть вызвано методом preDeregister; в этом случае MBean останется зарегистрированным.

InstanceNotFoundException — указанный MBean не зарегистрирован на MBean-сервере.

MBeanRegistrationException — метод preDeregister (интерфейс MBeanRegistration) MBean вызвал исключение.

См. также:

• MBeanRegistration

ObjectInstance getObjectInstance(ObjectName name) throws InstanceNotFoundException

Определено в:

getObjectInstance в интерфейсе MBeanServerConnection

Параметры:

name — имя объекта MBean.

Возвращает:

Объект ObjectInstance, связанный с MBean, указанным параметром name. Содержащийся ObjectName равен name, а содержащееся имя класса равно getMBeanInfo(name).getClassName().

Вызывает исключения:

InstanceNotFoundException — указанный MBean не зарегистрирован на MBean-сервере.

Set<ObjectInstance> queryMBeans(ObjectName name, QueryExp query)

Определено в:

queryMBeans в интерфейсе MBeanServerConnection

Параметры:

name — шаблон имени объекта, определяющий извлекаемые MBean. Если значение равно null или домен и свойства ключа не указаны, будут извлечены все зарегистрированные MBean.

query — выражение запроса для выбора MBean. Если значение равно null, выражение запроса для выбора MBean применяться не будет.

Возвращает:

Набор, содержащий объекты ObjectInstance для выбранных MBean. Если ни один MBean не удовлетворяет запросу, возвращается пустой список.

Set<ObjectName> queryNames(ObjectName name, QueryExp query)

Определено в:

queryNames в интерфейсе MBeanServerConnection

Параметры:

name — шаблон имени объекта, определяющий извлекаемые имена MBean. Если значение равно null или домен и свойства ключа не указаны, будут извлечены имена всех зарегистрированных MBean.

query — выражение запроса для выбора MBean. Если значение равно null, выражение запроса для выбора MBean применяться не будет.

Возвращает:

Набор, содержащий имена ObjectName выбранных MBean. Если ни один MBean не удовлетворяет запросу, возвращается пустой список.

boolean isRegistered(ObjectName name)

Определено в:

isRegistered в интерфейсе MBeanServerConnection

Параметры:

name — имя объекта проверяемого MBean.

Возвращает:

True, если MBean уже зарегистрирован на MBean-сервере; в противном случае false.

Вызывает исключения:

RuntimeOperationsException — оборачивает java.lang.IllegalArgumentException: имя объекта в параметре равно null.

Integer getMBeanCount()

Определено в:

getMBeanCount в интерфейсе MBeanServerConnection

Возвращает:

количество зарегистрированных MBean, обернутое в Integer. Если разрешения вызывающего ограничены, это число может быть больше количества MBean, доступных вызывающему.

Object getAttribute(ObjectName name, String attribute) throws MBeanException, AttributeNotFoundException, InstanceNotFoundException, ReflectionException

Определено в:

getAttribute в интерфейсе MBeanServerConnection

Параметры:

name — имя объекта MBean, у которого нужно получить атрибут.

attribute — строка с именем извлекаемого атрибута.

Возвращает:

Значение полученного атрибута.

Вызывает исключения:

RuntimeOperationsException — оборачивает java.lang.IllegalArgumentException: имя объекта в параметре или атрибут в параметре равны null.

MBeanException — оборачивает исключение, вызванное методом получения значения MBean.

AttributeNotFoundException — указанный атрибут недоступен в MBean.

InstanceNotFoundException — указанный MBean не зарегистрирован на MBean-сервере.

ReflectionException — оборачивает java.lang.Exception, вызванное при попытке вызвать метод установки значения.

См. также:

• MBeanServerConnection.setAttribute(ObjectName, Attribute)

AttributeList getAttributes(ObjectName name, String[] attributes) throws InstanceNotFoundException, ReflectionException

String[] attrNames = ...;
AttributeList list = mbeanServerConnection.getAttributes(objectName, attrNames);
if (list.size() == attrNames.length)
    System.out.println("All attributes were retrieved successfully");
else {
    List<String> missing = new ArrayList<String>(Arrays.asList(attrNames));
    for (Attribute a : list.asList())
        missing.remove(a.getName());
    System.out.println("Did not retrieve: " + missing);
}

Определено в:

getAttributes в интерфейсе MBeanServerConnection

Параметры:

name — имя объекта MBean, у которого извлекаются атрибуты.

attributes — список извлекаемых атрибутов.

Возвращает:

Список полученных атрибутов.

Вызывает исключения:

RuntimeOperationsException — оборачивает java.lang.IllegalArgumentException: имя объекта в параметре или атрибуты в параметре равны null.

InstanceNotFoundException — указанный MBean не зарегистрирован на MBean-сервере.

ReflectionException — при попытке вызвать метод getAttributes динамического MBean произошло исключение.

См. также:

• MBeanServerConnection.setAttributes(ObjectName, AttributeList)

void setAttribute(ObjectName name, Attribute attribute) throws InstanceNotFoundException, AttributeNotFoundException, InvalidAttributeValueException, MBeanException, ReflectionException

Определено в:

setAttribute в интерфейсе MBeanServerConnection

Параметры:

name - Имя MBean, атрибут которого нужно установить.

attribute - Идентификатор атрибута, который нужно установить, и значение, которое ему нужно присвоить.

Исключения:

RuntimeOperationsException - Оборачивает java.lang.IllegalArgumentException: имя объекта в параметре равно null или атрибут в параметре равен null.

InstanceNotFoundException - Указанный MBean не зарегистрирован на сервере MBean.

AttributeNotFoundException - Указанный атрибут недоступен в MBean.

InvalidAttributeValueException - Указанное значение атрибута недопустимо.

MBeanException - Оборачивает исключение, выброшенное методом-сеттером MBean.

ReflectionException - Оборачивает java.lang.Exception, выброшенное при попытке вызвать метод-сеттер.

См. также:

• MBeanServerConnection.getAttribute(ObjectName, String)

AttributeList setAttributes(ObjectName name, AttributeList attributes) throws InstanceNotFoundException, ReflectionException

AttributeList inputAttrs = ...;
AttributeList outputAttrs = mbeanServerConnection.setAttributes(objectName, inputAttrs);
if (inputAttrs.size() == outputAttrs.size())
    System.out.println("All attributes were set successfully");
else {
    List<String> missing = new ArrayList<String>();
    for (Attribute a : inputAttrs.asList())
        missing.add(a.getName());
    for (Attribute a : outputAttrs.asList())
        missing.remove(a.getName());
    System.out.println("Did not set: " + missing);
}

Определено в:

setAttributes в интерфейсе MBeanServerConnection

Параметры:

name - Имя объекта MBean, атрибуты которого нужно установить.

attributes - Список атрибутов: идентификаторы атрибутов, которые нужно установить, и значения, которые им нужно присвоить.

Возвращает:

Список установленных атрибутов с их новыми значениями.

Исключения:

RuntimeOperationsException - Оборачивает java.lang.IllegalArgumentException: имя объекта в параметре равно null или атрибуты в параметре равны null.

InstanceNotFoundException - Указанный MBean не зарегистрирован на сервере MBean.

ReflectionException - При попытке вызвать метод getAttributes динамического MBean произошло исключение.

См. также:

• MBeanServerConnection.getAttributes(ObjectName, String[])

Object invoke(ObjectName name, String operationName, Object[] params, String[] signature) throws InstanceNotFoundException, MBeanException, ReflectionException

public interface FooMBean {
    public int countMatches(String[] patterns, boolean ignoreCase);
}

String[] myPatterns = ...;
int count = (Integer) mbeanServerConnection.invoke(
        objectName,
        "countMatches",
        new Object[] {myPatterns, true},
        new String[] {String[].class.getName(), boolean.class.getName()});

String[] myPatterns = ...;
FooMBean fooProxy = JMX.newMBeanProxy(
        mbeanServerConnection, objectName, FooMBean.class);
int count = fooProxy.countMatches(myPatterns, true);

Определено в:

invoke в интерфейсе MBeanServerConnection

Параметры:

name - Имя объекта MBean, метод которого нужно вызвать.

operationName - Имя вызываемой операции.

params - Массив параметров, которые будут переданы при вызове операции

signature - Массив сигнатуры операции — массив имен классов в формате, возвращаемом методом Class.getName(). Классы будут загружены с помощью того же загрузчика классов, который использовался для загрузки MBean, в котором вызывается операция.

Возвращает:

Объект, возвращаемый операцией и представляющий результат ее вызова для указанного MBean.

Исключения:

InstanceNotFoundException - Указанный MBean не зарегистрирован на сервере MBean.

MBeanException - Оборачивает исключение, выброшенное вызываемым методом MBean.

ReflectionException - Оборачивает java.lang.Exception, выброшенное при попытке вызвать метод.

String getDefaultDomain()

Определено в:

getDefaultDomain в интерфейсе MBeanServerConnection

Возвращает:

домен по умолчанию.

String[] getDomains()

Определено в:

getDomains в интерфейсе MBeanServerConnection

Возвращает:

список доменов.

void addNotificationListener(ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback) throws InstanceNotFoundException

Определено в:

addNotificationListener в интерфейсе MBeanServerConnection

Параметры:

name - Имя MBean, к которому нужно добавить слушателя.

listener - Объект-слушатель, который будет обрабатывать уведомления, отправляемые зарегистрированным MBean.

filter - Объект фильтра. Если filter равен null, перед обработкой уведомлений фильтрация выполняться не будет.

handback - Контекст, передаваемый слушателю при отправке уведомления.

Исключения:

InstanceNotFoundException - Указанное имя MBean не соответствует ни одному из зарегистрированных MBean.

См. также:

• MBeanServerConnection.removeNotificationListener(ObjectName, NotificationListener)
• MBeanServerConnection.removeNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)

void addNotificationListener(ObjectName name, ObjectName listener, NotificationFilter filter, Object handback) throws InstanceNotFoundException

Определено в:

addNotificationListener в интерфейсе MBeanServerConnection

Параметры:

name - Имя MBean, к которому нужно добавить слушателя.

listener - Имя объекта слушателя, который будет обрабатывать уведомления, отправляемые зарегистрированным MBean.

filter - Объект фильтра. Если filter равен null, перед обработкой уведомлений фильтрация выполняться не будет.

handback - Контекст, передаваемый слушателю при отправке уведомления.

Исключения:

RuntimeOperationsException - Оборачивает IllegalArgumentException. MBean с именем listener существует, но не реализует интерфейс NotificationListener.

InstanceNotFoundException - Имя MBean слушателя уведомлений или MBean-источника уведомлений не соответствует ни одному из зарегистрированных MBean.

См. также:

• MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName)
• MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)

void removeNotificationListener(ObjectName name, ObjectName listener) throws InstanceNotFoundException, ListenerNotFoundException

Определено в:

removeNotificationListener в интерфейсе MBeanServerConnection

Параметры:

name - Имя MBean, из которого нужно удалить слушателя.

listener - Имя объекта слушателя, который нужно удалить.

Исключения:

InstanceNotFoundException - Указанное имя MBean не соответствует ни одному из зарегистрированных MBean.

ListenerNotFoundException - Слушатель не зарегистрирован в MBean.

См. также:

• MBeanServerConnection.addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)

void removeNotificationListener(ObjectName name, ObjectName listener, NotificationFilter filter, Object handback) throws InstanceNotFoundException, ListenerNotFoundException

Определено в:

removeNotificationListener в интерфейсе MBeanServerConnection

Параметры:

name - Имя MBean, из которого нужно удалить слушателя.

listener - Имя объекта слушателя, который нужно удалить.

filter - Фильтр, указанный при добавлении слушателя.

handback - Объект обратной связи, указанный при добавлении слушателя.

Исключения:

InstanceNotFoundException - Указанное имя MBean не соответствует ни одному из зарегистрированных MBean.

ListenerNotFoundException - Слушатель не зарегистрирован в MBean или зарегистрирован с другим фильтром либо объектом обратной связи.

См. также:

• MBeanServerConnection.addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object)

void removeNotificationListener(ObjectName name, NotificationListener listener) throws InstanceNotFoundException, ListenerNotFoundException

Определено в:

removeNotificationListener в интерфейсе MBeanServerConnection

Параметры:

name - Имя MBean, из которого нужно удалить слушателя.

listener - Слушатель, которого нужно удалить.

Исключения:

InstanceNotFoundException - Указанное имя MBean не соответствует ни одному из зарегистрированных MBean.

ListenerNotFoundException - Слушатель не зарегистрирован в MBean.

См. также:

• MBeanServerConnection.addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)

void removeNotificationListener(ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback) throws InstanceNotFoundException, ListenerNotFoundException

Определено в:

removeNotificationListener в интерфейсе MBeanServerConnection

Параметры:

name - Имя MBean, из которого нужно удалить слушателя.

listener - Слушатель, которого нужно удалить.

filter - Фильтр, указанный при добавлении слушателя.

handback - Объект обратной связи, указанный при добавлении слушателя.

Исключения:

InstanceNotFoundException - Указанное имя MBean не соответствует ни одному из зарегистрированных MBean.

ListenerNotFoundException - Слушатель не зарегистрирован в MBean или зарегистрирован с другим фильтром либо объектом обратной связи.

См. также:

• MBeanServerConnection.addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object)

MBeanInfo getMBeanInfo(ObjectName name) throws InstanceNotFoundException, IntrospectionException, ReflectionException

Определено в:

getMBeanInfo в интерфейсе MBeanServerConnection

Параметры:

name - Имя анализируемого MBean

Возвращает:

Экземпляр MBeanInfo, позволяющий получить все атрибуты и операции этого MBean.

Исключения:

InstanceNotFoundException - Указанный MBean не найден.

IntrospectionException - Во время интроспекции произошло исключение.

ReflectionException - При попытке вызвать getMBeanInfo динамического MBean произошло исключение.

boolean isInstanceOf(ObjectName name, String className) throws InstanceNotFoundException

Определено в:

isInstanceOf в интерфейсе MBeanServerConnection

Параметры:

name - ObjectName MBean.

className - Имя класса.

Возвращает:

true, если согласно приведенным выше правилам указанный MBean является экземпляром указанного класса, и false в противном случае.

Исключения:

InstanceNotFoundException - Указанный MBean не зарегистрирован на сервере MBean.

См. также:

• Class.isInstance(Object)

Object instantiate(String className) throws ReflectionException, MBeanException

Параметры:

className - Имя класса создаваемого объекта.

Возвращает:

Вновь созданный объект.

Исключения:

ReflectionException - Оборачивает java.lang.ClassNotFoundException или java.lang.Exception, возникшее при попытке вызвать конструктор объекта.

MBeanException - Конструктор объекта выбросил исключение

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

Object instantiate(String className, ObjectName loaderName) throws ReflectionException, MBeanException, InstanceNotFoundException

Параметры:

className - Имя класса создаваемого MBean.

loaderName - Имя объекта загрузчика классов, который нужно использовать.

Возвращает:

Вновь созданный объект.

Исключения:

ReflectionException - Оборачивает java.lang.ClassNotFoundException или java.lang.Exception, возникшее при попытке вызвать конструктор объекта.

MBeanException - Конструктор объекта выбросил исключение.

InstanceNotFoundException - Указанный загрузчик классов не зарегистрирован на сервере MBean.

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

Object instantiate(String className, Object[] params, String[] signature) throws ReflectionException, MBeanException

Параметры:

className - Имя класса создаваемого объекта.

params - Массив параметров вызываемого конструктора.

signature - Массив сигнатуры вызываемого конструктора.

Возвращает:

Вновь созданный объект.

Исключения:

ReflectionException - Оборачивает java.lang.ClassNotFoundException или java.lang.Exception, возникшее при попытке вызвать конструктор объекта.

MBeanException - Конструктор объекта выбросил исключение

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

Object instantiate(String className, ObjectName loaderName, Object[] params, String[] signature) throws ReflectionException, MBeanException, InstanceNotFoundException

Параметры:

className - Имя класса создаваемого объекта.

loaderName - Имя объекта загрузчика классов, который нужно использовать.

params - Массив параметров вызываемого конструктора.

signature - Массив сигнатуры вызываемого конструктора.

Возвращает:

Вновь созданный объект.

Исключения:

ReflectionException - Оборачивает java.lang.ClassNotFoundException или java.lang.Exception, возникшее при попытке вызвать конструктор объекта.

MBeanException - Конструктор объекта выбросил исключение

InstanceNotFoundException - Указанный загрузчик классов не зарегистрирован на сервере MBean.

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

@Deprecated(since="1.5") default ObjectInputStream deserialize(ObjectName name, byte[] data) throws InstanceNotFoundException, OperationsException

Требования к реализации:

По умолчанию этот метод выбрасывает UnsupportedOperationException.

Параметры:

name - Имя MBean, загрузчик классов которого следует использовать для десериализации.

data - Массив байтов для десериализации.

Возвращает:

Десериализованный поток объектов.

Исключения:

InstanceNotFoundException - Указанный MBean не найден.

OperationsException - Любое из стандартных исключений, связанных с вводом-выводом.

@Deprecated(since="1.5") default ObjectInputStream deserialize(String className, byte[] data) throws OperationsException, ReflectionException

Требования к реализации:

По умолчанию этот метод выбрасывает UnsupportedOperationException.

Параметры:

className - Имя класса, загрузчик классов которого следует использовать для десериализации.

data - Массив байтов для десериализации.

Возвращает:

Десериализованный поток объектов.

Исключения:

OperationsException - Любое из стандартных исключений, связанных с вводом-выводом.

ReflectionException - Указанный класс не удалось загрузить с помощью репозитория загрузчиков классов.

@Deprecated(since="1.5") default ObjectInputStream deserialize(String className, ObjectName loaderName, byte[] data) throws InstanceNotFoundException, OperationsException, ReflectionException

Требования к реализации:

По умолчанию этот метод выбрасывает UnsupportedOperationException.

Параметры:

className — имя класса, загрузчик классов которого следует использовать для десериализации.

loaderName — имя загрузчика классов, используемого для загрузки указанного класса. Если значение равно null, будет использоваться загрузчик классов сервера MBean.

data — массив байтов для десериализации.

Возвращает:

Десериализованный поток объектов.

Исключения:

InstanceNotFoundException — указанный MBean загрузчика классов не найден.

OperationsException — одно из обычных исключений, связанных с вводом-выводом.

ReflectionException — указанный класс не удалось загрузить с помощью указанного загрузчика классов.

ClassLoader getClassLoaderFor(ObjectName mbeanName) throws InstanceNotFoundException

Параметры:

mbeanName — ObjectName MBean.

Возвращает:

ClassLoader, использованный для данного MBean. Если l — фактический ClassLoader MBean, а r — возвращаемое значение, то выполняется одно из условий:

• r идентичен l; или
• результат r.loadClass(s) совпадает с результатом l.loadClass(s) для любой строки s.

Это означает, что ClassLoader может быть обёрнут в другой ClassLoader в целях безопасности или по другим причинам.

Исключения:

InstanceNotFoundException — если именованный MBean не найден.

ClassLoader getClassLoader(ObjectName loaderName) throws InstanceNotFoundException

Параметры:

loaderName — ObjectName загрузчика классов. Может иметь значение null; в этом случае возвращается собственный загрузчик классов сервера MBean.

Возвращает:

Именованный ClassLoader. Если l — фактический ClassLoader с этим именем, а r — возвращаемое значение, то выполняется одно из условий:

• r идентичен l; или
• результат r.loadClass(s) совпадает с результатом l.loadClass(s) для любой строки s.

Это означает, что ClassLoader может быть обёрнут в другой ClassLoader в целях безопасности или по другим причинам.

Исключения:

InstanceNotFoundException — если именованный ClassLoader не найден.

ClassLoaderRepository getClassLoaderRepository()

Возвращает:

ClassLoaderRepository этого сервера MBean.