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 は正常に起動したが、接続が確立される前にエラーで終了した場合