compact3

javax.management

Интерфейс MBeanServer

Все Суперинтерфейсы:

MBeanServerConnection

Все Известные Подынтерфейсы:

MBeanServerForwarder

public interface MBeanServer
extends MBeanServerConnection

Это - интерфейс для манипулирования MBean на стороне агента. Это содержит методы, необходимые для создания, регистрации, и удаления MBeans так же как методов доступа для зарегистрированного MBeans. Это - базовый компонент инфраструктуры JMX.

Пользовательский код обычно не реализует этот интерфейс. Вместо этого объект, который реализует этот интерфейс, получается с одним из методов в MBeanServerFactory class.

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

Когда MBean регистрируется или незарегистрирован в сервере MBean a MBeanServerNotification Уведомление испускается. Чтобы зарегистрировать объект как, слушатель MBeanServerNotifications, следует вызвать метод сервера MBean addNotificationListener с ObjectName ObjectName из MBeanServerDelegate. Это ObjectName :
JMImplementation:type=MBeanServerDelegate.

Объект, полученный из createMBeanServer или newMBeanServer методы MBeanServerFactory class применяет проверки безопасности к своим методам, следующим образом.

Во-первых, если нет никакого менеджера безопасности (System.getSecurityManager() нуль), затем реализация этого интерфейса свободна не осуществить любые проверки.

Принятие, что есть менеджер безопасности, или что реализация хочет осуществлять проверки так или иначе, проверки, делается как детализировано ниже. В дальнейшем, и если иначе не определено, className строка, возвращенная MBeanInfo.getClassName() для целевого MBean.

Если проверка защиты перестала работать, броски метода SecurityException.

Для методов, которые могут бросить InstanceNotFoundException, это исключение выдается для несуществующего MBean, независимо от полномочий. Это - то, потому что несуществующий MBean имеет нет className.

• Для invoke метод, полномочия вызывающей стороны должны подразумевать MBeanPermission(className, operationName, name, "invoke").

• Для getAttribute метод, полномочия вызывающей стороны должны подразумевать MBeanPermission(className, attribute, name, "getAttribute").

• Для getAttributes метод, полномочия вызывающей стороны должны подразумевать MBeanPermission(className, null, name, "getAttribute"). Дополнительно, для каждого атрибута в AttributeList, если полномочия вызывающей стороны не подразумевают MBeanPermission(className, a, name, "getAttribute"), сервер MBean будет вести себя, как будто тот атрибут не был в предоставленном списке.

• Для setAttribute метод, полномочия вызывающей стороны должны подразумевать MBeanPermission(className, attrName, name, "setAttribute"), где attrName attribute.getName().

• Для setAttributes метод, полномочия вызывающей стороны должны подразумевать MBeanPermission(className, null, name, "setAttribute"). Дополнительно, для каждого атрибута в AttributeList, если полномочия вызывающей стороны не подразумевают MBeanPermission(className, a, name, "setAttribute"), сервер MBean будет вести себя, как будто тот атрибут не был в предоставленном списке.

• Для addNotificationListener методы, полномочия вызывающей стороны должны подразумевать MBeanPermission(className, null, name, "addNotificationListener").

• Для removeNotificationListener методы, полномочия вызывающей стороны должны подразумевать MBeanPermission(className, null, name, "removeNotificationListener").

• Для getMBeanInfo метод, полномочия вызывающей стороны должны подразумевать MBeanPermission(className, null, name, "getMBeanInfo").

• Для getObjectInstance метод, полномочия вызывающей стороны должны подразумевать MBeanPermission(className, null, name, "getObjectInstance").

• Для isInstanceOf метод, полномочия вызывающей стороны должны подразумевать MBeanPermission(className, null, name, "isInstanceOf").

• Для queryMBeans метод, полномочия вызывающей стороны должны подразумевать MBeanPermission(null, null, null, "queryMBeans"). Дополнительно, для каждого MBean n, который соответствует name, если полномочия вызывающей стороны не подразумевают MBeanPermission(className, null, n, "queryMBeans"), сервер MBean будет вести себя, как будто это MBean не существовало.

  Определенные элементы запроса выполняют операции на сервере MBean. Если у вызывающей стороны нет необходимых полномочий для данного MBean, что MBean не будет включен в результат запроса. Стандартные элементы запроса, на которые влияют, Query.attr(String), Query.attr(String,String), и Query.classattr().

• Для queryNames метод, проверки являются тем же самым что касается queryMBeans за исключением того, что "queryNames" используется вместо "queryMBeans" в MBeanPermission объекты. Отметьте это a "queryMBeans" разрешение подразумевает соответствие "queryNames" разрешение.

