compact3

javax.management

Класс MBeanServerFactory

java.lang. Объект

javax.management. MBeanServerFactory

public class MBeanServerFactory
extends Object

Обеспечивает ссылки сервера MBean. Нет никаких экземпляров этого class.

Начиная с JMX 1.2 этих class позволяет заменить значение по умолчанию реализация MBeanServer. Это делается, используя MBeanServerBuilder class. class начального MBeanServerBuilder, который инстанцируют, может быть определен через javax.management.builder.initial системное свойство. Указанный class должен быть общедоступным подклассом MBeanServerBuilder, и должен иметь общедоступного пустого конструктора.

По умолчанию, если никакое значение для того свойства не определяется, экземпляр javax.management.MBeanServerBuilder создается. Иначе, MBeanServerFactory пытается загрузить указанное использование class Thread.currentThread().getContextClassLoader(), или если это - нуль, Class.forName(). Затем это создает начальный экземпляр того использования Класса Class.newInstance(). Если какое-либо проверенное исключение повышается во время этого процесса (например. ClassNotFoundException, InstantiationException) MBeanServerFactory распространит это исключение изнутри RuntimeException.

С javax.management.builder.initial системным свойством консультируются каждый раз, когда новый MBeanServer должен быть создан, и class, на который указывает то свойство, загружается. Если, что class отличается от того из текущих MBeanServerBuilder, то новый MBeanServerBuilder создается. Иначе, MBeanServerFactory может создать новый MBeanServerBuilder или снова использовать текущий.

Если class, на который указывает свойство, не может быть загружен, или не соответствует допустимому подклассу MBeanServerBuilder тогда, исключение распространяется, и никакой MBeanServer не может быть создан, пока javax.management.builder.initial системное свойство не сбрасывается к допустимому значению.

MBeanServerBuilder позволяет обернуть MBeanServers, возвращенный значением по умолчанию реализация MBeanServerBuilder, с целью например, добавления дополнительного уровня безопасности.

С тех пор:

1.5

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

Модификатор и Тип	Метод и Описание
static MBeanServer	createMBeanServer() Возвратите новый объект, реализовывая интерфейс MBeanServer со стандартным доменным именем значения по умолчанию.
static MBeanServer	createMBeanServer(String domain) Возвратите новый объект, реализовывая MBeanServer интерфейс с указанным доменным именем значения по умолчанию.
static ArrayList<MBeanServer>	findMBeanServer(String agentId) Возвратите список зарегистрированных объектов MBeanServer.
static ClassLoaderRepository	getClassLoaderRepository(MBeanServer server) Возвратите ClassLoaderRepository, используемый данным MBeanServer.
static MBeanServer	newMBeanServer() Возвратите новый объект, реализовывая интерфейс MBeanServer со стандартным доменным именем значения по умолчанию, не сохраняя внутреннюю ссылку на этот новый объект.
static MBeanServer	newMBeanServer(String domain) Возвратите новый объект, реализовывая интерфейс MBeanServer с указанным доменным именем значения по умолчанию, не сохраняя внутреннюю ссылку на этот новый объект.
static void	releaseMBeanServer(MBeanServer mbeanServer) Удалите внутренние ссылки MBeanServerFactory на создаваемый MBeanServer.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

releaseMBeanServer

public static void releaseMBeanServer(MBeanServer mbeanServer)

Удалите внутренние ссылки MBeanServerFactory на создаваемый MBeanServer. Это позволяет сборщику "мусора" удалять объект MBeanServer.

Параметры:

mbeanServer - MBeanServer возражают, чтобы удалить.

Броски:

IllegalArgumentException - если mbeanServer не был сгенерирован одним из createMBeanServer методы, или если releaseMBeanServer был уже вызван на этом.

SecurityException - если есть SecurityManager, и полномочия вызывающей стороны не включают или подразумевают MBeanServerPermission("releaseMBeanServer").

createMBeanServer

public static MBeanServer createMBeanServer()

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

Стандартное доменное имя значения по умолчанию DefaultDomain.

Ссылка MBeanServer внутренне сохраняется. Это позволит findMBeanServer возвратить ссылку на этот объект MBeanServer.

Этот метод эквивалентен createMBeanServer(null).

Возвраты:

недавно создаваемый MBeanServer.

Броски:

SecurityException - если есть SecurityManager, и полномочия вызывающей стороны не включают или подразумевают MBeanServerPermission("createMBeanServer").

JMRuntimeException - если свойство javax.management.builder.initial существует, но class, который это называет, нельзя инстанцировать через общедоступного конструктора без параметров; или если инстанцированный разработчик возвращает нуль из newMBeanServerDelegate или newMBeanServer методы.

ClassCastException - если свойство javax.management.builder.initial существует и может быть инстанцирован, но не присвоение, совместимое с MBeanServerBuilder.

