MPS 2019.2ヘルプ

インタープリタークックブックの作成

バージョン3.1からMPSにバンドルされている図形サンプルプロジェクトをチェックしてください。それはエディターでいくつかの素晴らしいトリックをすることができます。

デフォルトでは、エディターは、キャンバス上に指定されたサイズと色の視覚的形状を描画するためのコマンドで構成されるプレーンコードを表示します。

I1

コードをJavaに生成して実行することができます。これにより、上記のコードから生成されたばかりのアプリケーションを実行する新しいJavaプロセスが起動します。

I4

I5

ただし、MPSはJavaを生成せずにコードを解釈することもできます。インテンションポップアップメニューを呼び出して、「Preview Scene」を選択するためにコードのどこかにAlt + Enterを押してください。あなたのシーンを含む新しいフレームを得るでしょう、コードを解釈しています:

I6

I7

インスタントプレビュー

コードを解釈する機能により、エディターはインタープリターの結果をエディターを通じて開発者に返すことができます。個々の図形を解釈して、それぞれの図形を定義するコードの横にあるエディターで描画できます。

I2

または、シーン全体をコードの横に描画して、コードに加えられた変更に即座に対応することもできます。

I3

これらの機能を試してみるには、エディターを右クリックしてPush Editor Hintsを選択し、エディターに有効にするプレビュー機能を示すヒントを選択します。

I8

I9

これは簡単なお誘いでした。そのような単純な解釈機能をあなたの言語に組み込む方法を見ることができます。

インタープリターの定義

MPSは主にコード生成に焦点を当てています。ASTとして表されるプログラムは、ターゲット言語のコードに翻訳され、それがコンパイルされて実行されることがあります。しかしながら、あなたのコードを直接解釈することがより良い選択肢であるかもしれない状況があります。開発者に、コードが何をするのかのある種のプレビューを与えることができ、それによって彼らのコード変更への即時のフィードバックを提供することができます。実行時にのみ表示されるエラーを検出して報告することも、生成フェーズとコンパイルフェーズを迂回してコード実行修正サイクルの所要時間を短縮することもできます。

MPSには今のところインタープリターを構築するためのインフラストラクチャは付属していませんが、あなたの言語の振る舞いの側面はあなたに独自でインタープリターを構築するためのいくらかの力を与えます。理想的には、コードジェネレータと同じように、インタープリターの実行時クラスを保持する実行時ソリューションを作成します。言語の概念の振る舞いの側面は、ASTを正しくナビゲートし、モード内のすべてのノードを解釈するように分類されたランタイムと連携します。

図形言語がどのようにそのコードの解釈を可能にしたかを見ていきます。

全シーンインタープリター

ユーザーがインテンションによって明示的にインタープリターを呼び出すときのシナリオから始めましょう。まず、インテンションを作成する必要があります。

I10

インテンションは、キャンバスノードでinterpret()メソッドを呼び出します。これは、キャンバス振る舞いアスペクトで定義されています。

I21

このメソッドは、カスタマイズされたpaintComponent()メソッドを使ってパネルを保持する新しいフレームを構築します。このパネルは他のプレビュー機能で再利用されているため、別のヘルパークラスPreviewFactoryに抽出されました。些細な場合以外は、クラスをランタイムソリューションに配置する必要がありますが、ここでは言語の振る舞いアスペクトに直接配置しました。

I22

現在のモデルはコードthisCanvas.shapes.forEach({〜it => it.drawShape(graphics)});でトラバースされます。これが解釈が起こるところです。drawShape()メソッドは、形状サブコンセプトごとに実装されているため、画面上にレンダリングできます。モデルへの読み取り許可を保証するために、トラバーサルコードがReadAction内にラップされていることに注意してください。

drawShape()メソッドはすべての図形:によって実装されなければなりません

I12

I13

I14

これで私たちの小さなインタープリターが立ち上がるのに十分です。

形状プレビュー

コード内で定義の隣にある個々の図形をプレビューするには、エディターを変更するか、別のエディターヒントを使用して新しい図形を定義する必要があります。これにより、図形の視覚化を含むswingコンポーネントが保持されます。このサンプルでは、複数の投影法を活用することを選択し(MPSで複数の投影法がどのように機能するかを確認するには、マルチプロジェクションビデオ(英語)を参照)、ヘッダーにShapePreviewヒントを指定して新しいエディターを作成しました。ユーザーがShapePreviewヒントを有効にした場合にのみ、デフォルトのテキストのみの代わりにこのエディターが使用されます。

I16

swingコンポーネントJPanelを定義します。paintComponent()メソッドではモデルに対して読み取りロックを取得してから、現在の形状ノードを特定の位置に描画します。キャンバス内の定義された位置を無視して図形を描画するために、図形に新しいdrawShapeAt()メソッドが追加されています。

I17

シーンプレビュー

シーン全体をプレビューするには、キャンバスコンセプト用の新しいエディターを作成し、それをScenePreviewエディターヒントにフックする必要があります。

I23

swingコンポーネントセルにはカスタマイズされたJPanelが含まれています。これは、以前の明示的なユーザー要求について解釈したときと同様に、PreviewFactoryクラスによって作成されます。

これで終わりです。それを好きだったことを望みます。

最終更新日: 2019年8月30日