Интерфейс MBeanServer

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

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

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

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

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

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

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

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

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

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

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

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

Извлекает значения нескольких атрибутов именованного 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);
 }
 

Устанавливает значения нескольких атрибутов именованного 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);
 }
 

Вызывает операцию на MBean.

Из-за необходимости signature для различения потенциально перегруженных операций, намного проще вызывать операции через прокси MBean, где это возможно. Например, предположим, что у вас есть интерфейс Standard 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);
 

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

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

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

Уведомление, испускаемое MBean, будет перенаправлено сервером MBean слушателю. Если источник уведомления — ссылка на объект MBean, сервер MBean заменит его именем объекта этого MBean. В противном случае источник остаётся неизменным.

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

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

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

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

Параметры filter и handback могут быть null, если и только если они являются null в удаляемом слушателе.

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

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

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

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

Параметры filter и handback могут быть null, если и только если они являются null в удаляемом слушателе.

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

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

В противном случае, пусть
X — MBean, имя которого указано в name,
L — загрузчик классов X,
N — имя класса в MBeanInfo X.

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

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

В противном случае, если L успешно загружает N и className, и второй класс наследуется от первого, результат — true.

В противном случае, результат — false.

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

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

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

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

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

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

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

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

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

Возвращает ClassLoader, который использовался для загрузки класса указанного MBean.

Возвращает указанный ClassLoader.

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