javax.management.remote (Java Platform SE 6)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM Platform
Standard Ed. 6

前のパッケージ 次のパッケージ

フレームあり フレームなし

パッケージ javax.management.remote

JMX MBean サーバーにリモートアクセスするためのインタフェースです。

参照先:
説明

インタフェースの概要
JMXAddressable	`JMXServiceURL` アドレスを保持できるオブジェクトにより実装されます。
JMXAuthenticator	リモート証明書を JAAS Subject に変換する方法を定義するインタフェースです。
JMXConnector	JMX API コネクタのクライアント側です。
JMXConnectorProvider	指定のプロトコルを使用して JMX API コネクタクライアントを作成するためのプロバイダです。
JMXConnectorServerMBean	コネクタサーバーの MBean インタフェースです。
JMXConnectorServerProvider	指定のプロトコルを使用して JMX API コネクタサーバーを作成するためのプロバイダです。
MBeanServerForwarder	このクラスのオブジェクトは、MBeanServer インタフェースを実装し、このインタフェースを実装するオブジェクトを 1 つラップします。

クラスの概要
JMXConnectionNotification	クライアント接続の開始および終了時と通知が失われたときに発行される通知です。
JMXConnectorFactory	JMX API コネクタクライアントを作成するファクトリです。
JMXConnectorServer	すべてのコネクタサーバーのスーパークラスです。
JMXConnectorServerFactory	JMX API コネクタサーバーを作成するファクトリです。
JMXPrincipal	JMX リモート API. のリモートクライアントのアイデンティティーです。
JMXServiceURL	JMX API コネクタサーバーのアドレスです。
NotificationResult	バッファー利用通知のクエリーの結果です。
SubjectDelegationPermission	承認アイデンティティーに代わってオペレーションを実行する認証アイデンティティーに必要なアクセス権です。
TargetedNotification	通知とリスナー ID のペア (Notification, Listener ID) です。

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

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

JMX MBean サーバーにリモートアクセスするためのインタフェースです。このパッケージは、JMX MBean サーバーをリモート管理するために必要なインタフェースを定義します。この機能の仕様は、JMX 仕様、Version 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 の参照実装から入手できます。

コネクタアドレス

通常、コネクタサーバーは、javax.management.remote.JMXServiceURLJMXServiceURL クラスによって表されるアドレスを持っています。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 メソッドに接続することにより作成されます。

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

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

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

接続識別子

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

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

rmi://192.18.1.9 username 1

この規則に従う接続 ID の正規文法は、次のとおりです (『Java 言語仕様第 2 版』の文法概念を使用)。

ConnectionId:
Protocol :ClientAddress_opt Space ClientId_opt Space ArbitraryText

ClientAddress:
// HostAddress ClientPort_opt

ClientPort
: HostPort

Protocol は、javax.management.remote.JMXConnectorFactoryJMXConnectorFactory によって認識されるプロトコルです。

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

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

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

導入されたバージョン:: 1.5
関連項目:: Java SE 6 プラットフォームの JMX テクノロジに関するマニュアル、特に『JMX 仕様、バージョン 1.4』(pdf)

概要