• Для getDomains метод, полномочия вызывающей стороны должны подразумевать MBeanPermission(null, null, null, "getDomains"). Дополнительно, для каждого домена d в возвращенном массиве, если полномочия вызывающей стороны не подразумевают MBeanPermission(null, null, new ObjectName("d:x=x"), "getDomains"), домен устраняется из массива. Здесь, x=x любая пара key=value, должен был удовлетворить конструктора ObjectName, но не иначе релевантный.

• Для getClassLoader метод, полномочия вызывающей стороны должны подразумевать MBeanPermission(className, null, loaderName, "getClassLoader").

• Для getClassLoaderFor метод, полномочия вызывающей стороны должны подразумевать MBeanPermission(className, null, mbeanName, "getClassLoaderFor").

• Для getClassLoaderRepository метод, полномочия вызывающей стороны должны подразумевать MBeanPermission(null, null, null, "getClassLoaderRepository").

• Для осуждаемого deserialize методы, необходимые полномочия являются тем же самым что касается методов, которые заменяют их.

• Для instantiate методы, полномочия вызывающей стороны должны подразумевать MBeanPermission(className, null, null, "instantiate"), где className имя class, который нужно инстанцировать.

• Для registerMBean метод, полномочия вызывающей стороны должны подразумевать MBeanPermission(className, null, name, "registerMBean").

  Если MBeanPermission проверка успешно выполняется, class MBEAN проверяется, проверяя что ProtectionDomain подразумевает MBeanTrustPermission("register").

  Наконец, если name параметром является нуль, другой MBeanPermission проверка осуществляется, используя ObjectName возвращенный MBeanRegistration.preRegister.

• Для createMBean методы, полномочия вызывающей стороны должны подразумевать полномочия, необходимые эквиваленту instantiate сопровождаемый registerMBean.

• Для unregisterMBean метод, полномочия вызывающей стороны должны подразумевать MBeanPermission(className, null, name, "unregisterMBean").

С тех пор:

1.5

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

Модификатор и Тип	Метод и Описание
void	addNotificationListener(ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback) Добавляет слушатель зарегистрированного MBean.
void	addNotificationListener(ObjectName name, ObjectName listener, NotificationFilter filter, Object handback) Добавляет слушатель зарегистрированного MBean.
ObjectInstance	createMBean(String className, ObjectName name) Инстанцирует и регистрирует MBean в сервере MBean.
ObjectInstance	createMBean(String className, ObjectName name, Object[] params, String[] signature) Инстанцирует и регистрирует MBean в сервере MBean.
ObjectInstance	createMBean(String className, ObjectName name, ObjectName loaderName) Инстанцирует и регистрирует MBean в сервере MBean.
ObjectInstance	createMBean(String className, ObjectName name, ObjectName loaderName, Object[] params, String[] signature) Инстанцирует и регистрирует MBean в сервере MBean.
ObjectInputStream	deserialize(ObjectName name, byte[] data) Осуждаемый. Использовать getClassLoaderFor получить соответствующий загрузчик class для десериализации.
ObjectInputStream	deserialize(String className, byte[] data) Осуждаемый. Использовать getClassLoaderRepository() получить репозитарий загрузчика class и использовать это, чтобы десериализовать.
ObjectInputStream	deserialize(String className, ObjectName loaderName, byte[] data) Осуждаемый. Использовать getClassLoader получить загрузчик class для десериализации.
Объект	getAttribute(ObjectName name, String attribute) Получает значение определенного атрибута именованного MBean.
AttributeList	getAttributes(ObjectName name, String[] attributes) Получает значения нескольких атрибутов именованного MBean.
ClassLoder	getClassLoader(ObjectName loaderName) Возвратите именованное ClassLoader.
ClassLoder	getClassLoaderFor(ObjectName mbeanName) Возвратитесь ClassLoader это использовалось для того, чтобы загрузить class именованного MBean.
ClassLoaderRepository	getClassLoaderRepository() Возвратите ClassLoaderRepository для этого MBeanServer.
Строка	getDefaultDomain() Возвращает домен значения по умолчанию, используемый для того, чтобы назвать MBean.
Строка[]	getDomains() Возвращает список доменов, в которых в настоящий момент регистрируется любой MBean.
Целое число	getMBeanCount() Возвращает число MBeans, зарегистрированного в сервере MBean.
MBeanInfo	getMBeanInfo(ObjectName name) Этот метод обнаруживает атрибуты и операции, которые MBean представляет для управления.
ObjectInstance	getObjectInstance(ObjectName name) Добирается ObjectInstance для данного MBean, зарегистрированного в сервере MBean.
Объект	instantiate(String className) Инстанцирует объекта, используя список всех загрузчиков class, зарегистрированных в сервере MBean Class Loader Repository.
Объект	instantiate(String className, Object[] params, String[] signature) Инстанцирует объекта, используя список всех загрузчиков class, зарегистрированных в сервере MBean Class Loader Repository.
Объект	instantiate(String className, ObjectName loaderName) Инстанцирует объекта, используя Загрузчик class, определенный ObjectName.
Объект	instantiate(String className, ObjectName loaderName, Object[] params, String[] signature) Инстанцирует объекта.
Объект	invoke(ObjectName name, String operationName, Object[] params, String[] signature) Вызывает работу на MBean.
boolean	isInstanceOf(ObjectName name, String className) Возвращает true, если определенный MBean является экземпляром указанного class, ложь иначе.
boolean	isRegistered(ObjectName name) Проверки, регистрируется ли MBean, идентифицированный его именем объекта, уже, в сервере MBean.
Set<ObjectInstance>	queryMBeans(ObjectName name, QueryExp query) Получает MBeans, которым управляет сервер MBean.
Set<ObjectName>	queryNames(ObjectName name, QueryExp query) Получает имена MBeans, которым управляет сервер MBean.
ObjectInstance	registerMBean(Object object, ObjectName name) Регистрирует существующий ранее объект как MBean с сервером MBean.
void	removeNotificationListener(ObjectName name, NotificationListener listener) Удаляет слушателя из зарегистрированного MBean.
void	removeNotificationListener(ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback) Удаляет слушателя из зарегистрированного MBean.
void	removeNotificationListener(ObjectName name, ObjectName listener) Удаляет слушателя из зарегистрированного MBean.
void	removeNotificationListener(ObjectName name, ObjectName listener, NotificationFilter filter, Object handback) Удаляет слушателя из зарегистрированного MBean.
void	setAttribute(ObjectName name, Attribute attribute) Устанавливает значение определенного атрибута именованного MBean.
AttributeList	setAttributes(ObjectName name, AttributeList attributes) Устанавливает значения нескольких атрибутов именованного MBean.
void	unregisterMBean(ObjectName name) Нерегистрирует MBean от сервера MBean.

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

