モジュール jdk.jdi
パッケージ com.sun.jdi.connect

インタフェースListeningConnector

すべてのスーパー・インタフェース:
Connector
public interface ListeningConnector
extends Connector
ターゲットVMが開始した接続を待機するコネクタです。
導入されたバージョン:
1.3

  • メソッドの詳細

    • supportsMultipleConnections

      boolean supportsMultipleConnections()
      この待機しているコネクタで、1つの引数マップによる複数の接続がサポートされているかどうかを示します。 サポートされている場合は、startListening(java.util.Map<java.lang.String,? extends com.sun.jdi.connect.Connector.Argument>)を呼び出すと、複数のターゲットVMを接続できます。
      戻り値:
      複数の接続がサポートされている場合はtrue、そうでない場合はfalse。

    • startListening

      String startListening​(Map<String,​? extends Connector.Argument> arguments) throws IOException, IllegalConnectorArgumentsException
      ターゲットVMによって開始された1つ以上の接続を待機します。 コネクタは、指定された引数マップを使用して待機しているアドレスを判定するか、または適切な待機アドレスを生成します。 どちらの場合も、このメソッドからアドレスの文字列が返されます。ターゲットVMを開始するときに、その文字列を使用してこのコネクタを識別できます。 アドレスの文字列の書式は、コネクタおよびトランスポート、場合によってはプラットフォームによって異なります。

      引数マップによって、引数名文字列がConnector.Argumentのインスタンスに関連付けられます。 コネクタのデフォルト引数マップは、Connector.defaultArguments()によって取得できます。 引数マップの値は変更できますが、エントリの追加または削除はしないようにしてください。

      このメソッドは、VirtualMachineを返さず、通常はターゲットVMが接続を開始する前に戻ります。 接続されたターゲットは、このメソッドに渡された引数マップを使用し、accept(java.util.Map<java.lang.String,? extends com.sun.jdi.connect.Connector.Argument>)によって取得されます。

      argumentsにアドレス情報が含まれており、受け入れられる接続が1つのみの場合は、このメソッドを呼び出さなくても、acceptメソッドをただちに呼び出すことができます。

      戻り値:
      コネクタが接続を待機している場所のアドレス。
      例外:
      IOException - 待機を開始できない場合。 実際の例外は、使用されているConnectorの実装によって異なる。
      IllegalConnectorArgumentsException - コネクタ引数の1つが無効である場合。

    • stopListening

      void stopListening​(Map<String,​? extends Connector.Argument> arguments) throws IOException, IllegalConnectorArgumentsException
      接続の待機を取り消します。 指定された引数マップは、以前のstartListening(java.util.Map<java.lang.String,? extends com.sun.jdi.connect.Connector.Argument>)の呼出しに指定された引数マップと一致している必要があります。
      例外:
      IOException - 待機を停止できない場合。 実際の例外は、使用されているConnectorの実装によって異なる。
      IllegalConnectorArgumentsException - コネクタ引数の1つが無効である場合。

    • accept

      VirtualMachine accept​(Map<String,​? extends Connector.Argument> arguments) throws IOException, IllegalConnectorArgumentsException
      ターゲットVMがこのコネクタに接続されるのを待機します。
      例外:
      TransportTimeoutException - Connectorが受け入れタイム・アウトをサポートするトランスポートをカプセル化し、引数マップ内にタイム・アウトを表すConnector.Argumentが設定されていて、ターゲットVMの接続待機時にタイム・アウトが発生した場合。
      IOException - 受け入れ不能の場合。 実際の例外は、使用されているConnectorの実装によって異なる。
      IllegalConnectorArgumentsException - コネクタ引数の1つが無効である場合。