AZAREA Tips

AZAREA-Cluster0.9.0の操作に関するメモ。

Tips

エディターの起動方法

1. パッケージエクスプローラー上で対象のクラス（フロー・エンティティ・アプリケーション）あるいはパッケージを選択する。
2. ツールバーの「AZAREA-Cluster Editor」をクリックする。
   もしくは、パッケージエクスプローラーから右クリックでポップアップメニューを開いて「AZAREA-Cluster」メニューを選択する。

どこが選択されているかに応じて、「AZAREA-Cluster」メニューの内容が変わる。

新規作成

フローやエンティティを初めて作成する場合は、先に空のディレクトリー（パッケージ）を作っておく必要がある。
（フロークラスでは、「新規エンティティフローを作成」ダイアログでパッケージ名を入力すれば作られるらしい[2013-01-06]）

フロー図の編集

エディターはモーダルダイアログであり、ソースと同時に見るには広いディスプレイが必要。
箱をダブルクリックしてソースの該当箇所へ跳ぶといった機能は無い。
範囲選択してまとめて箱を削除したり移動したりすることは出来ない。
図が多くなるとスクロールバーが出てくるが、Windows版（Pleiades All in One）Eclipse3.7だとマウスホイールでスクロールさせることは出来ない（Linux版Eclipse3.7は出来た）。

エディター上で描いたフローや変数名・クラス名はソースと連動する。
ただし、図の修正がその都度（リアルタイムで）ソースに反映されるわけではない。
エディター上で確定（更新ボタンを押す）してダイアログを閉じるとソースが生成（修正）される。

ソース以外に図のデータを保持していないので、ソースを変えれば次にエディターを開いたときには反映されている。
図上の箱の位置は毎回再計算されるので、手で綺麗に整列させる意味はあまり無い。

箱の処理の種類を変えること（GroupSortをGroupに変えるとか）も出来るが、ソースへの反映は追加分のみとなる。
（変更前のメソッドは残るからコンパイルエラーになるので、手で修正する）

箱の編集では、出力エンティティ（ファイルの種類）を変えられる処理と変えられない処理がある。
（例えばGroupは入力と同じ出力でないといけないようで、出力の種類だけを変えることは出来ない）
箱の入出力エンティティを別の物に変えると、線で結ばれて連動している箇所については自動的に同じエンティティに変更される。

UniqueJoinでは2箇所から線を引いてくることになるが、後から引く方（結合エンティティ）がマスターになる。（矢印も白抜きになる）
入れ替えたい場合は、白抜き矢印を右クリックして「入力順を先頭に」を選ぶと入れ替わる。[/2013-01-06]
（線を複数選択してまとめて削除することは出来ない）

エンティティのエディター

エンティティクラス名をエディター上で変えることは出来ない。
ソース上でリファクタリングによって変えるのは問題ない。

エンティティクラスのプロパティ作成時にコピー&ペーストすることは出来ない。
（ 一旦Excelにエクスポートして編集するのがいいかも？）
別のエンティティクラスのプロパティを全部持ってくる（インポートする）ことは出来る。

JUnit用のテストソース作成

JUnitのテストソースは、一旦テストクラス（シミュレーターによる実行クラス）を生成してから、JUnit用に修正するのが楽。

処理（GroupSort）

GroupSortで自動生成されるソースでは“エンティティーのListを受け取るmergeメソッド”が用意されるが、先頭の数レコードだけ処理する場合は“1レコードずつ呼ばれるmergeメソッド”を使う方が実行効率が良くなる。[2013-01-12]
（このメソッドは自分で（手動で）オーバーライドする必要がある）

GroupSort<NumberEntity, Result2Entity> distinct2 =
	new GroupSort<NumberEntity, Result2Entity>(
		entity4, "date", "number")
{
	@Override
	protected void merge(List<NumberEntity> entities) {
		// 先頭レコードに対してのみ出力する（distinct）
		NumberEntity entity = entities.get(0);

		Result2Entity result = new Result2Entity();
		result.date  = entity.date;
		result.count = 1;
		output(result);
	}
};

GroupSort<NumberEntity, Result2Entity> distinct2 =
	new GroupSort<NumberEntity, Result2Entity>(
		entity4, "date", "number")
{
	@Override
	protected void merge(List<NumberEntity> entities) {
		// NOP
	}

	@Override
	protected void merge(NumberEntity entity, boolean isFirst, boolean isLast) {
		// 先頭レコードに対してのみ出力する（distinct）
		if (isFirst) {
			Result2Entity result = new Result2Entity();
			result.date  = entity.date;
			result.count = 1;
			output(result);
		}
	}
};

処理（Group）

GroupSortよりGroupの方が実行効率が良いらしいので、Groupに出来るものはGroupにした方が良い。[2013-01-12]
（GroupSortが必ずReducerで実行されるのに対し、Groupは可能であればMapperでも処理される為）

GroupSort<NumberEntity, Result2Entity> distinct2 =
	new GroupSort<NumberEntity, Result2Entity>(
		entity4, "date", "number")
{
	@Override
	protected void merge(List<NumberEntity> entities) {
		// 先頭レコードに対してのみ出力する（distinct）
		NumberEntity entity = entities.get(0);

		Result2Entity result = new Result2Entity();
		result.date  = entity.date;
		result.count = 1;
		output(result);
	}
};

Group<NumberEntity> distinct2 =
	new Group<NumberEntity>(entity4, "date", "number")
{
	@Override
	protected void doSummarize(NumberEntity summary, NumberEntity another) {
		// NOP（先頭レコードだけ出力する）
	}
};

Conversion<NumberEntity, Result2Entity> entity2 =
	new Conversion<NumberEntity, Result2Entity>(distinct2)
{
	@Override
	protected void convert(NumberEntity entity) {
		Result2Entity result = new Result2Entity();
		result.date  = entity.date;
		result.count = 1;
		output(result);
	}
};

Asakusa Frameworkとの比較

一見AZAREAと立場が似ているように見えるAsakusa Frameworkとの比較。

AZAREAは、処理（AsakusaFWで言う演算子）がMap/Reduceにきっちり対応しているように見えるので、MapReduceのラッパーを目指しているように感じられる（MapReduceのラッパーだと考えると分かり易い）。
（AsakusaFWは処理に必要な演算子（と、あったら便利な演算子）（および、最適化に有効）という視点で演算子を用意していると思われる）

GUIによるフローも、Map/Reduceをどの順序で処理するかを記述するものになっているような気がする。
（フローの箱に表示されるのがConversionやGroupといった処理名であり、何の処理をするものなのかという説明は0.9.0版では入れられない。（変数名でそれっぽく入れられるけど）
複雑なアプリならConversionとかは大量に出てくるはずで、何を行う為のConversionなのかが書けないと不便なはず。
ということは、逆説的に、あまり複雑なものは対象にしていないのではないかと思ってしまう＾＾；）

AsakusaFWは大規模な基幹バッチを対象にするという目的から、敢えてGUIを外してDSL方式を採用したらしい。（箱が多くなったら大変だから）
実際、AZAREAで作ってみた1つの入力から4種類の集計を行うサンプルでは箱が20個くらいで1画面に収まらなくなっているので、もっと複雑になったらどうなるか…。
（ちなみに、このサンプルの当初版は実行したらOutOfMemoryErrorになったので、AZAREAはあまり複雑なものに対応できていないのではないかと思ったのだが、GroupSortのコーディング方法を変えたら回避できた。[/2013-01-06]）