Класс MBeanServerFactory

public class MBeanServerFactory
extends Object

Предоставляет ссылки на серверы MBean. Экземпляры этого класса отсутствуют.

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

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

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

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

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

Методы

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.

Исключения:

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

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

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

createMBeanServer

public static MBeanServer createMBeanServer(String domain)

Параметры:

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

Возвращаемое значение:

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

Исключения:

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

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

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

newMBeanServer

public static MBeanServer newMBeanServer()

Возвращаемое значение:

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

Исключения:

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

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

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

newMBeanServer

public static MBeanServer newMBeanServer(String domain)

Параметры:

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

Возвращаемое значение:

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

Исключения:

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

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

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

findMBeanServer

public static ArrayList<MBeanServer> findMBeanServer(String agentId)

Параметры:

agentId - Идентификатор агента MBeanServer для извлечения. Если этот параметр равен null, возвращаются все зарегистрированные MBeanServer в этом JVM. В противном случае возвращаются только MBeanServer, у которых id равен 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, результат — NullPointerException. Это поведение отличается от того, что было реализовано в JMX 1.1 — где возможность использовать null была устаревшей.

Возвращаемое значение:

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

Исключения:

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

NullPointerException - если server равно null.