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

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

defaultArguments, description, name, transport

メソッドの詳細

supportsMultipleConnections

public boolean supportsMultipleConnections()

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

戻り値:

複数の接続がサポートされている場合は true、それ以外の場合 はfalse

startListening

public String startListening(Map 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

public void stopListening(Map arguments)
                   throws IOException,
                          IllegalConnectorArgumentsException

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

例外:

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

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

accept

public VirtualMachine accept(Map arguments)
                      throws IOException,
                             IllegalConnectorArgumentsException

ターゲット VM がこのコネクタに接続されるのを待機します。

例外:

IOException - 受け入れることができない場合。実際の例外は、 使用されている Connector の実装によって異なる

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