javax.management.remote

インタフェース JMXConnectorServerProvider

public interface JMXConnectorServerProvider

指定のプロトコルを使用して JMX API コネクタサーバーを作成するためのプロバイダです。このインタフェースのインスタンスは、JMXConnectorServerFactory により、その newJMXConnectorServer メソッドの一部として作成されます。

導入されたバージョン:

1.5

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
JMXConnectorServer	newJMXConnectorServer(JMXServiceURL serviceURL, Map<String,?> environment, MBeanServer mbeanServer) 指定されたアドレスで新しいコネクタサーバーを作成します。

メソッドの詳細

newJMXConnectorServer

JMXConnectorServer newJMXConnectorServer(JMXServiceURL serviceURL,
                                       Map<String,?> environment,
                                       MBeanServer mbeanServer)
                                         throws IOException

指定されたアドレスで新しいコネクタサーバーを作成します。このメソッドが正常に呼び出されると、そのたびに異なった JMXConnectorServer オブジェクトが生成されます。

パラメータ:

serviceURL - 新しいコネクタサーバーのアドレス。getAddress メソッドによって返される新しいコネクタサーバーの実際のアドレスは、厳密に同じであるとは限らない。たとえば、元のアドレスに含まれていないポート番号が含まれている場合がある。

environment - 新しいコネクタサーバーの動作を制御する指定の属性を含む読み取り専用マップ。このマップ内のキーは String でなければならない。関連付けられている個々の値にどの型が適切かは、属性によって決定される。

mbeanServer - このコネクタサーバーの接続先 MBean サーバー。このコネクタサーバーを MBean サーバーに登録することによって MBean サーバーに接続する場合は null。

戻り値:

新しいコネクタサーバーを表す JMXConnectorServer。このメソッドが正常に呼び出されると、そのたびに異なったオブジェクトが生成される。

例外:

NullPointerException - serviceURL または environment が null の場合。

IOException - プロバイダ実装では、serviceURL 内のプロトコルがこのプロバイダにより認識されない場合は MalformedURLException をスローし、serviceURL 内のプロトコルのプロバイダであるが、何らかの理由で使用できない場合は JMXProviderException をスローし、コネクタサーバーを作成できない場合はその他の IOException をスローすることが推奨される。