javax.management.loading

Класс MLet

java.lang. Объект

java.lang. ClassLoder

java.security. SecureClassLoader

java.net. URLClassLoader

javax.management.loading. MLet

Все Реализованные Интерфейсы:

Closeable, Externalizable, Сериализуемый, AutoCloseable, MLetMBean, MBeanRegistration

Прямые Известные Подклассы:

PrivateMLet

public class MLet
extends URLClassLoader
implements MLetMBean, MBeanRegistration, Externalizable

Позволяет Вам инстанцировать и регистрировать одни или несколько MBeans в сервере MBean, прибывающем из удаленного URL. Позволенный м. ярлык для апплета управления. Позволенная м. служба делает это, загружая позволенный м. текстовый файл, который определяет информацию о MBeans, который будет получен. Информация о каждом MBean определяется в единственном экземпляре тега, названного тегом MLET. Расположение позволенного м. текстового файла определяется 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 файлы, содержащие MBeans или другие ресурсы, используемые MBean, который будет получен. Один из .jar файлы должны содержать файл, определенный CODE или OBJECT атрибут. Если archivelist содержит больше чем один файл:

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

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

CODEBASE = codebaseURL

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

NAME = mbeanname

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

VERSION = version

Этот дополнительный атрибут определяет номер версии MBean и связанный .jar файлы, которые будут получены. Этот номер версии может использоваться, чтобы определить что .jar файлы загружаются из сервера, чтобы обновить сохраненных локально в кэше в следующий раз, когда позволенный м. текстовый файл загружается. 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).

Когда позволенный м. текстовый файл загружается, экземпляр каждого MBean, определенного в файле, создается и регистрируется.

Позволенная м. служба расширяется java.net.URLClassLoader и может использоваться, чтобы загрузить удаленные классы и файлы фляги в VM агента.

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

С тех пор:

1.5

См. Также:

Сериализированная Форма

Сводка конструктора

Конструкторы

Конструктор и Описание
MLet() Создает новый MLet использование родительского ClassLoder делегации по умолчанию.
MLet(URL[] urls) Создает новый MLet для указанных URL, используя родительский ClassLoder делегации по умолчанию.
MLet(URL[] urls, boolean delegateToCLR) Создает новый MLet для указанных URL, используя родительский ClassLoder делегации по умолчанию.
MLet(URL[] urls, ClassLoader parent) Создает новый MLet для данных URL.
MLet(URL[] urls, ClassLoader parent, boolean delegateToCLR) Создает новый MLet для данных URL.
MLet(URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory) Создает новый MLet для указанных URL, загрузчика родительского класса, и URLStreamHandlerFactory.
MLet(URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory, boolean delegateToCLR) Создает новый MLet для указанных URL, загрузчика родительского класса, и URLStreamHandlerFactory.

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

Методы

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

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

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

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

defineClass, defineClass

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

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findLoadedClass, findSystemClass, getClassLoadingLock, getPackage, getPackages, getParent, getResource, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, loadClass, registerAsParallelCapable, resolveClass, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

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

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

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

getResource, getResourceAsStream, getResources

Деталь конструктора

MLet

public MLet()

Создает новый MLet использование родительского ClassLoder делегации по умолчанию.

MLet

public MLet(URL[] urls)

Создает новый MLet для указанных URL, используя родительский ClassLoder делегации по умолчанию. URL будут искаться в порядке, определенном для классов и ресурсов после первого поиска в загрузчике родительского класса.

Параметры:

urls - URL, из которых можно загрузить классы и ресурсы.

MLet

public MLet(URL[] urls,
    ClassLoader parent)

Создает новый MLet для данных URL. URL будут искаться в порядке, определенном для классов и ресурсов после первого поиска в указанном загрузчике родительского класса. Родительский параметр будет использоваться в качестве загрузчика родительского класса для делегации.

Параметры:

urls - URL, из которых можно загрузить классы и ресурсы.

parent - Загрузчик родительского класса для делегации.

MLet

public MLet(URL[] urls,
    ClassLoader parent,
    URLStreamHandlerFactory factory)

Создает новый MLet для указанных URL, загрузчика родительского класса, и URLStreamHandlerFactory. Родительский параметр будет использоваться в качестве загрузчика родительского класса для делегации. Параметр фабрики будет использоваться в качестве потоковой фабрики обработчиков, чтобы получить обработчики протокола, создавая новые URL.

Параметры:

urls - URL, из которых можно загрузить классы и ресурсы.

