実行構成

永続的なプロパティ

永続プロパティは、Cloneable、String、任意のプリミティブ型のいずれかであると前述しました。しかし、実行構成内で設定言語を使用する場合は、これらのプロパティも XML 永続化をサポートする必要があります。文字列とプリミティブ型は通常どおり永続化されます。オブジェクトの場合、永続化はより複雑です。オブジェクトに対して永続化されるプロパティは、パブリックインスタンスフィールドと、setXXX および getXXX メソッドを持つプロパティの 2 種類です。永続プロパティに複合型を使用する場合は、重要なフィールドをすべてパブリックにするか、永続化したいものすべてに setXXX および getXXX メソッドを提供する必要があります。

構成を互いに統合する

設定言語の 2 つの基本機能の 1 つは、ある設定を別の設定に簡単に統合できることです。そのために template persistent properties が使われています。

テンプレートパラメーター

設定言語の 2 つ目の基本機能は、テンプレートパラメーターです。これは、java のコンストラクターパラメーターにいくらか似ています。例: ノードを選択するための構成を作成する場合、ノードの概念で構成をパラメーター化したい場合があります。この場合、概念は永続的なパラメーターではありません。つまり、ユーザーが選択するものではありません。これは、構成作成時に指定されるパラメーターです。

実行コマンドセクション

各コマンドは複数の execute セクションを持つことができます。これらの各セクションでは、複数の実行パラメーターが定義されます。パラメーターには、必須パラメーターとオプションパラメーターの 2 種類があります。オプションパラメーターはデフォルト値を持つことができ、コマンドの開始時に省略できますが、必須パラメーターはデフォルト値を持つことができず、必須です。コマンドの任意の 2 つの実行セクションは、異なる (型による) 必須パラメーターのリストを持つ必要があります。1 つの実行セクションは、別の実行セクションを呼び出すことができます。各実行セクションは、process 型または ProcessHandler 型の値を返す必要があります。

ProcessBuilderExpression

コマンドからプロセスを開始するには、実行セクション ProcessBuilderExpression を使用します。これはコマンドパートの単純なリストです。各パートは、string または list<string> 型の式で構成される ProcessBuilderPart か、キーを持つパラメーター ("-classpath/path/to/classes") を表す ProcessBuilderKeyPart のいずれかです。ProcessBuilderExpression から生成されたコードが呼び出されると、各パートが null または空かどうかがテストされ、そうでない場合は省略されます。次に、各パートはスペースによって複数のパートに分割されます。スペースを含むコマンドパートを指定し、分割されたくない場合 (たとえば、スペースを含むファイルパスがある場合) は、それを二重引用符 ("") で囲む必要があります。作成されたプロセスの作業ディレクトリは、インスペクターで指定できます。

デバッガー統合

コマンドをデバッガーと統合するには、2 つのことを指定する必要があります。

• 統合する特定のデバッガー

• プロセスのコマンドライン引数

デバッガーを指定するには、DebuggerReference （jetbrains.mps.debug.apiLang の debugger 型の式）を使用して、特定のデバッガーを参照します。デバッガー設定は、タイプ IDebuggerSettings のオブジェクトでなければなりません。

執行者

Executor はノードであり、この実行構成に対してプロセスがどのように開始されるかを記述しています。ユーザーが入力した設定を受け取り、そこからプロセスを作成します。そのため、エグゼキュータの execute メソッドは、process 型のインスタンスを返すべきです。これは StartProcessHandlerStatement を介して行われます。型 process または ProcessHandler を持つものはすべてそれに渡すことができます。process は 3 つの異なる方法で作成できます。

1. コマンド経由。

2. ProcessBuilderExpression 経由（コマンド内でのみ使用することをお勧めします）。

3. ProcessHandler クラスの新しいインスタンスを作成します。この方法は、リモートデバッグ用の実行構成を作成していて、実際にプロセスを開始する必要がない場合など、上記の 2 つが適切でない場合にのみ推奨されます。