createMBeanServer

public static MBeanServer createMBeanServer(String domain)

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

Ссылка MBeanServer внутренне сохраняется. Это позволит findMBeanServer возвратить ссылку на этот объект MBeanServer.

Параметры:

domain - доменное имя значения по умолчанию для создаваемого MBeanServer. Это - значение, которое будет возвращено MBeanServer.getDefaultDomain().

Возвраты:

недавно создаваемый MBeanServer.

Броски:

SecurityException - если есть SecurityManager, и полномочия вызывающей стороны не включают или подразумевают MBeanServerPermission("createMBeanServer").

JMRuntimeException - если свойство javax.management.builder.initial существует, но class, который это называет, нельзя инстанцировать через общедоступного конструктора без параметров; или если инстанцированный разработчик возвращает нуль из newMBeanServerDelegate или newMBeanServer методы.

ClassCastException - если свойство javax.management.builder.initial существует и может быть инстанцирован, но не присвоение, совместимое с MBeanServerBuilder.

newMBeanServer

public static MBeanServer newMBeanServer()

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

Стандартное доменное имя значения по умолчанию DefaultDomain.

Никакая ссылка не сохраняется. findMBeanServer не будет в состоянии возвратить ссылку на этот объект MBeanServer, но сборщик "мусора" будет в состоянии удалить объект MBeanServer, когда на это больше не сошлются.

Этот метод эквивалентен newMBeanServer(null).

Возвраты:

недавно создаваемый MBeanServer.

Броски:

SecurityException - если есть SecurityManager, и полномочия вызывающей стороны не включают или подразумевают MBeanServerPermission("newMBeanServer").

JMRuntimeException - если свойство javax.management.builder.initial существует, но class, который это называет, нельзя инстанцировать через общедоступного конструктора без параметров; или если инстанцированный разработчик возвращает нуль из newMBeanServerDelegate или newMBeanServer методы.

ClassCastException - если свойство javax.management.builder.initial существует и может быть инстанцирован, но не присвоение, совместимое с MBeanServerBuilder.

newMBeanServer

public static MBeanServer newMBeanServer(String domain)

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

Никакая ссылка не сохраняется. findMBeanServer не будет в состоянии возвратить ссылку на этот объект MBeanServer, но сборщик "мусора" будет в состоянии удалить объект MBeanServer, когда на это больше не сошлются.

Параметры:

domain - доменное имя значения по умолчанию для создаваемого MBeanServer. Это - значение, которое будет возвращено MBeanServer.getDefaultDomain().

Возвраты:

недавно создаваемый MBeanServer.

Броски:

SecurityException - если есть SecurityManager, и полномочия вызывающей стороны не включают или подразумевают MBeanServerPermission("newMBeanServer").

JMRuntimeException - если свойство javax.management.builder.initial существует, но class, который это называет, нельзя инстанцировать через общедоступного конструктора без параметров; или если инстанцированный разработчик возвращает нуль из newMBeanServerDelegate или newMBeanServer методы.

ClassCastException - если свойство javax.management.builder.initial существует и может быть инстанцирован, но не присвоение, совместимое с MBeanServerBuilder.

findMBeanServer

public static ArrayList<MBeanServer> findMBeanServer(String agentId)

Возвратите список зарегистрированных объектов MBeanServer. Зарегистрированный объект MBeanServer является тем, который создавался одним из createMBeanServer методы и не впоследствии выпущенный с releaseMBeanServer.

Параметры:

agentId - Идентификатор агента MBeanServer, чтобы получить. Если этот параметр является нулем, все зарегистрировались, MBeanServers в этой JVM возвращаются. Иначе, только MBeanServers, идентификатор которого равен agentId возвращаются. Идентификатор MBeanServer MBeanServerId атрибут его делегата MBean.

Возвраты:

Список объектов MBeanServer.

Броски:

SecurityException - если есть SecurityManager, и полномочия вызывающей стороны не включают или подразумевают MBeanServerPermission("findMBeanServer").

getClassLoaderRepository

public static ClassLoaderRepository getClassLoaderRepository(MBeanServer server)

Возвратите ClassLoaderRepository, используемый данным MBeanServer. Этот метод эквивалентен server.getClassLoaderRepository().

Параметры:

server - MBeanServer при исследовании. Начиная с JMX 1.2, если server null, результатом является a NullPointerException. Это поведение отличается от того, что было реализовано в JMX 1.1 - где возможность использовать null осуждался.

Возвраты:

Репозитарий Загрузчика Класса используется данным MBeanServer.

Броски:

SecurityException - если есть SecurityManager, и полномочия вызывающей стороны не включают или подразумевают MBeanPermission("getClassLoaderRepository").

NullPointerException - если server нуль.