この文書ではEclipseのDMDL Editorプラグインを紹介します。
DMDL EditorX は ひしだま氏が開発しているOSSのEclipseプラグインで、 DMDLスクリプトファイルに関する編集機能を追加します。 [1]
まだ開発途上ですが、DMDLの編集が便利になります。
| [1] | 機能やインストール手順の詳細については、DMDL EditorXのサイトを確認してください。 https://github.com/hishidama/xtext-dmdl-editor |
Note
以前は DMDL Editor を紹介していましたが、 新たに Xtext を使ったXtext版DMDL Editor（DMDL EditorX）が開発され、古い方はメンテナンスされなくなりました。 インストール方法に少し違いがありますが、基本的な機能に変わりはありません。
ここでは主にUbuntu DesktopへLinux-32bit版を使ってインストールする手順を説明しますが、他のプラットフォームにおいてもインストール手順は同様です。
| 項目 | 説明 |
|---|---|
| 名前（Name） | サイトの名前を入力します。（例：「Xtext」） |
| ロケーション（Location） | XtextのダウンロードサイトのURL（ http://download.eclipse.org/modeling/tmf/xtext/updates/composite/releases/ ）を入力します。 |
Attention
似た名前で「Xtend」という選択肢がありますので、間違えないようにしてください。
| 項目 | 説明 |
|---|---|
| 名前（Name） | サイトの名前を入力します。（例：「dmdl-editor」） |
| ロケーション（Location） | DMDL EditorXのダウンロードサイトのURL（ http://hishidama.github.io/xtext-dmdl-editor/site/ ）を入力します。 |
Attention
もし「Do you want to add the Xtext nature to the project ‘プロジェクト名’?」というメッセージのダイアログが表示されたら、「Yes」ボタンを押してください。 これは、プロジェクトにXtextネイチャーを追加するもので、追加しないとXtextの機能を使うことが出来ません。
DMDL EditorXには色々な機能がありますが、簡単に役立つものを紹介します。
別のデータモデルを参照しているデータモデルにおいて、参照元データモデルの定義場所へジャンプする機能です。
例えば以下のような集計モデルのモデル定義において、 Ctrl キーを押しながら joined_sales_info をマウスでクリックすると、joined_sales_infoが定義されているモデルの定義行へジャンプします。
summarized category_summary = joined_sales_info => {
...
}
DMDLのコンパイルを行う機能です。
Note
通常は GradleやMavenのコマンドでDMDLのコンパイル を行ってJavaのデータモデルクラスを生成しますが、 DMDL EditorXではGradleやMavenを使わずにコンパイルすることが出来ます。
ツールバーの「DMDL compile」のアイコンをクリックすると、コンパイルが実行されます。（コンソール上にコンパイルメッセージが表示されます）
Javaのソースコード上のデータモデルのクラスやメソッドから定義元のDMDLへジャンプする機能です。
例えば以下のような演算子クラスのソースコードにおいて、 ErrorRecord （データモデルのクラス名）や setMessageAsString （データモデルのメソッド名）を Ctrl キーを押しながらマウスでクリックすると、ジャンプ先の選択肢が表示されます。 ここで「Open DMDL」を選ぶとDMDLスクリプトファイルへジャンプします。
@Update
public void setErrorMessage(ErrorRecord record, String message) {
record.setMessageAsString(message);
}