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()