JavaTM Platform
Standard Ed. 6

javax.management.loading
接口 MLetMBean

所有已知实现类:
MLet, PrivateMLet

public interface MLetMBean

公开 MLet MBean 的远程管理接口。

从以下版本开始:
1.5

方法摘要
 void addURL(String url)
          将指定的 URL 追加到 URL 列表中,以便搜索类和资源。
 void addURL(URL url)
          将指定的 URL 追加到 URL 列表中,以便搜索类和资源。
 String getLibraryDirectory()
          获取在将本机库加载到内存中之前库加载器用来存储这些本机库的当前目录。
 Set<Object> getMBeansFromURL(String url)
          加载包含 MLET 标记的文本文件,这些标记定义了要添加到 MBean 服务器的 MBean。
 Set<Object> getMBeansFromURL(URL url)
          加载包含 MLET 标记的文本文件,这些标记定义了要添加到 MBean 服务器的 MBean。
 URL getResource(String name)
          查找具有给定名称的资源。
 InputStream getResourceAsStream(String name)
          返回读取指定资源的输入流。
 Enumeration<URL> getResources(String name)
          查找所有具有给定名称的资源。
 URL[] getURLs()
          返回用于加载类和资源的 URL 搜索路径。
 void setLibraryDirectory(String libdir)
          设置在将本机库加载到内存中之前库加载器用来存储这些本机库的目录。
 

方法详细信息

getMBeansFromURL

Set<Object> getMBeansFromURL(String url)
                             throws ServiceNotFoundException
加载包含 MLET 标记的文本文件,这些标记定义了要添加到 MBean 服务器的 MBean。文本文件的位置由 URL 指定。使用 UTF-8 编码来读取文本文件。MLET 文件中指定的 MBean 将被实例化并在 MBean 服务器中注册。

参数:
url - 以 String 对象形式加载的文本文件的 URL。
返回:
一个集合,在所加载的 m-let 文本文件中,每个 MLET 标记都对应该集合中的一项。每一项要么指定了所创建的 MBean 的 ObjectInstance,要么在无法创建 MBean 时指定一个 throwable 对象(即一个错误或异常)。
抛出:
ServiceNotFoundException - 如果发生以下错误之一:m-let 文本文件不包含 MLET 标记;未找到 m-let 文本文件;未指定 MLET 标记的必需的属性;url 的值错误。

getMBeansFromURL

Set<Object> getMBeansFromURL(URL url)
                             throws ServiceNotFoundException
加载包含 MLET 标记的文本文件,这些标记定义了要添加到 MBean 服务器的 MBean。文本文件的位置由 URL 指定。使用 UTF-8 编码来读取文本文件。MLET 文件中指定的 MBean 将被实例化并在 MBean 服务器中注册。

参数:
url - 以 URL 对象形式加载的文本文件的 URL。
返回:
一个集合,在所加载的 m-let 文本文件中,每个 MLET 标记都对应该集合中的一项。每一项要么指定了所创建的 MBean 的 ObjectInstance,要么在无法创建 MBean 时指定一个 throwable 对象(即一个错误或异常)。
抛出:
ServiceNotFoundException - 如果发生以下错误之一:m-let 文本文件不包含 MLET 标记;未找到 m-let 文本文件;未指定 MLET 标记的必需的属性;url 的值为 null。

addURL

void addURL(URL url)
将指定的 URL 追加到 URL 列表中,以便搜索类和资源。

参数:
url - 要添加的 URL。

addURL

void addURL(String url)
            throws ServiceNotFoundException
将指定的 URL 追加到 URL 列表中,以便搜索类和资源。

参数:
url - 要添加的 URL。
抛出:
ServiceNotFoundException - 如果指定的 URL 不正确。

getURLs

URL[] getURLs()
返回用于加载类和资源的 URL 搜索路径。这包括为构造方法指定的原始 URL 列表,以及 addURL() 方法后来添加的 URL。

返回:
URL 列表。

getResource

URL getResource(String name)
查找具有给定名称的资源。资源是能够用与代码基无关的方式通过类代码访问的一些数据(图像、声音、文本等)。资源名称是以 '/' 分隔的标识资源的路径名称。

参数:
name - 资源名称
返回:
读取资源的 URL,如果找不到该资源或者调用程序没有获取该资源的足够权限,则返回 null。

getResourceAsStream

InputStream getResourceAsStream(String name)
返回读取指定资源的输入流。getResource(String) 的文档中描述了搜索顺序。

参数:
name - 资源名称
返回:
用于读取资源的输入流,如果找不到该资源,则返回 null。

getResources

Enumeration<URL> getResources(String name)
                              throws IOException
查找所有具有给定名称的资源。资源是能够用与代码基无关的方式通过类代码访问的一些数据(图像、声音、文本等)。资源名称是以 '/' 分隔的标识资源的路径名称。

参数:
name - 资源名称。
返回:
指向资源的 URL 的枚举。如果找不到资源,则枚举为空。无法访问的资源将不在枚举中。
抛出:
IOException - 如果搜索资源时发生 I/O 异常。

getLibraryDirectory

String getLibraryDirectory()
获取在将本机库加载到内存中之前库加载器用来存储这些本机库的当前目录。

返回:
库加载器使用的当前目录。
抛出:
UnsupportedOperationException - 如果此实现不支持以这种方式存储本机库。
另请参见:
setLibraryDirectory(java.lang.String)

setLibraryDirectory

void setLibraryDirectory(String libdir)
设置在将本机库加载到内存中之前库加载器用来存储这些本机库的目录。

参数:
libdir - 库加载器使用的目录。
抛出:
UnsupportedOperationException - 如果此实现不支持以这种方式存储本机库。
另请参见:
getLibraryDirectory()

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策