モジュール jdk.jdi

パッケージ 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<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つが無効である場合。