エグゼキュータ自体は、次のセクションで構成されています。

1. この executor の対象となる構成、およびその別名が指定されている "for" セクション。

2. この設定を実行 / デバッグする機能が指定されている "can" セクション。このエグゼキュータでコマンドが使用されていない場合は、ここに DebuggerConfiguration のインスタンスを指定する必要があります。

3. Make など、この構成の実行前に実行できるタスクの呼び出しを含む「before」セクション。

4. プロセス自体が作成される "execute" セクション

デバッガー統合

コマンドを使用してプロセスを開始する場合は、設定をデバッグ可能として指定すること以外は何もしないでください（executor で "debug" を選択することによって）。ただし、カスタムデバッガー統合が必要な場合は、コマンド宣言と同じ方法で行われます。

生産者

実行構成のプロデューサーは、さまざまなノードまたはノードのグループ、モデル、モジュール、プロジェクトに対してこの構成を作成する方法について説明します。これにより、各プロデューサーのコンテキストメニューに選択された項目の実行を提案するアクションが表示されるため、実行構成をユーザーにとって簡単に見つけることができます。また、最初に編集ダイアログを見ずに何かを実行するデフォルトの方法を提供するため、これは設定を単純化します。

各プロデューサーは、作成する実行構成を 1 つ指定します。構成の生成元となるソースの種類ごとに、セクションからの複数の生成元を持つことができます。このソースは、node <>、nlist <>、model、module、project のいずれかになります。ソースとは別に、セクションからの各プロデュースには、作成セクション（ソースでパラメーター化された概念関数）があります。この関数は、作成された実行構成を返すか、何らかの理由で作成できない場合は null を返します。

パーソンエディター

この例では、"Person" のエディターが作成されています。このエディターは、人物の 2 つのプロパティ、名前とメールアドレスを編集します。

PersonEditor は、次のように java コードから使用できます。

実行コマンド

これは、指定された workingDirectory 内の programParameters を使用して、指定された executable を開始するコマンドの例です。

タスクの前に gcc でコンパイルする

これは、gcc コマンドでソースファイルのコンパイルを実行する BeforeTask の例です。また、実行構成実行プログラムの外部でコマンドを使用する方法も示しています。

これは単なる例にすぎないことに注意してください。実際のシナリオでは、たとえばコンパイル中にタスクに進行状況ウィンドウが表示されるはずです。

Java エグゼキュータ

これは MPS からの Java 実行構成のための実際の executor です。

Java プロデューサー

これは MPS からの Java 実行構成のプロデューサーです。

ここに 3 つの「プロデュース」セクションがあります。ここでは、ClassConcept、StaticMethodDeclaration、IMainClass のノードから Java 実行構成が作成されます。

java クラスに生成されたノードの実行

概念のノードがメインメソッドを持つ java クラスに生成され、そのノードを MPS から実行したいとします。この場合、実行構成を作成する必要はありませんが、以下の手順を実行する必要があります。

1. 実行したいコンセプトは jetbrains.mps.execution.util 言語から IMainClass コンセプトを実行するべきです。ノードをいつ実行できるかを指定するには、isNodeRunnable メソッドをオーバーライドします。

2. 概念ごとにユニット情報を生成する必要があります。ユニット情報は、実行されるクラス名を正しく特定するために必要です。ユニット情報およびすべてのトレース情報については、MPS ドキュメントのデバッガーセクションを参照してください。これを確認するには、以下のいずれかの条件が満たされていることを確認してください。

   1. ノードから jetbrains.mps.baseLanguage から ClassConcept が生成されます。

   2. ノードはテキストに生成され（言語は生成に textGen アスペクトを使用します）、ノードの概念は jetbrains.mps.traceable から UnitConcept インターフェースを実装します。

   3. 指定された 3 つの条件のうち 1 つを満たす概念にノードが生成されます。