モジュール java.management.rmi
パッケージ javax.management.remote.rmi

クラスRMIConnector

java.lang.Object
javax.management.remote.rmi.RMIConnector
すべての実装されたインタフェース:
Closeable, Serializable, AutoCloseable, JMXAddressable, JMXConnector
public class RMIConnector
extends Object
implements JMXConnector, Serializable, JMXAddressable

リモートRMIコネクタへの接続です。 通常、こうした接続は、JMXConnectorFactoryで作成されます。 しかし、JNDIを使用しないで取得されるRMIServerスタブなどにより、このクラスを直接使用できる特殊なアプリケーションもあります。

導入されたバージョン:
1.5
関連項目:
直列化された形式

  • コンストラクタの詳細

    • RMIConnector

      public RMIConnector​(JMXServiceURL url, Map<String,​?> environment)

      指定されたアドレスのRMIコネクタ・サーバーに接続するRMIConnectorを構築します。

      アドレスは、次の構文を使用してコネクタ・サーバーを直接参照できます:

       service:jmx:rmi://[host[:port]]/stub/encoded-stub

      (角括弧[]はアドレスの一部ではなく、ホストとポートがオプションであることを示します。)

      アドレスは、代わりに、次の構文を使用して、JNDIを介してRMIスタブを見つける場所を示すことができます:

       service:jmx:rmi://[host[:port]]/jndi/jndi-name

      実装も追加アドレス構文を認識できます。次に例を示します。

       service:jmx:iiop://[host[:port]]/stub/encoded-stub
      パラメータ:
      url - RMIコネクタ・サーバーのアドレス。
      environment - 接続の作成方法を指定する追加属性。 JNDIベースのアドレスの場合、これらの属性に、InitialContextによって認識されるJNDI属性を含めることができ、有用である。 このパラメータがnullの場合、空のマップを指定した場合と同じことになる。
      例外:
      IllegalArgumentException - urlがnullである場合。

    • RMIConnector

      public RMIConnector​(RMIServer rmiServer, Map<String,​?> environment)

      指定されたRMIスタブを使ってRMIConnectorを構築します。

      パラメータ:
      rmiServer - RMIコネクタ・サーバーを表すRMIスタブ。
      environment - 接続の作成方法を指定する追加属性。 このパラメータがnullの場合、空のマップを指定した場合と同じことになる。
      例外:
      IllegalArgumentException - rmiServerがnullである場合。

  • メソッドの詳細

    • toString

      public String toString()

      このオブジェクトの文字列表現を返します。 一般に、toStringメソッドは、このオブジェクトを「テキストで表す」文字列を返します。 この結果は、人間が読める簡潔で有益な情報であるべきです。

      オーバーライド:
      toString 、クラス:  Object
      戻り値:
      このオブジェクトのString表現。

    • getAddress

      public JMXServiceURL getAddress()

      このコネクタのアドレスです。

      定義:
      getAddress 、インタフェース: JMXAddressable
      戻り値:
      このコネクタのアドレス。存在しない場合はnull。
      導入されたバージョン:
      1.6

    • connect

      public void connect() throws IOException
      次のインタフェースからコピーされた説明: JMXConnector

      コネクタ・サーバーとの接続を確立します。 このメソッドは、connect(null)と同等です。

      定義:
      connect 、インタフェース: JMXConnector
      例外:
      IOException - 通信障害により接続を確立できなかった場合

    • connect

      public void connect​(Map<String,​?> environment) throws IOException
      次のインタフェースからコピーされた説明: JMXConnector

      コネクタ・サーバーとの接続を確立します。

      このオブジェクト上で、すでにconnectが呼び出されている場合、もう1回呼び出しても何も起こりません。 一方、connectのあとでJMXConnector.close()が呼び出されている場合、再度connectを呼び出すとIOExceptionがスローされます。

      このオブジェクト上でconnectが1回も呼び出されていない場合、または呼出しに対して例外が生成された場合、 connectを呼び出すとコネクタ・サーバーとの接続が試行されます。

      定義:
      connect 、インタフェース: JMXConnector
      パラメータ:
      environment - 接続のプロパティ。 このマップ内のプロパティは、JMXConnectorの作成時に指定されたマップ内のプロパティをオーバーライドする(存在する場合)。 このパラメータがnullの場合、空のマップを指定した場合と同じことになる。
      例外:
      IOException - 通信障害により接続を確立できなかった場合