createMBean

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

Инстанцирует и регистрирует MBean в сервере MBean. Сервер MBean будет использовать Default Loader Repository загрузить class MBean. Имя объекта связывается с MBean. Если данное имя объекта является нулем, MBean должен обеспечить свое собственное имя, реализовывая MBeanRegistration взаимодействуйте через интерфейс и возврат имени от preRegister метод.

Этот метод эквивалентен createMBean(className, name, (Object[]) null, (String[]) null).

Если этот метод успешно создает MBean, уведомление отправляется как описано выше.

Определенный:

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

Параметры:

className - Имя class MBean, который инстанцируют.

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

Возвраты:

ObjectInstance, содержа ObjectName и Java имя class недавно инстанцированного MBean. Если содержавший ObjectName n, содержавший Java имя class getMBeanInfo(n).getClassName().

Броски:

RuntimeOperationsException - Обертки a java.lang.IllegalArgumentException: Имя класса, которое передают в параметре, является нулем, ObjectName переданный в параметре содержит образец или нет ObjectName определяется для MBean.

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

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

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

InstanceAlreadyExistsException - MBean уже является объектом управления сервера MBean.

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

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

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

См. Также:

MBeanRegistration

createMBean

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

Инстанцирует и регистрирует MBean в сервере MBean. Загрузчик class, который будет использоваться, идентифицируется его именем объекта. Имя объекта связывается с MBean. Если имя объекта загрузчика будет нулем, то ClassLoder, который загрузил сервер MBean, будет использоваться. Если данное имя объекта MBEAN является нулем, MBean должен обеспечить свое собственное имя, реализовывая MBeanRegistration взаимодействуйте через интерфейс и возврат имени от preRegister метод.

Этот метод эквивалентен createMBean(className, name, loaderName, (Object[]) null, (String[]) null).

Если этот метод успешно создает MBean, уведомление отправляется как описано выше.

Определенный:

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

Параметры:

className - Имя class MBean, который инстанцируют.

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

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

Возвраты:

ObjectInstance, содержа ObjectName и Java имя class недавно инстанцированного MBean. Если содержавший ObjectName n, содержавший Java имя class getMBeanInfo(n).getClassName().

Броски:

