
名前	バージョン	入手先
Eclipse	JDT	3.6.1	http://www.eclipse.org/downloads/
astah* community	6.2.1	http://astah.change-vision.com/ja/product/astah-community.html
FreeMarke	2.3.16	http://freemarker.sourceforge.net/freemarkerdownload.html
CLI	1.2	http://commons.apache.org/cli/download_cli.cgi
表1　各種開発環境・ライブラリの入手先一覧

MDDツールを自作してみよう！

　今回開発するMDDツールでは、astah* API、FreeMarker、Apache Commons CLIというJavaベースの3つのライブラリを利用しますので、Eclipseを用いJavaで実装していきます。

　なお、今回開発するソフトウェアのサンプル「AstahCodeGenerator」は、以下のリンクからダウンロードできます（注1）。以降の解説では、プログラムのポイントとなる部分にのみフォーカスしています。プログラム全体を確認しながら読み進めたい場合は、本ファイルをダウンロードしてください。

＞＞サンプル「AstahCodeGenerator.zip」のダウンロード＜＜

※注1：ダウンロード後、ファイルを解凍してください。解凍されたフォルダ配下はEclipseプロジェクトとなっていますので、そのままEclipseにインポートしてください。

事前準備

　まずは、Eclipse上で新規Javaプロジェクトを作成してください。プロジェクトのフォルダ構成を以下のとおりにしてください。

AstahCodeGenerator/
  ├ bin/
  │   実行バイナリの配置フォルダ
  ├ example/
  │   サンプル入力ファイルの配置フォルダ
  ├ lib/
  │   外部ライブラリの配置フォルダ
  ├ out/
  │   生成コードの出力先フォルダ
  ├ src/
  │   Javaソースコードの配置フォルダ
  ├ template/
  │   FreeMarkerテンプレート定義ファイルの配置フォルダ
  └ tool/
       本ツールを起動するためのバッチファイルを配置するフォルダ

　続いて、ビルド・パスの設定を行います。

　プロジェクトを右クリックして［プロパティ］を選択し、表示されたダイアログの左ペインから［Javaのビルド・パス］を選択してください。続いて［ソース］タブにて、“src”と“template”フォルダを追加します。さらに、［ライブラリ］タブにて、今回利用する3つのライブラリ（astah-api.jar、freemarker.jar、commons-cli-1.2.jar）を追加します。

　以上で準備が整いました。

　それではコーディング上の主なポイントを解説しつつ、MDDツールの開発を進めていきたいと思います。

モデル情報の読み込み

　astah* APIを用いて、入力パラメータとして渡されたファイルからモデル情報を読み込みます。モデル情報にアクセスするためには、最初にプロジェクトアクセサを作成する必要があります。サンプルでは、AstahDiagramFinderクラスでこの実装を行っています（リスト1）。

ProjectAccessor prjAccessor;
 
public AstahDiagramFinder(String inputFile) {
        prjAccessor = ProjectAccessorFactory.getProjectAccessor();
        prjAccessor.open(inputFile, true, false, true);
}

リスト1　AstahDiagramFinder.java（22～27行目）

　AstahDiagramFinderクラスのコンストラクタにて、パラメータ（inputFile）に与えられたastah*ファイルパスを基に、astah*プロジェクトをオープンしています。

　astah*プロジェクトがオープンできたら、今回の読み込み対象であるステートマシン図にアクセスします。サンプルでは、プロジェクト直下に1つのモデル図のみが配置されていますが、通常はプロジェクトに複数のモデル図がフォルダ構造で定義されます。ですので、フォルダ構造を走査して該当するモデル図のみをリスト化する必要があります。リスト2がその部分の実装になります。

public List<IStateMachineDiagram> findAllStateMachineDiagrams() throws
        ProjectNotFoundException {
        return getAllStateMachineDiagrams(prjAccessor.getProject());
}
 