parent - Загрузчик родительского класса для делегации.

factory - URLStreamHandlerFactory, чтобы использовать, создавая URL.

MLet

public MLet(URL[] urls,
    boolean delegateToCLR)

Создает новый MLet для указанных URL, используя родительский ClassLoder делегации по умолчанию. URL будут искаться в порядке, определенном для классов и ресурсов после первого поиска в загрузчике родительского класса.

Параметры:

urls - URL, из которых можно загрузить классы и ресурсы.

delegateToCLR - Истина, если, когда класс не находится или в родительском ClassLoder или в URL, MLet должен делегировать к его содержанию MBeanServer ClassLoaderRepository.

MLet

public MLet(URL[] urls,
    ClassLoader parent,
    boolean delegateToCLR)

Создает новый MLet для данных URL. URL будут искаться в порядке, определенном для классов и ресурсов после первого поиска в указанном загрузчике родительского класса. Родительский параметр будет использоваться в качестве загрузчика родительского класса для делегации.

Параметры:

urls - URL, из которых можно загрузить классы и ресурсы.

parent - Загрузчик родительского класса для делегации.

delegateToCLR - Истина, если, когда класс не находится или в родительском ClassLoder или в URL, MLet должен делегировать к его содержанию MBeanServer ClassLoaderRepository.

MLet

public MLet(URL[] urls,
    ClassLoader parent,
    URLStreamHandlerFactory factory,
    boolean delegateToCLR)

Создает новый MLet для указанных URL, загрузчика родительского класса, и URLStreamHandlerFactory. Родительский параметр будет использоваться в качестве загрузчика родительского класса для делегации. Параметр фабрики будет использоваться в качестве потоковой фабрики обработчиков, чтобы получить обработчики протокола, создавая новые URL.

Параметры:

urls - URL, из которых можно загрузить классы и ресурсы.

parent - Загрузчик родительского класса для делегации.

factory - URLStreamHandlerFactory, чтобы использовать, создавая URL.

delegateToCLR - Истина, если, когда класс не находится или в родительском ClassLoder или в URL, MLet должен делегировать к его содержанию MBeanServer ClassLoaderRepository.

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

addURL

public void addURL(URL url)

Добавляет указанный URL к списку URL, чтобы искать классы и ресурсы.

Определенный:

addURL в интерфейсе MLetMBean

Переопределения:

addURL в классе URLClassLoader

Параметры:

url - URL, который будет добавлен к пути поиска URL

addURL

public void addURL(String url)
            throws ServiceNotFoundException

Добавляет указанный URL к списку URL, чтобы искать классы и ресурсы.

Определенный:

addURL в интерфейсе MLetMBean

Параметры:

url - URL, чтобы добавить.

Броски:

ServiceNotFoundException - Указанный URL уродлив.

getURLs

public URL[] getURLs()

Возвращает путь поиска URL для того, чтобы загрузить классы и ресурсы. Это включает исходный список URL, определенных конструктору, наряду с любыми URL, впоследствии добавленными addURL () метод.

Определенный:

getURLs в интерфейсе MLetMBean

Переопределения:

getURLs в классе URLClassLoader

Возвраты:

путь поиска URL для того, чтобы загрузить классы и ресурсы.

getMBeansFromURL

public Set<Object> getMBeansFromURL(URL url)
                             throws ServiceNotFoundException

Загружает текстовый файл, содержащий теги MLET, которые определяют MBeans, который будет добавлен к серверу MBean. Расположение текстового файла определяется URL. MBeans, определенный в файле MLET, инстанцируют и регистрироваться в сервере MBean.

Определенный:

getMBeansFromURL в интерфейсе MLetMBean

Параметры:

url - URL текстового файла, который будет загружен как объект URL.

Возвраты:

Набор, содержащий одну запись на тег MLET в позволенном м. текстовом файле, загружался. Каждая запись определяет или ObjectInstance для создаваемого MBean, или объект throwable (то есть, ошибка или исключение), если MBean не мог бы быть создан.

Броски:

ServiceNotFoundException - Одна из следующих ошибок произошла: позволенный м. текстовый файл не содержит тег MLET, позволенный м. текстовый файл не находится, обязательный атрибут тега MLET не определяется, значение url является нулем.

IllegalStateException - MLet MBean не регистрируется в MBeanServer.

getMBeansFromURL

public Set<Object> getMBeansFromURL(String url)
                             throws ServiceNotFoundException