RuntimeOperationsException - Обертки a java.lang.IllegalArgumentException: Имя класса, которое передают в параметре, является нулем, ObjectName переданный в параметре содержит образец или нет ObjectName определяется для MBean.

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

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

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

InstanceAlreadyExistsException - MBean уже является объектом управления сервера MBean.

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

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

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

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

См. Также:

MBeanRegistration

createMBean

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

Инстанцирует и регистрирует MBean в сервере MBean. Сервер MBean будет использовать Default Loader Repository загрузить class MBean. Имя объекта связывается с MBean. Если данное имя объекта является нулем, MBean должен обеспечить свое собственное имя, реализовывая MBeanRegistration взаимодействуйте через интерфейс и возврат имени от preRegister метод.

Если этот метод успешно создает MBean, уведомление отправляется как описано выше.

Определенный:

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

Параметры:

className - Имя class MBean, который инстанцируют.

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

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

signature - Массив, содержащий подпись конструктора, который будет вызван.

Возвраты:

ObjectInstance, содержа ObjectName и Java имя class недавно инстанцированного MBean. Если содержавший ObjectName n, содержавший Java имя class getMBeanInfo(n).getClassName().

Броски:

RuntimeOperationsException - Обертки a java.lang.IllegalArgumentException: Имя класса, которое передают в параметре, является нулем, ObjectName переданный в параметре содержит образец или нет ObjectName определяется для MBean.

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

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

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

InstanceAlreadyExistsException - MBean уже является объектом управления сервера MBean.

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

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

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

См. Также:

MBeanRegistration

createMBean

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

Инстанцирует и регистрирует MBean в сервере MBean. Загрузчик class, который будет использоваться, идентифицируется его именем объекта. Имя объекта связывается с MBean. Если имя объекта загрузчика не будет определено, то ClassLoder, который загрузил сервер MBean, будет использоваться. Если данное имя объекта MBean является нулем, MBean должен обеспечить свое собственное имя, реализовывая MBeanRegistration взаимодействуйте через интерфейс и возврат имени от preRegister метод.

Если этот метод успешно создает MBean, уведомление отправляется как описано выше.

Определенный:

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

Параметры:

className - Имя class MBean, который инстанцируют.

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

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

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

signature - Массив, содержащий подпись конструктора, который будет вызван.

Возвраты:

ObjectInstance, содержа ObjectName и Java имя class недавно инстанцированного MBean. Если содержавший ObjectName n, содержавший Java имя class getMBeanInfo(n).getClassName().

Броски:

RuntimeOperationsException - Обертки a java.lang.IllegalArgumentException: Имя класса, которое передают в параметре, является нулем, ObjectName переданный в параметре содержит образец или нет ObjectName определяется для MBean.

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

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

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

InstanceAlreadyExistsException - MBean уже является объектом управления сервера MBean.

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

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

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

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

См. Также:

MBeanRegistration

registerMBean

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

Регистрирует существующий ранее объект как MBean с сервером MBean. Если данное имя объекта является нулем, MBean должен обеспечить свое собственное имя, реализовывая MBeanRegistration взаимодействуйте через интерфейс и возврат имени от preRegister метод.

Если этот метод успешно регистрирует MBean, уведомление отправляется как описано выше.

Параметры:

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

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

Возвраты:

ObjectInstance, содержа ObjectName и Java имя class недавно зарегистрированного MBean. Если содержавший ObjectName n, содержавший Java имя class getMBeanInfo(n).getClassName().

Броски:

InstanceAlreadyExistsException - MBean уже является объектом управления сервера MBean.

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

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

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

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

RuntimeOperationsException - Обертки a java.lang.IllegalArgumentException: Объект, который передают в параметре, является нулем, или никакое имя объекта не определяется.

См. Также:

MBeanRegistration

unregisterMBean

void unregisterMBean(ObjectName name)
              throws InstanceNotFoundException,
                     MBeanRegistrationException

Нерегистрирует MBean от сервера MBean. MBean идентифицируется его именем объекта. Как только метод был вызван, к MBean больше не может получить доступ его имя объекта.

Если этот метод успешно нерегистрирует MBean, уведомление отправляется как описано выше.

Определенный:

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

Параметры:

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

Броски:

RuntimeOperationsException - Обертки a java.lang.IllegalArgumentException: Имя объекта в параметре является нулем или MBean, который Вы - то, когда попытка незарегистрироваться MBeanServerDelegate MBean.

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

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

InstanceNotFoundException - Определенный MBean не регистрируется в сервере MBean.