private List<IStateMachineDiagram> getAllStateMachineDiagrams
        (INamedElement iNamedElement) {
        ArrayList<IStateMachineDiagram> diagrams = 
        new ArrayList<IStateMachineDiagram>();
        IDiagram[] dgms = iNamedElement.getDiagrams();
        for (int i = 0; i < dgms.length; i++) {
                if (dgms[i] instanceof IStateMachineDiagram) {
                        diagrams.add((IStateMachineDiagram) dgms[i]);
                }
        }
        ：


リスト2　AstahDiagramFinder.java（33～44行目）

　プロジェクトアクセサから取得したプロジェクトオブジェクトは、ツリー構造のルートノード要素として扱われます。getAllStateMachineDiagrams()メソッドは、再帰的に呼び出されて、プロジェクト配下のフォルダを表すノードオブジェクトから、そのフォルダ配下のモデル図（IDiagramクラス）のリストを収集します。ここで収集されるモデル図には、ステートマシン図をはじめとしたさまざまなUMLのダイヤグラムが含まれていますので、その中からステートマシン図（IStateMachineDiagram）に該当するものだけを取り出します。

　これで必要なモデル情報として、ステートマシン図のみが収集できました。

ソースコードの生成

　テンプレートエンジンFreeMarkerを用いて、テンプレートファイルに記述されたルールに従い、ソースコードを生成します。テンプレートファイルの記述方法は後述することとし、まずはFreeMarkerの主な処理手順について見ていきたいと思います。

　FreeMarkerを動作させるためには、最初にConfigurationクラスを用いて、実行に必要なパラメータを構成（コンフィグ）します。リスト3に、この部分の実装であるcreateTemplateConfig()メソッドを示します。

// テンプレートのコンフィグを行う
private static Configuration createTemplateConfig() throws IOException {
 
        final String projDir = CourseCodeGenerator.class.getProtectionDomain()
                        .getCodeSource().getLocation().getPath();
 
        Configuration cfg = new Configuration();
        cfg.setDirectoryForTemplateLoading(new File(projDir
                        + File.separator + "../template"));
        cfg.setObjectWrapper(new DefaultObjectWrapper());
        return cfg;
}


リスト3　CourseCodeGenerator.java（91～102行目）

　ここではパラメータの1つとして、テンプレートファイルが配置されているディレクトリを指定しています。なおFreeMarkerでは、テンプレートのロード方法としてディレクトリ指定以外にもクラスパス指定で行うことも可能です。

　続いて、FreeMarkerに渡すパラメータを作成します。リスト4に、この部分の実装であるcreateTemplateRootMap()メソッドを示します。

private static Map<String, Object> createTemplateRootMap
         (IStateMachineDiagram diagram) {
        Map<String, Object> root = new HashMap<String, Object>();
        ：
        root.put("lastUpdated", new Date());
        root.put("diagram", diagram);
        return root;
}


リスト4　CourseCodeGenerator.java（105～112行目）

　FreeMarkerでは、テンプレート処理を行うデータモデルを、テンプレートファイルに記述する「名前」と、その名前で呼び出す「オブジェクト」を対応付けたマップオブジェクトで渡す必要があります。従って、このメソッド内でこのマップオブジェクトを作成します。

　今回は、コード生成日時をスタンプするための情報（Dateオブジェクト）と、astah*から読み取ったモデル情報（IStateMachineDiagramインターフェイスの実装オブジェクト）をマップオブジェクトに設定しています。

　最後に、テンプレートエンジン（Templateクラス）に処理を移譲します。この部分の実装をリスト5に示します。

// ソースファイルを生成
private static void generateSourceFile(Configuration templateConfig,
                Map<String, Object> templateRootMap, String sourceFilename)
                throws IOException, TemplateException {
 
        Writer sourceWriter = new FileWriter(sourceFilename);
        Template sourceTemplate = templateConfig.getTemplate("course.ftl");
        sourceTemplate.process(templateRootMap, sourceWriter);
        sourceWriter.flush();
}