Класс MLet

javax.management.loading.MLet

Все реализованные интерфейсы:: Closeable, Externalizable, Serializable, AutoCloseable, MLetMBean, MBeanRegistration

Непосредственные известные подклассы:: PrivateMLet

@Deprecated(since="20", forRemoval=true) public class MLet extends URLClassLoader implements MLetMBean, MBeanRegistration, Externalizable

Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии.

Этот API является частью элементов управления управлением (m-lets), которая является устаревшей функцией, позволяющей загружать удалённые MBean. Эта функция не может использоваться без менеджера безопасности, который устарел и подлежит удалению в будущей версии. Следовательно, этот API также устарел и подлежит удалению. Замены нет.

Позволяет создать и зарегистрировать один или несколько MBean в сервере MBean, полученных из удалённого URL. M-let — это сокращение для элемента управления управлением. Сервис m-let делает это, загружая текстовый файл m-let, который содержит информацию об MBean, которые нужно получить. Информация о каждом MBean указывается в отдельном экземпляре тега, называемого тегом MLET. Путь к текстовому файлу m-let задаётся URL.

Тег MLET имеет следующий синтаксис:

<MLET
CODE = class | OBJECT = serfile
ARCHIVE = "archiveList"
[CODEBASE = codebaseURL]
[NAME = mbeanname]
[VERSION = version]
>
[arglist]
</MLET>

где:

CODE = class

Этот атрибут указывает полное имя класса Java, включая имя пакета, MBean, который необходимо получить. Компилированный .class файл MBean должен находиться в одном из файлов .jar, указанных атрибутом ARCHIVE. Должен присутствовать либо CODE, либо OBJECT.

OBJECT = serfile

Этот атрибут указывает файл .ser, содержащий сериализованное представление MBean, который необходимо получить. Этот файл должен находиться в одном из файлов .jar, указанных атрибутом ARCHIVE. Если файл .jar содержит иерархию каталогов, укажите путь к файлу в этой иерархии. В противном случае соответствие не будет найдено. Должен присутствовать либо CODE, либо OBJECT.

ARCHIVE = "archiveList"

Этот обязательный атрибут указывает один или несколько файлов .jar содержащих MBean или другие ресурсы, используемые получаемым MBean. Один из файлов .jar должен содержать файл, указанный атрибутами CODE или OBJECT Если archivelist содержит более одного файла:

Каждый файл должен быть отделён от следующего запятой (,).
archivelist должен быть заключён в двойные кавычки.

Все файлы .jar в archivelist должны храниться в каталоге, указанном в URL кодовой базы.

CODEBASE = codebaseURL

Этот необязательный атрибут указывает URL кодовой базы получаемого MBean. Он идентифицирует каталог, содержащий файлы .jar указанные атрибутом ARCHIVE. Укажите этот атрибут только если файлы .jar не находятся в той же директории, что и текстовый файл m-let. Если этот атрибут не указан, используется базовый URL текстового файла m-let.

NAME = mbeanname

Этот необязательный атрибут указывает имя объекта, которое будет назначено экземпляру MBean, когда сервис m-let его регистрирует. Если mbeanname начинается с символа двоеточия (:), часть домена имени объекта — это домен сервера MBean по умолчанию, возвращаемый методом MBeanServer.getDefaultDomain().

VERSION = version

Этот необязательный атрибут указывает номер версии MBean и связанных файлов .jar для получения. Этот номер версии можно использовать для указания, что файлы .jar загружаются с сервера, чтобы обновить те, что хранятся локально в кэше, при следующем загрузке текстового файла m-let. version должен быть серией неотрицательных целых десятичных чисел, разделённых точками.

arglist

Этот необязательный атрибут указывает список одного или нескольких параметров для MBean, подлежащего созданию. Этот список описывает параметры, которые будут переданы конструктору MBean. Используйте следующий синтаксис для указания каждого элемента в arglist:

<ARG TYPE=argumentType VALUE=value>

где:

argumentType — тип аргумента, который будет передан в качестве параметра конструктору MBean.

Тип аргументов в списке аргументов должен быть примитивным типом Java или базовым типом Java (java.lang.Boolean, java.lang.Byte, java.lang.Short, java.lang.Long, java.lang.Integer, java.lang.Float, java.lang.Double, java.lang.String).

При загрузке текстового файла m-let создаётся экземпляр каждого MBean, указанного в файле, и он регистрируется.

Сервис m-let расширяет java.net.URLClassLoader и может использоваться для загрузки удалённых классов и jar-файлов в виртуальной машине агента.