MBeanRegistrationException - Предварительно вычеркивание из списка ((MBeanRegistration интерфейс), метод MBean выдал исключение.

См. Также:

MBeanRegistration

getObjectInstance

ObjectInstance getObjectInstance(ObjectName name)
                          throws InstanceNotFoundException

Описание скопировало с интерфейса: MBeanServerConnection

Добирается ObjectInstance для данного MBean, зарегистрированного в сервере MBean.

Определенный:

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

Параметры:

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

Возвраты:

ObjectInstance связанный с MBean, определенным name. Содержавший ObjectName name и содержавшее имя class getMBeanInfo(name).getClassName().

Броски:

InstanceNotFoundException - Определенный MBean не регистрируется в сервере MBean.

queryMBeans

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

Получает MBeans, которым управляет сервер MBean. Этот метод позволяет любому из следующих быть полученным: Весь MBeans, ряд MBeans, определенного сопоставлением с образцом на ObjectName и/или выражение Запроса, определенный MBean. Когда имя объекта является нулем или никаким доменом, и ключевые свойства определяются, все объекты состоят в том, чтобы быть выбраны (и фильтроваться, если запрос определяется). Это возвращает набор ObjectInstance объекты (содержащий ObjectName и Имя класса Java) для выбранного MBeans.

Определенный:

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

Параметры:

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

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

Возвраты:

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

Броски:

RuntimeOperationsException

queryNames

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

Получает имена MBeans, которым управляет сервер MBean. Этот метод позволяет любому из следующих быть полученным: имена всего MBeans, имена ряда MBeans, определенного сопоставлением с образцом на ObjectName и/или выражение Запроса, определенное имя MBean (эквивалентный тестированию, регистрируется ли MBean). Когда имя объекта является нулем или никаким доменом, и ключевые свойства определяются, все объекты выбираются (и фильтруются, если запрос определяется). Это возвращает набор ObjectNames для выбранного MBeans.

Определенный:

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

Параметры:

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

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

Возвраты:

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

Броски:

RuntimeOperationsException

isRegistered

boolean isRegistered(ObjectName name)

Описание скопировало с интерфейса: MBeanServerConnection

Проверки, регистрируется ли MBean, идентифицированный его именем объекта, уже, в сервере MBean.

Определенный:

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

Параметры:

name - Имя объекта MBean, который будет проверен.

Возвраты:

Истина, если MBean уже регистрируется в сервере MBean, ложь иначе.

Броски:

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

getMBeanCount

Integer getMBeanCount()

Возвращает число MBeans, зарегистрированного в сервере MBean.

Определенный:

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

Возвраты:

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

getAttribute

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

Описание скопировало с интерфейса: MBeanServerConnection

Получает значение определенного атрибута именованного MBean. MBean идентифицируется его именем объекта.

Определенный:

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

Параметры:

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

attribute - Строка, определяющая имя атрибута, который будет получен.

Возвраты:

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

Броски:

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

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

AttributeNotFoundException - Определенный атрибут не доступен в MBean.

InstanceNotFoundException - Определенный MBean не регистрируется в сервере MBean.

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

См. Также:

MBeanServerConnection.setAttribute(javax.management.ObjectName, javax.management.Attribute)

getAttributes

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

Описание скопировало с интерфейса: MBeanServerConnection

Получает значения нескольких атрибутов именованного MBean. MBean идентифицируется его именем объекта.

Если один или более атрибутов не могут быть получены по некоторым причинам, они будут опущены от возвращенного AttributeList. Вызывающая сторона должна проверить, что список является тем же самым размером как attributes массив. Чтобы обнаружить что проблема, которой препятствуют данный атрибут быть полученным, вызвать getAttribute для того атрибута.

Вот пример вызова этого метода и проверяя, что это преуспело в том, чтобы получить все требуемые атрибуты:

 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 - Обертка a java.lang.IllegalArgumentException: Имя объекта в параметре является нулем, или атрибуты в параметре нуль.

InstanceNotFoundException - Определенный MBean не регистрируется в сервере MBean.

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

См. Также:

MBeanServerConnection.setAttributes(javax.management.ObjectName, javax.management.AttributeList)

setAttribute

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

Описание скопировало с интерфейса: MBeanServerConnection

Устанавливает значение определенного атрибута именованного MBean. MBean идентифицируется его именем объекта.

Определенный:

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

Параметры:

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

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

Броски:

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

InstanceNotFoundException - Определенный MBean не регистрируется в сервере MBean.

AttributeNotFoundException - Определенный атрибут не доступен в MBean.

InvalidAttributeValueException - Значение, определенное для атрибута, не допустимо.

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

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

См. Также:

MBeanServerConnection.getAttribute(javax.management.ObjectName, java.lang.String)

setAttributes

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

Описание скопировало с интерфейса: MBeanServerConnection

Устанавливает значения нескольких атрибутов именованного MBean. MBean идентифицируется его именем объекта.

Если один или более атрибутов не могут быть установлены по некоторым причинам, они будут опущены от возвращенного AttributeList. Вызывающая сторона должна проверить что ввод AttributeList тот же самый размер как вывод один. Обнаружить, какую проблему, которой препятствуют данный атрибут быть полученным, обычно будет возможно вызвать setAttribute для того атрибута, хотя это, как гарантируют, не будет работать. (Например, значения двух атрибутов, возможно, были отклонены, потому что они были непоследовательны друг с другом. Установка одного из них один могла бы быть позволена.)

Вот пример вызова этого метода и проверяя, что это преуспело в том, чтобы установить все требуемые атрибуты:

 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 - Обертки a java.lang.IllegalArgumentException: Имя объекта в параметре является нулем, или атрибуты в параметре нуль.

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

Описание скопировало с интерфейса: MBeanServerConnection

Вызывает работу на MBean.

Из-за потребности в a signature чтобы дифференцировать возможно перегруженные операции, намного более просто вызвать операции через прокси MBean где только возможно. Например, предположите, что у Вас есть Стандартный интерфейс MBean как это:

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

countMatches работа может быть вызвана следующим образом:

 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 называет в формате возвращенный Class.getName(). Объекты class будут загружены, используя тот же самый загрузчик class в качестве того, используемого для того, чтобы загрузить MBean, на который была вызвана работа.

Возвраты:

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

Броски:

InstanceNotFoundException - Определенный MBean не регистрируется в сервере MBean.

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

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

getDefaultDomain

String getDefaultDomain()

Описание скопировало с интерфейса: MBeanServerConnection

Возвращает домен значения по умолчанию, используемый для того, чтобы назвать MBean. Доменное имя значения по умолчанию используется в качестве части домена в ObjectName MBeans, если никакой домен не определяется пользователем.

Определенный:

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

Возвраты:

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

getDomains

String[] getDomains()

Описание скопировало с интерфейса: MBeanServerConnection

Возвращает список доменов, в которых в настоящий момент регистрируется любой MBean. Строка находится в возвращенном массиве, если и только если есть по крайней мере один MBean, зарегистрированный в ObjectName чей getDomain() равно той строке. Порядок строк в пределах возвращенного массива не определяется.

Определенный:

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

Возвраты:

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

addNotificationListener

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

Добавляет слушатель зарегистрированного MBean. Уведомления, испускаемые MBean, будут пересланы слушателю.

Если источник уведомления будет ссылкой на объект MBean, то сервер MBean заменит это ObjectName того MBEAN. Иначе источник неизменен.

Определенный:

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

Параметры:

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

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

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

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

Броски:

InstanceNotFoundException - Обеспеченное имя MBean не соответствует ни одного из зарегистрированных MBeans.

См. Также:

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

addNotificationListener

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

Добавляет слушатель зарегистрированного MBean.

Уведомление, испускаемое MBean, будет переслано MBeanServer слушателю. Если источник уведомления будет ссылкой на объект MBean, то сервер MBean заменит это ObjectName того MBEAN. Иначе источник неизменен.

Объект слушателя, который получает уведомления, является тем, который регистрируется в имени в то время, когда этот метод вызывают. Даже если это будет впоследствии незарегистрировано, то это будет продолжать получать уведомления.

Определенный:

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

Параметры:

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

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

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

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

Броски:

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

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

См. Также:

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

removeNotificationListener

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

Описание скопировало с интерфейса: MBeanServerConnection

Удаляет слушателя из зарегистрированного MBean.

Если слушатель будет зарегистрирован не раз, возможно с различными фильтрами или обратными вызовами, то этот метод удалит всю ту регистрацию.

Определенный:

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

Параметры:

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

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

Броски:

InstanceNotFoundException - Обеспеченное имя MBean не соответствует ни одного из зарегистрированных MBeans.

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

См. Также:

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

removeNotificationListener

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

Описание скопировало с интерфейса: MBeanServerConnection

Удаляет слушателя из зарегистрированного MBean.

У MBean должен быть слушатель, который точно соответствует данный listener, filter, и handback параметры. Если есть больше чем один такой слушатель, только один удаляется.

filter и handback параметры могут быть нулем, если и только если они - нуль в слушателе, чтобы быть удаленными.

Определенный:

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

Параметры:

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

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

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

handback - handback, который был определен, когда слушатель был добавлен.

Броски:

InstanceNotFoundException - Обеспеченное имя MBean не соответствует ни одного из зарегистрированных MBeans.

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

См. Также:

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

removeNotificationListener

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

Описание скопировало с интерфейса: MBeanServerConnection

Удаляет слушателя из зарегистрированного MBean.

Если слушатель будет зарегистрирован не раз, возможно с различными фильтрами или обратными вызовами, то этот метод удалит всю ту регистрацию.

Определенный:

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

Параметры:

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

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

Броски:

InstanceNotFoundException - Обеспеченное имя MBean не соответствует ни одного из зарегистрированных MBeans.

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

См. Также:

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

removeNotificationListener

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

Описание скопировало с интерфейса: MBeanServerConnection

Удаляет слушателя из зарегистрированного MBean.

У MBean должен быть слушатель, который точно соответствует данный listener, filter, и handback параметры. Если есть больше чем один такой слушатель, только один удаляется.

filter и handback параметры могут быть нулем, если и только если они - нуль в слушателе, чтобы быть удаленными.

Определенный:

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

Параметры:

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

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

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

handback - handback, который был определен, когда слушатель был добавлен.

Броски:

InstanceNotFoundException - Обеспеченное имя MBean не соответствует ни одного из зарегистрированных MBeans.

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

См. Также:

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

getMBeanInfo

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

Описание скопировало с интерфейса: MBeanServerConnection

Этот метод обнаруживает атрибуты и операции, которые MBean представляет для управления.

Определенный:

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

Параметры:

name - Имя MBean, чтобы проанализировать

Возвраты:

Экземпляр MBeanInfo разрешение извлечения всех атрибутов и операций этого MBean.

Броски:

InstanceNotFoundException - Определенный MBean не был найден.

IntrospectionException - Исключение произошло во время самоанализа.

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

isInstanceOf

boolean isInstanceOf(ObjectName name,
                     String className)
              throws InstanceNotFoundException

Описание скопировало с интерфейса: MBeanServerConnection

Возвращает true, если определенный MBean является экземпляром указанного class, ложь иначе.

Если name не называет MBean, этот метод броски InstanceNotFoundException.

Иначе, позволить
X быть MBean, названным name,
L быть ClassLoder X,
N быть именем class в X MBeanInfo.

Если N равняется className, результатом является истина.

Иначе, если L успешно загружается className и X экземпляр этого class, результатом является истина.

Иначе, если L успешно загружает и N и className, и второй class присваиваем сначала, результатом является истина.

Иначе, результатом является ложь.

Определенный:

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

Параметры:

name - ObjectName из MBean.

className - Имя class.

Возвраты:

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

Броски:

InstanceNotFoundException - Определенный MBean не регистрируется в сервере MBean.

См. Также:

Class.isInstance(java.lang.Object)

инстанцировать

Object instantiate(String className)
            throws ReflectionException,
                   MBeanException

Инстанцирует объекта, используя список всех загрузчиков class, зарегистрированных в сервере MBean Class Loader Repository. У class объекта должен быть общедоступный конструктор. Этот метод возвращает ссылку на недавно создаваемый объект. Недавно создаваемый объект не регистрируется в сервере MBean.

Этот метод эквивалентен instantiate(className, (Object[]) null, (String[]) null).

Параметры:

className - Имя class объекта, который инстанцируют.

Возвраты:

Недавно инстанцированный объект.

Броски:

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

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

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

инстанцировать

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

Инстанцирует объекта, используя Загрузчик class, определенный ObjectName. Если имя загрузчика будет нулем, то ClassLoder, который загрузил Сервер MBean, будет использоваться. У class объекта должен быть общедоступный конструктор. Этот метод возвращает ссылку на недавно создаваемый объект. Недавно создаваемый объект не регистрируется в сервере MBean.

Этот метод эквивалентен instantiate(className, loaderName, (Object[]) null, (String[]) null).

Параметры:

className - Имя class MBean, который инстанцируют.

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

Возвраты:

Недавно инстанцированный объект.

Броски:

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

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

InstanceNotFoundException - Указанный загрузчик class не регистрируется в MBeanServer.

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

инстанцировать

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

Инстанцирует объекта, используя список всех загрузчиков class, зарегистрированных в сервере MBean Class Loader Repository. У class объекта должен быть общедоступный конструктор. Вызов возвращает ссылку на недавно создаваемый объект. Недавно создаваемый объект не регистрируется в сервере MBean.

Параметры:

className - Имя class объекта, который инстанцируют.

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

signature - Массив, содержащий подпись конструктора, который будет вызван.

Возвраты:

Недавно инстанцированный объект.

Броски:

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

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

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

инстанцировать

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

Инстанцирует объекта. Загрузчик class, который будет использоваться, идентифицируется его именем объекта. Если имя объекта загрузчика будет нулем, то ClassLoder, который загрузил сервер MBean, будет использоваться. У class объекта должен быть общедоступный конструктор. Вызов возвращает ссылку на недавно создаваемый объект. Недавно создаваемый объект не регистрируется в сервере MBean.

Параметры:

className - Имя class объекта, который инстанцируют.

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

signature - Массив, содержащий подпись конструктора, который будет вызван.

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

Возвраты:

Недавно инстанцированный объект.

Броски:

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

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

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

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

десериализовать

@Deprecated
ObjectInputStream deserialize(ObjectName name,
                                          byte[] data)
                                   throws InstanceNotFoundException,
                                          OperationsException

Осуждаемый. Использовать getClassLoaderFor получить соответствующий загрузчик class для десериализации.

Десериализовывает байтовый массив в контексте загрузчика class MBean.

Параметры:

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

data - Байтовый массив, чтобы быть де-sererialized.

Возвраты:

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

Броски:

InstanceNotFoundException - Определенный MBean не находится.

OperationsException - Любой обычный Ввод/Вывод связанные исключения.

десериализовать

@Deprecated
ObjectInputStream deserialize(String className,
                                          byte[] data)
                                   throws OperationsException,
                                          ReflectionException

Осуждаемый. Использовать getClassLoaderRepository() получить репозитарий загрузчика class и использовать это, чтобы десериализовать.

Десериализовывает байтовый массив в контексте данного загрузчика class MBean. Загрузчик class находится, загружая class className через Class Loader Repository. Загрузчик class результирующего class является тем, чтобы использовать.

Параметры:

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

data - Байтовый массив, чтобы быть де-sererialized.

Возвраты:

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

Броски:

OperationsException - Любой обычный Ввод/Вывод связанные исключения.

ReflectionException - Указанный class не мог быть загружен репозитарием загрузчика class

десериализовать

@Deprecated
ObjectInputStream deserialize(String className,
                                          ObjectName loaderName,
                                          byte[] data)
                                   throws InstanceNotFoundException,
                                          OperationsException,
                                          ReflectionException

Осуждаемый. Использовать getClassLoader получить загрузчик class для десериализации.

Десериализовывает байтовый массив в контексте данного загрузчика class MBean. Загрузчик class является тем, который загрузил class именем "имя класса". Имя загрузчика class, который будет использоваться для того, чтобы загрузить указанный class, определяется. Если ноль, загрузчик class Сервера MBean будет использоваться.

Параметры:

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

data - Байтовый массив, чтобы быть де-sererialized.

loaderName - Имя загрузчика class, который будет использоваться для того, чтобы загрузить указанный class. Если ноль, загрузчик class Сервера MBean будет использоваться.

Возвраты:

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

Броски:

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

OperationsException - Любой обычный Ввод/Вывод связанные исключения.

ReflectionException - Указанный class не мог быть загружен указанным загрузчиком class.

getClassLoaderFor

ClassLoader getClassLoaderFor(ObjectName mbeanName)
                       throws InstanceNotFoundException

Возвратитесь ClassLoader это использовалось для того, чтобы загрузить class именованного MBean.

Параметры:

mbeanName - ObjectName MBean.

Возвраты:

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

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

То, что это означает, - то, что ClassLoder может быть обернут в другой ClassLoder для безопасности или других причин.

Броски:

InstanceNotFoundException - если именованный MBean не находится.

getClassLoader

ClassLoader getClassLoader(ObjectName loaderName)
                    throws InstanceNotFoundException

Возвратите именованное ClassLoader.

Параметры:

loaderName - ObjectName ClassLoder. Может быть нуль, когда собственный ClassLoder сервера MBean возвращается.

Возвраты:

Именованный ClassLoder. Если l является фактическим ClassLoder с тем именем, и r является возвращенным значением, то также:

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

То, что это означает, - то, что ClassLoder может быть обернут в другой ClassLoder для безопасности или других причин.

Броски:

InstanceNotFoundException - если именованный ClassLoder не находится.

getClassLoaderRepository

ClassLoaderRepository getClassLoaderRepository()

Возвратите ClassLoaderRepository для этого MBeanServer.

Возвраты:

ClassLoaderRepository для этого MBeanServer.