軟體套件 javax.management.remote

對 JMX MBean 伺服器進行遠端存取使用的介面。

請參見：
描述

介面摘要

JMXAddressable	由可能具有 JMXServiceURL 位址的物件實作。
JMXAuthenticator	定義如何將遠端憑據轉換為 JAAS Subject（主題）的介面。
JMXConnector	JMX API 連接器的客戶端。
JMXConnectorProvider	使用給定的協議創建 JMX API 連接器客戶端的提供者。
JMXConnectorServerMBean	供連接器伺服器使用的 MBean 介面。
JMXConnectorServerProvider	使用給定的協議創建 JMX API 連接器伺服器的提供者。
MBeanServerForwarder	此類別的物件實作 MBeanServer 介面並包裹另一個也實作此介面的物件。

類別摘要

JMXConnectionNotification	在客戶端連接打開或關閉時，或者當通知丟失時發出的通知。
JMXConnectorFactory	用於創建 JMX API 連接器客戶端的處理器。
JMXConnectorServer	每個連接器伺服器的父級類別。
JMXConnectorServerFactory	用於創建 JMX API 連接器伺服器的處理器。
JMXPrincipal	JMX Remote API 的遠端客戶端的身份。
JMXServiceURL	JMX API 連接器伺服器的位址。
NotificationResult	快取記憶體的通知的查詢結果。
SubjectDelegationPermission	授權標識表示驗證標識執行操作所需的權限。
TargetedNotification	一個 (Notification, Listener ID) 對。

異常摘要

JMXProviderException	當提供者存在所需的協議但由於某種原因不能使用時由 JMXConnectorFactory 和 JMXConnectorServerFactory 拋出的異常。
JMXServerErrorException	在處理遠端 MBean 伺服器中的調用的過程中拋出了 Error 時，遠端 MBeanServer 方法調用導致拋出的異常。

軟體套件 javax.management.remote 的描述

對 JMX MBean 伺服器進行遠端存取使用的介面。此套件定義了使 JMX MBean 伺服器可遠端管理的重要介面。此功能性的完整規範，可參考 JMX Specification, version 1.4 PDF 文檔的 Part III。

JMX 規範定義了連接器的概念。連接器連接到 JMX API MBean 伺服器並使遠端 Java 客戶端可存取該伺服器。連接器的客戶端導出與 MBean 伺服器基本相同的介面，尤其是 MBeanServerConnection 介面。

連接器通過給定的協議實作了 MBean 伺服器的遠端存取。
JMX Remote API 定義了標準的連接器 RMI Connector，它通過 RMI 提供了對 MBeanServer 的遠端存取。
JMX Remote API 還定義了一個可選協議，名為 JMXMP（JMX 訊息傳遞協議）。JMXMP 基於 TCP 連接上的序列化 Java 物件（在可選包 javax.management.remote.message 中定義）。實作此協議的連接器稱為 JMXMP Connector。也可以使用 JMXConnectorFactory 提供的使用者定義的連接器協議和可選的通用連接器 (javax.management.remote.generic)。

連接器位址

通常連接器都有一個位址，它由類別 JMXServiceURL 表示。JMXMP 連接器的位址如下所示：

      service:jmx:jmxmp://myhost:9876
      

RMI 連接器的位址可以多種形式，javax.management.remote.rmi 套件的文檔中有相關的詳細論述。

創建連接器伺服器

連接器伺服器通過建構 JMXConnectorServer 的子類別的實例創建。多數情況下，該實例是用 JMXConnectorServerFactory.newJMXConnectorServer 方法創建的。

通常情況下，連接器伺服器與一個 MBean 伺服器通過兩種方式關聯，或者通過在該 MBean 伺服器上註冊的方式，或者在創建連接器伺服器時通過將該 MBean 伺服器作為一個參數提供。

創建連接器客戶端

連接器客戶端通常通過將 JMXServiceURL 提供給 JMXConnectorFactory.connect 方法創建。

對於更特殊的使用者，連接器伺服器可通過直接實例化一個實作 JMXConnector 介面的類別創建，例如類別 RMIConnector。

其他的客戶端或伺服器參數

創建連接器客戶端或伺服器時，可以提供一個型別為 Map 的定義了其他參數的物件。此 Map 中的每個條目都包含一個關鍵字元串和一個適合於該關鍵字型別的關聯值。JMX Remote API 定義的標準關鍵字都以字元串 "jmx.remote." 開頭。文檔 JMX Remote API 列出了這些標準關鍵字。

連接標識符

每個由連接器伺服器打開的連接都具有一個字元串標識符，稱為連接 ID.此標識符出現在由連接器伺服器發出的 JMXConnectionNotification 事件中、JMXConnectorServerMBean#getConnectionIds() 返回的列表中以及由客戶端的 getConnectionId() 方法返回的值中。

按照慣例，連接 ID 如下所示：

jmxmp://clienthost:6789 clientname xxxyyyzzz
      

遵守此慣例的連接 ID 的正規語法如下（使用《The Java Language Specification, Second Edition》中的 grammar notation）：

ConnectionId:
    Protocol : ClientAddressopt Space ClientIdopt Space ArbitraryText

ClientAddress:
// HostAddress ClientPortopt

ClientPort
    : HostPort
      

Protocol 是一個可由 JMXConnectorFactory 識別的協議。

ClientAddress 是連接的客戶端的位址和埠號（如果可確定），否則什麼也不是。HostAddress 是客戶端從其連接的主機的 Internet 位址，可以為數值或 DNS 形式。數值 IPv6 位址括在方括號 [] 中。HostPort 為客戶端從其連接的十進制埠號號。

ClientId 為客戶端實體的標識，通常為由 JMXPrincipal.getName() 返回的字元串。此字元串不能包含空格。

ArbitraryText 是連接器伺服器創建客戶端 ID 時添加的其他文本。它至少應能夠將此連接 ID 從此連接伺服器上當前打開的任何其他連接的 ID 中區分出來。

從以下版本開始：

1.5

另請參見：

Java SE 6 Platform documentation on JMX technology， 特別是 JMX Specification, version 1.4