Интерфейс MBeanServerConnection

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

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

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

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

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

Получает значения нескольких атрибутов именованного 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, будет перенаправлено сервером MBeanServer слушателю. Если источником уведомления является ссылка на объект 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 — ClassLoader объекта X,
N — имя класса в MBeanInfo объекта X.

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

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

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

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