Загружает текстовый файл, содержащий теги MLET, которые определяют MBeans, который будет добавлен к серверу MBean. Расположение текстового файла определяется URL. MBeans, определенный в файле MLET, инстанцируют и регистрироваться в сервере MBean.

Определенный:

getMBeansFromURL в интерфейсе MLetMBean

Параметры:

url - URL текстового файла, который будет загружен как Строковый объект.

Возвраты:

Набор, содержащий одну запись на тег MLET в позволенном м. текстовом файле, загружался. Каждая запись определяет или ObjectInstance для создаваемого MBean, или объект throwable (то есть, ошибка или исключение), если MBean не мог бы быть создан.

Броски:

ServiceNotFoundException - Одна из следующих ошибок произошла: позволенный м. текстовый файл не содержит тег MLET, позволенный м. текстовый файл не находится, обязательный атрибут тега MLET не определяется, url уродлив.

IllegalStateException - MLet MBean не регистрируется в MBeanServer.

getLibraryDirectory

public String getLibraryDirectory()

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

Определенный:

getLibraryDirectory в интерфейсе MLetMBean

Возвраты:

Текущий каталог используется загрузчиком библиотеки.

Броски:

UnsupportedOperationException - если эта реализация не поддерживает хранящие собственные библиотеки таким образом.

См. Также:

setLibraryDirectory(java.lang.String)

setLibraryDirectory

public void setLibraryDirectory(String libdir)

Устанавливает каталог, используемый загрузчиком библиотеки для того, чтобы сохранить собственные библиотеки прежде, чем они будут загружены в память.

Определенный:

setLibraryDirectory в интерфейсе MLetMBean

Параметры:

libdir - Каталог используется загрузчиком библиотеки.

Броски:

UnsupportedOperationException - если эта реализация не поддерживает хранящие собственные библиотеки таким образом.

См. Также:

getLibraryDirectory()

предварительный регистр

public ObjectName preRegister(MBeanServer server,
                     ObjectName name)
                       throws Exception

Позволяет позволенному м. выполнять любые операции, в которых это нуждается прежде, чем быть зарегистрированным в сервере MBean. Если ObjectName является нулем, позволенный м. обеспечивает имя по умолчанию для своей регистрации <defaultDomain>:type=MLet

Определенный:

preRegister в интерфейсе MBeanRegistration

Параметры:

server - Сервер MBean, в котором будет зарегистрирован позволенный м.

name - Имя объекта позволенного м.

Возвраты:

Имя зарегистрированного позволенного м.

Броски:

Exception - Это исключение должно быть поймано сервером MBean и повторно брошено как MBeanRegistrationException.

пострегистр

public void postRegister(Boolean registrationDone)

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

Определенный:

postRegister в интерфейсе MBeanRegistration

Параметры:

registrationDone - Указывает, был ли позволенный м. успешно зарегистрирован в сервере MBean. Ложь значения означает, что любой регистрационная фаза перестал работать.

предварительно вычеркнуть из списка

public void preDeregister()
                   throws Exception

Позволяет позволенному м. выполнять любые операции, в которых это нуждается перед стать незарегистрированным сервером MBean.

Определенный:

preDeregister в интерфейсе MBeanRegistration

Броски:

java.langException - Это исключение должно быть поймано сервером MBean и повторно брошено как MBeanRegistrationException.

Exception - Это исключение будет поймано сервером MBean и повторно брошено как MBeanRegistrationException.

поствычеркнуть из списка

public void postDeregister()

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

Определенный:

postDeregister в интерфейсе MBeanRegistration

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException,
                          UnsupportedOperationException

Сохраните содержание этого MLET к данному ObjectOutput. Не все реализации поддерживают этот метод. Те, которые не бросают UnsupportedOperationException. Подкласс может переопределить этот метод, чтобы поддерживать это или изменить формат записанных данных.

Формат записанных данных не определяется, но если реализация поддерживает writeExternal(java.io.ObjectOutput) это должно также поддерживать readExternal(java.io.ObjectInput) таким способом, который, что пишется прежним, может быть считан последним.

Определенный:

writeExternal в интерфейсе Externalizable

Параметры:

out - Объектный поток вывода, чтобы записать в.

Броски:

IOException - Если проблема произошла при записи.

UnsupportedOperationException - Если эта реализация не поддерживает эту работу.

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
                         ClassNotFoundException,
                         UnsupportedOperationException

