デバッガー

java デバッガー下での実行構成の起動

MPS は、java – jetbrains.mps.baseLanguage.runConfigurations に生成される言語の実行構成を作成するための特別な言語を提供します。これらの実行構成は、デバッガーで自動的に開始できます。詳細については、「java に生成された言語の実行構成」を参照してください。

カスタムビューアー

変数ビューで変数とフィールドを表示するときに、特定の値を表示するための独自の方法を定義したい場合があります。たとえば、コレクションは、そのすべての内部構造を持つ通常のオブジェクトとしてではなく、要素のコレクションとして表示できます。

カスタムビューアーを作成するために MPS は jetbrains.mps.debugger.java.customViewers 言語を持っています。

jetbrains.mps.debugger.java.customViewers 言語を使用すると、特定の形式のデータ用に独自のビューアーを作成できます。

customViewers 言語の主な概念は、カスタムデータビューアーです。生の java 値（スタック上のオブジェクト）を受け取り、いわゆるウォッチブルのリストを返します。ウォッチャーブルは、値とそのラベル（値がメソッド、フィールド、要素、サイズなどであるかどうかなど、値を分類する文字列）のペアです。ウォッチャーブルのラベルは custom watchables container で定義されています。各ラベルにアイコンを割り当てることができます。

特定のタイプのビューアーは custom viewer ルートで定義されています。次の表に custom viewer 部品を示します。

カスタムビューアー言語には、watchable list と watchable の 2 つの新しいタイプが導入されました。

これは java.util.Map.Entry クラスのカスタムビューアー仕様です。

そして、ここでマップエントリがデバッガービューでどのように表示されるかを見ます:

トレーサブルノード

このセクションでは、trace .info ファイルに追加情報を保存するために必要なノード（ノードから生成された位置テキスト、表示変数、ノードが生成されたファイルの名前などの情報）を指定する方法について説明します。trace.info ファイルには、MPS 内のノードを生成されたテキストと接続するための情報が含まれています。例: ブレークポイントがヒットした場合、java デバッガーは MPS にソースファイルの行番号を伝え、この情報から実際のノードを取得するようにします。MPS は trace .info ファイルの情報を使用します。

具体的には、trace.info ファイルには次の情報が含まれています。

• 位置情報: テキストファイルの名前とその中でノードが生成された場所。

• スコープ情報: 「スコープ」ノードごとに（それに関連付けられ、ノードのスコープ内で可視の変数がいくつかあります） - スコープ内で可視の変数の名前と ID。

• ユニット情報: 各 " ユニットノード "（言語のある単位、たとえば java のクラスを表すように） - ノードが生成されるユニットの名前

言語 jetbrains.mps.lang.traceable の概念 TraceableConcept、ScopeConcept、UnitConcept は、その目的で使用されます。一部の情報を trace.info ファイルに保存するには、ユーザーはこれらの概念の 1 つから派生し、特定の動作方法を実装する必要があります。概念は次の表で説明されています。

コンセプト	説明	実装する動作方法	サンプル
TraceableConcept	テキスト内のどの場所を保存し、どのブレークポイントを作成できるかについての概念。	getTraceableProperty – trace.info ファイルに保存されるいくつかのプロパティ。
ScopeConcept	スコープ内に見える、いくつかのローカル変数を持つ概念。	getScopeVariables – スコープ内の変数宣言。
UnitConcept	java のクラスや内部クラスのように、別々の単位に生成される概念。	getUnitName – 生成されたユニットの名前。

trace.info ファイルは、テキストの生成中に、生成の最終段階で作成されます。説明されている概念は、テキストに生成された言語でのみ使用されます。TraceableConcept、ScopeConcept 又は UnitConcept 還元 ルールにより生成されるたびにエントリが、自動的に入力されます。

自動トレースが不可能な場合は、language.high からの概念の目的の入力ノードを生成コードと明示的に一致させるために $TRACE$ マクロを使用できます。

ブレークポイントクリエーター

さまざまなノードにブレークポイントを作成する方法を指定するために、ルート breakpoint creators が使用されます。これは jetbrains.mps.debugger.api.lang 言語からの概念 BreakpointCreator の根本です。ルートは言語プラグインモデルに配置されるべきです。それは BreakpointableNodeItem のリストを含みます。それらの各々はブレークポイントを作成するための概念のリストと実際にブレークポイントを作成する方法を指定します。jetbrains.mps.debugger.api.lang はデバッガーを操作するための、特にブレークポイントを作成するためのいくつかの概念を提供します。それらについて以下に説明します。

• DebuggerReference – java デバッガーなどの特定のデバッガーへの参照。

• CreateBreakpointOperation – 特定のプロジェクトの特定のノードに特定の種類のロケーションブレークポイントを作成する操作。

• DebuggerType – デバッガーへの参照用の特別なタイプ。

次の例では、baseLanguage の breakpoint creators ノードが表示されています。

より複雑なフィルタリング動作を提供するために、単純な複雑なリストの代わりにブレークポイント作成者は isApplicable 関数を使用することができます。この機能の使用に切り替えるインテンションがあります。