パッケージ 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 リモート API のリモートクライアントのアイデンティティーです。
JMXServiceURL	JMX API コネクタサーバーのアドレスです。
NotificationResult	バッファー利用通知のクエリーの結果です。
SubjectDelegationPermission	承認アイデンティティーに代わってオペレーションを実行するために、認証アイデンティティーにより必要とされるアクセス権です。
TargetedNotification	通知とリスナー ID のペアです。

例外のサマリー

例外	説明
JMXProviderException	要求されるプロトコルのプロバイダは存在するが、何らかの理由で使用できない場合に、JMXConnectorFactory および JMXConnectorServerFactory によってスローされる例外です。
JMXServerErrorException	リモートの MBeanServer メソッド呼び出しの結果としてスローされる例外です。この例外がスローされた場合は、リモート MBean サーバーでその呼び出しを処理している間に Error がスローされています。

パッケージ javax.management.remote の説明

JMX MBean サーバーにリモートアクセスするためのインタフェースです。このパッケージは、JMX MBean サーバーをリモート管理するために必要なインタフェースを定義します。この機能の仕様は、『JMX 仕様、バージョン 1.4』の PDF ドキュメントの第 III 部で完全に示されます。

コネクタの概念について定義する JMX 仕様です。コネクタを JMX API MBean サーバーに接続することにより、このサーバーをリモート Java クライアントで利用できるようになります。コネクタのクライアント側は、基本的に MBean サーバーと同じインタフェース、すなわち MBeanServerConnection インタフェースをエクスポートします。

コネクタにより、指定のプロトコル経由で MBean サーバーにリモートアクセスできるようになります。JMX リモート API を使用すると、さまざまな種類のコネクタを利用できます。

• たとえば、JMX リモート API に定義されている標準コネクタ、RMI コネクタでは、RMI 経由で MBeanServer にリモートアクセスできます。
• JMX リモート API には、JMX メッセージプロトコル (JMXMP) を実装する JMXMP コネクタと呼ばれるオプションコネクタも定義されています。これはオプションであるため、このバンドルには含まれません (次を参照)。
• JMXConnectorFactory と、オプションの汎用コネクタ (このバンドルには含まれない。次を参照) を使って、ユーザー定義のコネクタプロトコルも使用できます。

注:JMX リモート API のオプション部分を実装するオプションパッケージは、Java SE プラットフォームには含まれませんが、JMX リモート API のリファレンス実装から入手できます。

コネクタアドレス

通常、コネクタサーバーは、JMXServiceURL クラスによって表されるアドレスを持っています。RMI コネクタのアドレスは、次のような形式を取ります。

      service:jmx:rmi:///jndi/rmi://myhost:1099/myname
      

この JMXServiceURL では、最初の rmi: で RMI コネクタを指定し、2 番目の rmi: で、RMI コネクタサーバーがスタブを格納した RMI レジストリを指定します。

上記の例は、アドレスの 1 つの形式にすぎません。RMI コネクタのアドレスには、いくつかの形式があります。詳細は、javax.management.remote.rmi パッケージに関するドキュメントを参照してください。

コネクタサーバーの作成

コネクタサーバーは、JMXConnectorServer のサブクラスのインスタンスを構築することで作成されます。通常、このインスタンスは、JMXConnectorServerFactory.newJMXConnectorServer メソッドを使って作成されます。

通常、コネクタサーバーと MBean サーバーの関連付けは、コネクタサーバーを MBean サーバーに登録するか、コネクタサーバーの作成時にパラメータとして MBean サーバーを指定することによって行われます。

コネクタクライアントの作成

通常、コネクタクライアントは、コネクタサーバーの JMXServiceURL を指定して JMXConnectorFactory.connect メソッドに接続することにより作成されます。

より特殊な用途の場合は、RMIConnector クラスなど、JMXConnector インタフェースを実装するクラスを直接インスタンス化しても、クライアントコネクタを作成できます。

クライアントまたはサーバーのその他のパラメータ

コネクタクライアントまたはコネクタサーバーの作成時には、追加パラメータを定義する Map 型のオブジェクトを指定できます。この Map 内の各エントリは、文字列で表されるキーと、そのキーに適した型の関連値を備えています。JMX リモート API によって定義されたすべての標準キーの先頭文字列は、「jmx.remote.」です。これらの標準キーについては、『JMX Remote API』を参照してください。

接続識別子

コネクタサーバーによって開かれたすべての接続は、接続 ID と呼ばれる文字列識別子を備えています。この識別子は、コネクタサーバーによって発行される JMXConnectionNotification イベント内、getConnectionIds() によって返されるリスト内、およびクライアントの getConnectionId() メソッドによって返される値に含まれます。

接続 ID の例を次に示します。

rmi://192.18.1.9 username 1
      

この規則に従う接続 ID の正規文法は、次のとおりです (『Java™ 言語仕様』のセクション 2.4 の文法概念を使用)。

ConnectionId:
    Protocol : ClientAddressopt Space ClientIdopt Space ArbitraryText

ClientAddress:
    // HostAddress ClientPortopt

ClientPort
    : HostPort
      

Protocol は、JMXConnectorFactory によって認識されるプロトコルです。

ClientAddress は、接続クライアントのアドレスおよびポートです (判別可能な場合のみ、それ以外の場合はなし)。HostAddress は、クライアントの接続元ホストのインターネットアドレスを数値または DNS 形式で表したものです。IPv6 数値アドレスは、角括弧 [] で囲まれます。HostPort は、クライアントの接続元の 10 進ポート番号です。

ClientId は、クライアントエンティティーのアイデンティティーです。通常、JMXPrincipal.getName() によって返される文字列に一致します。この文字列に空白文字を含めることはできません。

ArbitraryText は、クライアント ID の作成時にコネクタサーバーによって追加される任意の追加テキストです。最小限、この接続 ID を現在このコネクタサーバーによって開かれているその他の接続 ID と区別できるのに十分である必要があります。

導入されたバージョン:

1.5

関連項目:

Java プラットフォームの JMX テクノロジに関するドキュメント、特に『JMX 仕様、バージョン 1.4』