compact3

javax.management.loading

Class MLet

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

javax.management.loading.MLet

All Implemented Interfaces:

Closeable， Externalizable， Serializable， AutoCloseable， MLetMBean， MBeanRegistration

已知直接子类：

PrivateMLet

public class MLet
extends URLClassLoader
implements MLetMBean, MBeanRegistration, Externalizable

可以实例化和从远程URL来登记的MBean服务器的一个或几个MBeans。m-let是一个管理程序的快捷方式。的m-let服务是通过加载一个m-let文本文件，它指定要获得对MBeans信息。在每个MBean信息在标签的一个实例说明，称为熔体标签。m-let的文本文件的位置是通过URL指定的。

的MLET标签具有以下语法：

< MLET
CODE = 班 | OBJECT = serfile
ARCHIVE = "archivelist"
[CODEBASE = codebaseurl]
[NAME = mbeanname]
z-6aa2eb7c-d8d8-4ccb—9bc0-a2fb0c5e5f04版本]
>
[参数列表]
/MLET > <

哪里:

CODE = 班

此属性指定完整的java类的名称，包括包名的MBean得到。 .class文件编译的MBean必须包含在一个由 ARCHIVE属性指定的 .jar文件。无论是 CODE或 OBJECT必须在场。

OBJECT = serfile

此属性指定包含的序列化表示MBean得到 .ser文件。这个文件必须包含在一个由 ARCHIVE属性指定的 .jar文件。如果 .jar文件包含一个指定的目录层次，在这个层次的文件的路径。否则将找不到匹配的。无论是 CODE或 OBJECT必须在场。

ARCHIVE = " archivelist "

这种强制属性指定一个或多个含有MBeans或MBean用来获得其他资源 .jar文件。其中的一个 .jar文件必须包含指定的文件的 CODE或 OBJECT属性。如果archivelist包含多个文件：

• 每个文件必须从下面的一个逗号（，）。
• archivelist必须用双引号。

所有 .jar文件 archivelist必须存储的代码库的URL指定的目录。

CODEBASE = codebaseurl

此可选属性指定要得到的MBean的代码库的URL。它标识包含的 ARCHIVE属性指定的 .jar文件的目录。只有 .jar文件不在同一个目录下的文本文件中指定此属性m-let。如果这个属性没有被指定，该m-let文本文件的基URL使用。

NAME = mbeanname

此可选属性指定要分配到MBean实例时，m-let服务注册对象名称。如果 mbeanname开始用冒号（：），该对象的名称的域部分是MBean服务器的默认域，返回的 MBeanServer.getDefaultDomain()。

VERSION = 版本

此可选属性指定的MBean版本号和相关文件得到 .jar。这个版本号可以用于指定的 .jar文件加载从服务器更新存储在本地缓存中的下一次m-let文本文件加载。 版本必须进行一系列的非负十进制整数每相隔一段从一个之前。

参数列表

此可选属性指定一个MBean被实例化一个或多个参数列表。下面列出了可通过MBean的构造函数的参数。使用下面的语法在 参数列表指定每个项目：

< ARG TYPE= argumenttype 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文件中找到。

从以下版本开始：

一点五

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor and Description
MLet() 构建了一种新的熔体使用默认母ClassLoader代表团。
MLet(URL[] urls) 构建了一种新的熔体为指定的URL使用默认母ClassLoader代表团。
MLet(URL[] urls, boolean delegateToCLR) 构建了一种新的熔体为指定的URL使用默认母ClassLoader代表团。
MLet(URL[] urls, ClassLoader parent) 构建了一种新的熔体为给定的URL。
MLet(URL[] urls, ClassLoader parent, boolean delegateToCLR) 构建了一种新的熔体为给定的URL。
MLet(URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory) 构建了一种新的熔体为指定的URL，父类装载器，并urlstreamhandlerfactory。
MLet(URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory, boolean delegateToCLR) 构建了一种新的熔体为指定的URL，父类装载器，并urlstreamhandlerfactory。

方法摘要

