com.sun.jdi.connect
インタフェース ListeningConnector

すべてのスーパーインタフェース:

Connector

public interface ListeningConnector
extends Connector

ターゲット VM が開始した接続を待機するコネクタです。

導入されたバージョン:

1.3

入れ子のクラスの概要

インタフェース com.sun.jdi.connect.Connector から継承された入れ子のクラス/インタフェース

Connector.Argument, Connector.BooleanArgument, Connector.IntegerArgument, Connector.SelectedArgument, Connector.StringArgument

メソッドの概要

VirtualMachine	accept(Map<String,? extends Connector.Argument> arguments) ターゲット VM がこのコネクタに接続されるのを待機します。
String	startListening(Map<String,? extends Connector.Argument> arguments) ターゲット VM によって開始された 1 つ以上の接続を待機します。
void	stopListening(Map<String,? extends Connector.Argument> arguments) 接続の待機を取り消します。
boolean	supportsMultipleConnections() 待機しているコネクタで、1 つの引数マップによる複数の接続がサポートされているかどうかを示します。

インタフェース com.sun.jdi.connect.Connector から継承されたメソッド

defaultArguments, description, name, transport

メソッドの詳細

supportsMultipleConnections

boolean supportsMultipleConnections()

待機しているコネクタで、1 つの引数マップによる複数の接続がサポートされているかどうかを示します。サポートされている場合は、startListening(java.util.Map) を呼び出すと、複数のターゲット 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) によって取得されます。

arguments にアドレス情報が含まれ、接続が 1 つだけ許可されている場合は、このメソッドを呼び出さずに、すぐに accept メソッドを呼び出すことができます。

戻り値:

コネクタが接続を待機している場所のアドレス。

例外:

IOException - 待機を開始できない場合。 実際の例外は、使用されている Connector の実装によって異なる。

IllegalConnectorArgumentsException - コネクタ引数の 1 つが無効である場合。

stopListening

void stopListening(Map<String,? extends Connector.Argument> arguments)
                   throws IOException,
                          IllegalConnectorArgumentsException

接続の待機を取り消します。指定された引数マップは、以前の startListening(java.util.Map) の呼び出しに指定された引数マップと一致している必要があります。

例外:

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 つが無効である場合。