Примечание - Загрузчик классов MLet использует MBeanServerFactory.getClassLoaderRepository(javax.management.MBeanServer) для загрузки классов, которые не были найдены в загруженных jar-файлах.

С тех пор:

1.5

См. также:

Краткое описание конструкторов

Конструктор	Описание
`MLet()`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Создаёт новый MLet с родительским ClassLoader по умолчанию.
`MLet(URL[] urls)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Создаёт новый MLet для указанных URL-адресов с родительским ClassLoader по умолчанию.
`MLet(URL[] urls, boolean delegateToCLR)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Создаёт новый MLet для указанных URL-адресов с родительским ClassLoader по умолчанию.
`MLet(URL[] urls, ClassLoader parent)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Создаёт новый MLet для заданных URL-адресов.
`MLet(URL[] urls, ClassLoader parent, boolean delegateToCLR)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Создаёт новый MLet для заданных URL-адресов.
`MLet(URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Создаёт новый MLet для указанных URL-адресов, родительского ClassLoader и URLStreamHandlerFactory.
`MLet(URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory, boolean delegateToCLR)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Создаёт новый MLet для указанных URL-адресов, родительского ClassLoader и URLStreamHandlerFactory.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`addURL(String url)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Добавляет указанный URL-адрес в список URL-адресов для поиска классов и ресурсов.
`void`	`addURL(URL url)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Добавляет указанный URL-адрес в список URL-адресов для поиска классов и ресурсов.
`protected URL`	`check(String version, URL codebase, String jarfile, MLetContent mlet)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Этот метод должен быть переопределён при расширении данного сервиса для поддержки кэширования и версионирования.
`protected Class<?>`	`findClass(String name)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Основной метод для class loader, который переопределяется.
`protected String`	`findLibrary(String libname)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Возвращает абсолютный путь к файлу нативной библиотеки.
`String`	`getLibraryDirectory()`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Получает текущий каталог, используемый загрузчиком библиотек для хранения нативных библиотек перед их загрузкой в память.
`Set<Object>`	`getMBeansFromURL(String url)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Загружает текстовый файл с тегами MLET, определяющими MBeans, которые должны быть добавлены в сервер MBean.
`Set<Object>`	`getMBeansFromURL(URL url)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Загружает текстовый файл с тегами MLET, определяющими MBeans, которые должны быть добавлены в сервер MBean.
`URL[]`	`getURLs()`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Возвращает путь поиска URL-адресов для загрузки классов и ресурсов.
`Class<?>`	`loadClass(String name, ClassLoaderRepository clr)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Загружает класс, используя заданный `ClassLoaderRepository`, если класс не найден в URL-адресах данного MLet.
`void`	`postDeregister()`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Позволяет m-let выполнить все необходимые операции после того, как он был аннулирован на сервере MBean.
`void`	`postRegister(Boolean registrationDone)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Позволяет m-let выполнить все необходимые операции после того, как он был зарегистрирован на сервере MBean или после того, как регистрация не удалась.
`void`	`preDeregister()`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Позволяет m-let выполнить все необходимые операции перед тем, как он будет аннулирован сервером MBean.
`ObjectName`	`preRegister(MBeanServer server, ObjectName name)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Позволяет m-let выполнить все необходимые операции перед тем, как он будет зарегистрирован на сервере MBean.
`void`	`readExternal(ObjectInput in)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Восстанавливает содержимое этого MLet из заданного `ObjectInput`.
`void`	`setLibraryDirectory(String libdir)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Устанавливает каталог, используемый загрузчиком библиотек для хранения нативных библиотек перед их загрузкой в память.
`void`	`writeExternal(ObjectOutput out)`	Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии. Сохраняет содержимое этого MLet в заданном `ObjectOutput`.

Методы, унаследованные от класса java.net.URLClassLoader

close, definePackage, findResource, findResources, getPermissions, getResourceAsStream, newInstance, newInstance

Методы, унаследованные от класса java.security.SecureClassLoader

defineClass, defineClass

Методы, унаследованные от класса java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findClass, findLoadedClass, findResource, findSystemClass, getClassLoadingLock, getDefinedPackage, getDefinedPackages, getName, getPackage, getPackages, getParent, getPlatformClassLoader, getResource, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, getUnnamedModule, isRegisteredAsParallelCapable, loadClass, loadClass, registerAsParallelCapable, resolveClass, resources, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Методы, унаследованные от класса java.lang.Object

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

Методы, унаследованные от интерфейса javax.management.loading.MLetMBean

getResource, getResourceAsStream, getResources