Modifier and Type	Method and Description
void	addURL(String url) 将指定的URL的URL列表搜索类和资源。
void	addURL(URL url) 将指定的URL的URL列表搜索类和资源。
protected URL	check(String version, URL codebase, String jarfile, MLetContent mlet) 该方法被重写时，将服务支持缓存和版本控制。
protected 类<?>	findClass(String name) 这是正在重新定义的类装载器的主要方法。
protected String	findLibrary(String libname) 返回本地库的绝对路径名。
String	getLibraryDirectory() 获取库装载机在将它们加载到内存之前存储的当前目录。
Set<Object>	getMBeansFromURL(String url) 加载一个包含熔体标签定义要添加到MBean服务器的MBean的文本文件。
Set<Object>	getMBeansFromURL(URL url) 加载一个包含熔体标签定义要添加到MBean服务器的MBean的文本文件。
URL[]	getURLs() 返回加载类和资源的网址的搜索路径。
类<?>	loadClass(String name, ClassLoaderRepository clr) 加载一个类，使用给定的 ClassLoaderRepository如果类不在熔体的网址找到。
void	postDeregister() 让m-let执行任何操作在MBean服务器被注册后需要。
void	postRegister(Boolean registrationDone) 让m-let执行任何操作在MBean服务器或注册后不需要注册后。
void	preDeregister() 让m-let执行任何操作之前，需要注册的MBean服务器。
ObjectName	preRegister(MBeanServer server, ObjectName name) 让m-let执行任何操作之前，它需要在MBean服务器注册。
void	readExternal(ObjectInput in) 从给定的 ObjectInput恢复该熔体的含量。
void	setLibraryDirectory(String libdir) 设置库装载程序用于在它们被加载到内存之前存储本地库的目录。
void	writeExternal(ObjectOutput out) 保存该熔体的内容给出的 ObjectOutput。

Methods inherited from class java.net.URLClassLoader

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

Methods inherited from class java.security.SecureClassLoader

defineClass, defineClass

Methods inherited from class java.lang.ClassLoader

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.management.loading.MLetMBean

getResource, getResourceAsStream, getResources

Constructor Detail

MLet

public MLet()

构建了一种新的熔体使用默认母ClassLoader代表团。

MLet

public MLet(URL[] urls)

构建了一种新的熔体为指定的URL使用默认母ClassLoader代表团。在父类装载器中的第一次搜索后，将在指定的类和资源的顺序中搜索该网址。

参数

urls -从加载的类和资源的URL。

MLet

public MLet(URL[] urls,
            ClassLoader parent)

构建了一种新的熔体为给定的URL。在指定的父类加载程序中先搜索后，将在指定的类和资源的顺序中搜索该网址。父参数将被用作代表团的父类加载程序。

参数

urls -从加载的类和资源的URL。

parent -代表父类装载器。

MLet

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

构建了一种新的熔体为指定的URL，父类装载器，并urlstreamhandlerfactory。父参数将被用作代表团的父类加载程序。当创建新的网址时，工厂的参数将被用作流处理程序工厂来获取协议处理程序。

参数

urls -从加载的类和资源的URL。

parent -代表父类装载器。

factory - urlstreamhandlerfactory创建URL时使用。

MLet

public MLet(URL[] urls,
            boolean delegateToCLR)

构建了一种新的熔体为指定的URL使用默认母ClassLoader代表团。在父类装载器中的第一次搜索后，将在指定的类和资源的顺序中搜索该网址。

参数

urls -从加载的类和资源的URL。

delegateToCLR -如果，当一个类不在父类加载器或URL发现，熔体应委托其含有的 ClassLoaderRepository MBeanServer。

MLet

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

构建了一种新的熔体为给定的URL。在指定的父类加载程序中先搜索后，将在指定的类和资源的顺序中搜索该网址。父参数将被用作代表团的父类加载程序。

参数

urls -从加载的类和资源的URL。

parent -代表父类装载器。

delegateToCLR -如果，当一个类不在父类加载器或URL发现，熔体应委托其含有的 ClassLoaderRepository MBeanServer。

MLet

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

