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

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

Connector

public interface LaunchingConnector
extends Connector

ターゲット VM に接続する前に、ターゲット VM を起動できるコネクタです。

導入されたバージョン:

1.3

入れ子のクラスの概要

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

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

メソッドの概要

VirtualMachine

launch(Map<String,? extends Connector.Argument> arguments) アプリケーションを起動し、その VM に接続します。

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

defaultArguments, description, name, transport

メソッドの詳細

launch

VirtualMachine launch(Map<String,? extends Connector.Argument> arguments)
                      throws IOException,
                             IllegalConnectorArgumentsException,
                             VMStartException

アプリケーションを起動し、その VM に接続します。起動のプロパティー (オプション、メインクラス、引数など) は、arguments に指定します。引数マップによって、引数名の文字列が Connector.Argument のインスタンスに関連付けられます。コネクタのデフォルトの引数マップは、Connector.defaultArguments() によって取得できます。引数マップの値は変更できますが、エントリの追加または削除はできません。

起動コネクタにより起動されたターゲット VM は、VMStartEvent が受け入れられるまで安定であることを保証されていません。

重要: ターゲット VM をこの機能を使用して起動した場合は、その出力およびエラーのストリームは、実行時に読み取る必要があります。これらのストリームは、VirtualMachine.process() によって返された Process オブジェクトを使って取得できます。ストリームは定期的に読み取ってください。 それらのストリームのバッファーがいっぱいになると、ターゲット VM の実行が停止します。

パラメータ:

arguments - VM を起動するときに使用する引数マップ

戻り値:

ターゲット VM の VirtualMachine ミラー。

例外:

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

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

VMStartException - VM は正常に起動したが、接続が確立される前にエラーで終了した場合。