Интерфейс 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, будет перенаправлено сервером 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.