构建了一种新的熔体为指定的URL，父类装载器，并urlstreamhandlerfactory。父参数将被用作代表团的父类加载程序。当创建新的网址时，工厂的参数将被用作流处理程序工厂来获取协议处理程序。

参数

urls -从加载的类和资源的URL。

parent -代表父类装载器。

factory - urlstreamhandlerfactory创建URL时使用。

delegateToCLR -如果，当一个类不在父类加载器或URL发现，熔体应委托其含有的 ClassLoaderRepository MBeanServer。

方法详细信息

addURL

public void addURL(URL url)

将指定的URL的URL列表搜索类和资源。

Specified by:

addURL 接口 MLetMBean

重写：

addURL 方法重写，继承类 URLClassLoader

参数

url的URL添加到URL搜索路径

addURL

public void addURL(String url)
            throws ServiceNotFoundException

将指定的URL的URL列表搜索类和资源。

Specified by:

addURL 接口 MLetMBean

参数

url - URL添加。

异常

ServiceNotFoundException -指定的URL格式不正确。

getURLs

public URL[] getURLs()

返回加载类和资源的网址的搜索路径。这包括指定的构造函数的网址原来的列表，连同任何网址，随后到addurl()方法。

Specified by:

getURLs 接口 MLetMBean

重写：

getURLs 方法重写，继承类 URLClassLoader

结果

加载类和资源的网址的搜索路径。

getMBeansFromURL

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

加载一个包含熔体标签定义要添加到MBean服务器的MBean的文本文件。文本文件的位置是由一个网址指定的。在熔体文件指定的MBean将实例化并在MBean服务器注册。

Specified by:

getMBeansFromURL 接口 MLetMBean

参数

url -文本文件被加载的URL的URL对象。

结果

一套包含在m-let文本文件的每一项加载熔体标签。每个条目指定的ObjectInstance创造的MBean，或一个Throwable对象（即一个错误或异常）如果MBean无法创建。

异常

ServiceNotFoundException -下列错误发生的m-let：文本文件不包含的m-let熔体标签，文本文件没有找到，没有指定标签强制熔体属性，URL的值为空。

IllegalStateException - MLet MBean是不是一个注册MBeanServer。

getMBeansFromURL

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

加载一个包含熔体标签定义要添加到MBean服务器的MBean的文本文件。文本文件的位置是由一个网址指定的。在熔体文件指定的MBean将实例化并在MBean服务器注册。

Specified by:

getMBeansFromURL 接口 MLetMBean

参数

url -文本文件被加载的URL字符串对象。

结果

一套包含在m-let文本文件的每一项加载熔体标签。每个条目指定的ObjectInstance创造的MBean，或一个Throwable对象（即一个错误或异常）如果MBean无法创建。

异常

ServiceNotFoundException -下列错误发生的m-let：文本文件不包含的m-let熔体标签，文本文件没有找到，没有指定标签强制熔体属性，URL是畸形。

IllegalStateException - MLet MBean是不是一个注册MBeanServer。

getLibraryDirectory

public String getLibraryDirectory()

获取库装载机在将它们加载到内存之前存储的当前目录。

Specified by:

getLibraryDirectory 接口 MLetMBean

结果

库装载程序使用的当前目录。

异常

UnsupportedOperationException如果实现不支持存储本Map书馆这样。

另请参见：

setLibraryDirectory(java.lang.String)

setLibraryDirectory

public void setLibraryDirectory(String libdir)

设置库装载程序用于在它们被加载到内存之前存储本地库的目录。

Specified by:

setLibraryDirectory 接口 MLetMBean

参数

libdir由库加载器使用的目录。

异常

UnsupportedOperationException如果实现不支持存储本Map书馆这样。

另请参见：

getLibraryDirectory()

preRegister

public ObjectName preRegister(MBeanServer server,
                              ObjectName name)
                       throws 异常

让m-let执行任何操作之前，它需要在MBean服务器注册。如果对象是空的，这m-let提供一个默认的名字为其注册defaultdomain >：类型=熔体

Specified by:

preRegister 接口 MBeanRegistration

参数

server的MBean服务器中的m-let将注册。

name的m-let对象名称。