Восстановите содержание этого MLET от данного ObjectInput. Не все реализации поддерживают этот метод. Те, которые не бросают UnsupportedOperationException. Подкласс может переопределить этот метод, чтобы поддерживать это или изменить формат данных чтения.

Формат данных чтения не определяется, но если реализация поддерживает readExternal(java.io.ObjectInput) это должно также поддерживать writeExternal(java.io.ObjectOutput) таким способом, который, что пишется последним, может быть считан прежним.

Определенный:

readExternal в интерфейсе Externalizable

Параметры:

in - Объектный входной поток, чтобы читать из.

Броски:

IOException - если проблема произошла, читая.

ClassNotFoundException - если класс для восстанавливаемого объекта не может быть найден.

UnsupportedOperationException - если эта реализация не поддерживает эту работу.

loadClass

public Class<?> loadClass(String name,
                 ClassLoaderRepository clr)
                   throws ClassNotFoundException

Загрузите класс, используя данный ClassLoaderRepository если класс не находится в URL этого MLET. Данный ClassLoaderRepository может быть нулем, когда a ClassNotFoundException сразу происходит, если класс не находится в URL этого MLET.

Параметры:

name - Имя класса мы хотим загрузиться.

clr - ClassLoaderRepository, который будет использоваться, чтобы искать данный класс, если это не будет найдено в этом ClassLoder. Может быть нуль.

Возвраты:

Получающийся объект Класса.

Броски:

ClassNotFoundException - Указанный класс не мог быть найден в этом ClassLoder, ни в данном ClassLoaderRepository.

findClass

protected Class<?> findClass(String name)
                      throws ClassNotFoundException

Это - основной метод для загрузчиков класса, который пересматривается.

Переопределения:

findClass в классе URLClassLoader

Параметры:

name - Имя класса.

Возвраты:

Получающийся объект Класса.

Броски:

ClassNotFoundException - Указанный класс не мог быть найден.

findLibrary

protected String findLibrary(String libname)

Возвращает абсолютный путь собственной библиотеки. VM вызывает этот метод, чтобы определить местоположение собственных библиотек, которые принадлежат классам, загруженным этим загрузчиком класса. Библиотеки ищутся в файлах JAR, использующих сначала только собственное имя библиотеки и если не найденный собственным именем библиотеки вместе с архитектурно-зависимым путем (OSName/OSArch/OSVersion/lib/nativelibname), то есть.

библиотека stat на SPARC Соляриса 5.7 будет искаться в файле JAR как:

1. libstat.so
2. SunOS/sparc/5.7/lib/libstat.so

библиотека stat на Windows NT 4.0 будет искаться в файле JAR как:

1. stat.dll
2. WindowsNT/x86/4.0/lib/stat.dll

Более определенно позволить nativelibname будьте результатом System.mapLibraryName(libname). Затем следующие имена ищутся в файлах JAR в порядке:
nativelibname
<os.name>/<os.arch>/<os.version>/lib/nativelibname
где <X> средства System.getProperty(X) с любыми пробелами в результате, удаленном, и / стенды для символа разделителя файлов (File.separator).

Если этот метод возвращается null, то есть библиотеки не были найдены ни в одном из файлов JAR, загруженных этим загрузчиком класса, VM ищет библиотеку вдоль пути, определенного как java.library.path свойство.

Переопределения:

findLibrary в классе ClassLoader

Параметры:

libname - Имя библиотеки.

Возвраты:

Абсолютный путь собственной библиотеки.

См. Также:

System.loadLibrary(String), System.mapLibraryName(String)

проверить

protected URL check(String version,
        URL codebase,
        String jarfile,
        MLetContent mlet)
             throws Exception

Этот метод должен быть переопределен, расширяя эту службу, чтобы поддерживать кэширование и управление версиями. От этого вызывают getMBeansFromURL когда версия, кодовая база, и jarfile были извлечены из файла MLet, и могут использоваться, чтобы проверить, что это в порядке, чтобы загрузить данный MBean, или заменить данный URL различным.

Реализация по умолчанию этого метода возвраты codebase неизменный.

Параметры:

version - Номер версии .jar файл, хранивший локально.

codebase - Базовый URL удаленного .jar файл.

jarfile - Имя .jar файл, который будет загружен.

mlet - MLetContent экземпляр, который представляет MLET тег.

Возвраты:

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

Броски:

Exception - если MBean не должен быть загружен по некоторым причинам. Исключение будет добавлено к набору, возвращенному getMBeansFromURL.