Интерфейс 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: Имя класса, переданное в качестве параметра, равно 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 - Этот класс не является совместимым с JMX MBean

См. также:

• 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: Имя класса, переданное в качестве параметра, равно 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 - Этот класс не является совместимым с JMX MBean

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 - Массив, содержащий сигнатуру конструктора, который должен быть вызван.

Возвращает:

An ObjectInstance, containing the ObjectName and the Java class name of the newly instantiated MBean. If the contained ObjectName is n, the contained Java class name is getMBeanInfo(n).getClassName().

Исключения:

RuntimeOperationsException - Wraps a java.lang.IllegalArgumentException: The className passed in parameter is null, the ObjectName passed in parameter contains a pattern or no ObjectName is specified for the MBean.

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 - Wraps a java.lang.ClassNotFoundException or a java.lang.Exception that occurred when trying to invoke the MBean's constructor.

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

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

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

NotCompliantMBeanException - Этот класс не является совместимым с JMX MBean

См. также:

• 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 - Массив, содержащий сигнатуру конструктора, который должен быть вызван.

Возвращает:

An ObjectInstance, containing the ObjectName and the Java class name of the newly instantiated MBean. If the contained ObjectName is n, the contained Java class name is getMBeanInfo(n).getClassName().

Исключения:

RuntimeOperationsException - Wraps a java.lang.IllegalArgumentException: The className passed in parameter is null, the ObjectName passed in parameter contains a pattern or no ObjectName is specified for the MBean.

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 - Wraps a java.lang.ClassNotFoundException or a java.lang.Exception that occurred when trying to invoke the MBean's constructor.

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

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

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

NotCompliantMBeanException - Этот класс не является совместимым с JMX MBean

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

См. также:

• MBeanRegistration

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

Параметры:

object - MBean, который должен быть зарегистрирован как MBean.

name - Имя объекта MBean. Может быть null.

Возвращает:

An ObjectInstance, containing the ObjectName and the Java class name of the newly registered MBean. If the contained ObjectName is n, the contained Java class name is 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 - Этот объект не является совместимым с JMX MBean

RuntimeOperationsException - Wraps a java.lang.IllegalArgumentException: The object passed in parameter is null or no object name is specified.

См. также:

• MBeanRegistration

void unregisterMBean(ObjectName name) throws InstanceNotFoundException, MBeanRegistrationException

Specified by:

unregisterMBean in interface MBeanServerConnection

Parameters:

name - Имя объекта удаляемого MBean.

Throws:

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 выбросил исключение.

See Also:

• MBeanRegistration

ObjectInstance getObjectInstance(ObjectName name) throws InstanceNotFoundException

Specified by:

getObjectInstance in interface MBeanServerConnection

Parameters:

name - Имя объекта MBean.

Returns:

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

Throws:

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

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

Specified by:

queryMBeans in interface MBeanServerConnection

Parameters:

name - Шаблон имени объекта, идентифицирующий MBeans для извлечения. Если равно null или не указаны свойства домена и ключа, будут извлечены все зарегистрированные MBeans.

query - Выражение запроса, применяемое для выбора MBeans. Если равно null, выражение запроса не будет применено для выбора MBeans.

Returns:

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

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

Specified by:

queryNames in interface MBeanServerConnection

Parameters:

name - Шаблон имени объекта, идентифицирующий имена MBeans для извлечения. Если равно null или не указаны свойства домена и ключа, будут извлечены имена всех зарегистрированных MBeans.

query - Выражение запроса, применяемое для выбора MBeans. Если равно null, выражение запроса не будет применено для выбора MBeans.

Returns:

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

boolean isRegistered(ObjectName name)

Specified by:

isRegistered in interface MBeanServerConnection

Parameters:

name - Имя объекта MBean для проверки.

Returns:

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

Throws:

RuntimeOperationsException - Обёртка над java.lang.IllegalArgumentException: Имя объекта в параметре равно null.

Integer getMBeanCount()

Specified by:

getMBeanCount in interface MBeanServerConnection

Returns:

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

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

Specified by:

getAttribute in interface MBeanServerConnection

Parameters:

name - Имя объекта MBean, из которого необходимо извлечь атрибут.

attribute - Строка, содержащая имя атрибута для извлечения.

Returns:

Значение извлечённого атрибута.

Throws:

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

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

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

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

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

See Also:

• MBeanServerConnection.setAttribute(javax.management.ObjectName, javax.management.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);
 }
 

Specified by:

getAttributes in interface MBeanServerConnection

Parameters:

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

attributes - Список атрибутов для извлечения.

Returns:

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

Throws:

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

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

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

See Also:

• MBeanServerConnection.setAttributes(javax.management.ObjectName, javax.management.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(javax.management.ObjectName, java.lang.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(javax.management.ObjectName, java.lang.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 - Объект слушателя, который будет обрабатывать уведомления, исходящие от зарегистрированного управляемого объекта.

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

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

Исключения:

InstanceNotFoundException - Предоставленное имя управляемого объекта не соответствует ни одному из зарегистрированных управляемых объектов.

См. также:

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

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

Specified by:

addNotificationListener in interface MBeanServerConnection

Parameters:

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

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

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

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

Throws:

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

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

See Also:

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

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

Specified by:

removeNotificationListener in interface MBeanServerConnection

Parameters:

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

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

Throws:

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

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

See Also:

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

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

Specified by:

removeNotificationListener in interface MBeanServerConnection

Parameters:

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

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

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

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

Throws:

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

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

See Also:

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

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

Specified by:

removeNotificationListener in interface MBeanServerConnection

Parameters:

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

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

Throws:

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

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

See Also:

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

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

Specified by:

removeNotificationListener in interface MBeanServerConnection

Parameters:

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

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

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

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

Throws:

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

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

See Also:

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

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

Specified by:

getMBeanInfo in interface MBeanServerConnection

Parameters:

name - Имя MBean для анализа

Returns:

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

Throws:

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

IntrospectionException - Произошла ошибка во время интроспекции.

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

boolean isInstanceOf(ObjectName name, String className) throws InstanceNotFoundException

Specified by:

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

Параметры:

name - Имя MBean.

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

Возвращает:

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

Исключения:

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

См. также:

• Class.isInstance(java.lang.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.

Возвращает:

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

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

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

Исключения:

InstanceNotFoundException - если указанный MBean не найден.

ClassLoader getClassLoader(ObjectName loaderName) throws InstanceNotFoundException

Параметры:

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

Возвращает:

Указанный загрузчик классов. Если l — фактический загрузчик классов с этим именем, а r — возвращаемое значение, то либо:

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

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

Исключения:

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

ClassLoaderRepository getClassLoaderRepository()

Возвращает:

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