结果

该m-let注册名称。

异常

异常这个例外应该被MBean服务器并重新抛出一mbeanregistrationexception。

postRegister

public void postRegister(Boolean registrationDone)

让m-let执行任何操作在MBean服务器或注册后不需要注册后。

Specified by:

postRegister 接口 MBeanRegistration

参数

registrationDone -是否m-let已成功注册的MBean服务器。价值错误意味着注册阶段已经失败。

preDeregister

public void preDeregister()
                   throws 异常

让m-let执行任何操作之前，需要注册的MBean服务器。

Specified by:

preDeregister 接口 MBeanRegistration

异常

异常这个例外应该被MBean服务器并重新抛出一mbeanregistrationexception。

postDeregister

public void postDeregister()

让m-let执行任何操作在MBean服务器被注册后需要。

Specified by:

postDeregister 接口 MBeanRegistration

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException,
                          UnsupportedOperationException

保存该熔体的内容给出的ObjectOutput。不是所有的实现都支持这种方法。那些不把UnsupportedOperationException。子类可以重写此方法以支持它或更改写入数据的格式。

没有指定写入的数据的格式，但如果实施支持writeExternal(java.io.ObjectOutput)还必须支持readExternal(java.io.ObjectInput)以这样一种方式，由前写的是什么，可以通过后者读。

Specified by:

writeExternal 接口 Externalizable

参数

out --对象输出流写入。

异常

IOException如果写作时发生错误。

UnsupportedOperationException -如果该实现不支持此操作。

readExternal

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

从给定的ObjectInput恢复该熔体的内容。不是所有的实现都支持这种方法。那些不把UnsupportedOperationException。子类可以重写此方法以支持它或更改读取数据的格式。

没有指定读取数据的格式，但如果实施支持readExternal(java.io.ObjectInput)还必须支持writeExternal(java.io.ObjectOutput)以这样一种方式，后者是可以通过前阅读。

Specified by:

readExternal 接口 Externalizable

参数

in -对象输入流读取。

异常

IOException如果阅读时发生错误。

ClassNotFoundException -如果对象正在恢复无法找到类。

UnsupportedOperationException -如果该实现不支持此操作。

loadClass

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

加载一个类，使用给定的ClassLoaderRepository如果类不在熔体的网址找到。给定的classloaderrepository可以为零，在这种情况下，ClassNotFoundException立即发生如果类没有在该熔体的网址找到。

参数

name -类的名字我们要加载。

clr - classloaderrepository将用于寻找给定的类，如果它不在这个类加载器发现。可能是空的。

结果

由此产生的类对象。

异常

ClassNotFoundException -指定类不能在这个类加载器也不在了classloaderrepository发现。

findClass

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

这是正在重新定义的类装载器的主要方法。

重写：

findClass 方法重写，继承类 URLClassLoader

参数

name -类的名字。

结果

由此产生的类对象。

异常

ClassNotFoundException -指定类不能被发现。

findLibrary

protected String findLibrary(String libname)

返回本地库的绝对路径名。虚拟机调用此方法来定位属于这个类装载器的类的本地库。图书馆搜索JAR文件如果没有找到本地库的名字连同建筑具体路径名称中使用第一只本Map书馆的名字和（ OSName/OSArch/OSVersion/lib/nativelibname），即

在Solaris SPARC 5.7图书馆统计将在JAR文件作为：

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

图书馆统计在Windows NT 4将在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)

check

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

该方法被重写时，将服务支持缓存和版本控制。它被称为从getMBeansFromURL版本时，代码库，及时已经从熔体文件中提取，并可以用来验证它是所有权利负荷给定的MBean，或更换了一个不同的URL。

此方法的默认实现返回codebase不变。

参数

version的 .jar文件版本号存储在本地。

codebase -远程 .jar文件基础URL。

jarfile的 .jar文件的名称被加载。

mlet -代表 MLET标签的 MLetContent实例。

结果

该代码用于加载MBean。返回的值不应该是空的。

异常

异常如果MBean是不能因为某些原因加载。例外将被添加到集合返回 getMBeansFromURL。