|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のパッケージ 次のパッケージ | フレームあり フレームなし |
参照先:
説明
インタフェースの概要 | |
---|---|
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 メソッドのリモート呼び出しの結果としてスローされる例外です。 |
JMX MBean サーバーにリモートアクセスするためのインタフェースです。このパッケージは、JMX MBean サーバーをリモート管理するために必要なインタフェースを定義します。この機能の仕様は、JMX 仕様、Version 1.4 の PDF ドキュメントの第 III 部で完全に示されます。
コネクタの概念について定義する JMX 仕様です。コネクタを JMX API MBean サーバーに接続することにより、このサーバーをリモート Java クライアントで利用できるようになります。コネクタのクライアント側は、基本的に MBean サーバーと同じインタフェース、すなわち MBeanServerConnection
をエクスポートします。
コネクタにより、指定のプロトコル経由で MBean サーバーにリモートアクセスできるようになります。JMX リモート API を使用すると、さまざまな種類のコネクタを利用できます。
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 :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 と区別できる必要があります。
|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のパッケージ 次のパッケージ | フレームあり フレームなし |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。