About

ドキュメント

Javadocs

プロジェクト文書

Built by Maven

概要

Annotation Processing Tool (apt) を利用すると、ソースコードの自動生成や検証をコンパイル時に行うことができます。

DomaではこのAPIを利用し、@Entityや@Daoと言ったアノテーションが注釈されたクラスやインタフェースを処理し、必要なクラスを自動生成します。 また、注釈されたクラスやインタフェースの検証を行い、Domaの規約に従っていないソースコードがある場合は エラーメッセージをIDE(Eclipseなど)のエディタやjavacを実行したコンソール上に表示します。

オプション

注釈処理にはオプションを与えることができます。 Domaで定義しているオプションには次のものがあります。 必要に応じて使用してください。

key 説明 デフォルトの値
dao.package @Daoが注釈されたインタフェースの実装クラスが生成されるパッケージ。 何らかの値を指定した場合、dao.subpackageの指定よりも優先される。 @Daoが注釈されたインタフェースと同じパッケージ
dao.subpackage @Daoが注釈されたインタフェースの実装クラスが生成されるサブパッケージ。 dao.packageに値を指定していない場合にのみ有効。 @Daoが注釈されたインタフェースのパッケージが「example.dao」で、ここに指定した値が「impl」の場合、 生成されるクラスのパッケージは「example.dao.impl」となる。
dao.suffix @Daoが注釈されたインタフェースの実装クラスの名前のサフィックス。 @Daoが注釈されたインタフェースの単純名が「EmployeeDao」で、ここに指定した値が「Bean」の場合、 生成されるクラスの単純名は「EmployeeDaoBean」となる。 Impl
debug 注釈処理のデバッグ情報をログ出力するかどうか。「true」の場合、ログ出力を行う。 false

Eclipseでのオプション指定

Ecipseでは、プロジェクトのプロパティの「Annotation Processing」の項目でオプションを登録します。

Eclipseでのオプション指定

javacでのオプション指定

-Aオプションにより登録します。詳細はjavacのドキュメントを参照してください。

Antでのオプション指定

javacタスクのcompilerargタグのlineパラメータを使用します。

<javac fork="yes" srcdir="src" compiler="javac1.6"
	classpathref="classpath" destdir="target" debug="on" encoding="UTF-8" >
	<compilerarg line="-Adao.subpackage=impl -Adto.suffix=Dao -Adto.debug=true "/>
</javac>

Mavenでのオプション指定

maven-compiler-pluginのcompilerArgumentタグを使用します。

<plugin>
	<artifactId>maven-compiler-plugin</artifactId>
	<configuration>
		<source>1.6</source>
		<target>1.6</target>
		<encoding>UTF-8</encoding>
		<compilerArgument>-Adao.subpackage=impl</compilerArgument>
	</configuration>
</plugin>

指定したいオプションが1つの場合は問題ありませんが、複数のオプションはMavenの制限により指定できません。