Интерфейс 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 с ObjectName, чей 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 — ClassLoader объекта X,
N — имя класса в MBeanInfo объекта X.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает хранилище загрузчиков классов для этого сервера MBean.