JavaTM 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」のオプション部分を実装するオプションパッケージは、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 :ClientAddressopt Space ClientIdopt Space ArbitraryText

ClientAddress:
// HostAddress ClientPortopt

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)

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。