セットアップ
Eclipseのインストール
バージョン3.5以上のEclipseをインストールします。 Pluggable Annotation Processing API をサポートしていれば、Eclipse以外のIDEであってもかまいませんが、 このドキュメントではEclipseを使うことを前提に説明を進めます。 Eclipseは以下のURLのサイトからダウンロードできます。
http://www.eclipse.org/downloads/
Eclipseは、バージョン6以上のJDKに含まれるJREで起動されるようにしてください。 明示的にJREを指定するには、-vm オプションを使用します。
-vm %JAVA_HOME%\bin\javaw.exe
プロジェクトの設定
EclipseのJavaプロジェクトや動的Webプロジェクトに対し、以下の設定を行います。
JREの設定
プロジェクトのJREの設定項目には、バージョン6以上のJREを指定してください。 JREはJDKに含まれたものでなければいけません。
ビルドパス(Build Path)の設定
doma-x.x.x.jarをプロジェクトのビルドパスに追加してください。
注釈処理(Annotation Processing)の設定
プロジェクトのプロパティ画面を開き、左側のツリーメニューから Java Compiler - Annotation Processing と辿り、 「Enable project specific settings」のチェックボックスにチェックを入れてください。
「Generated source directory」のテキストボックスに記入された値を確認してください。 デフォルトでは「.apt_generated」です。 注釈処理により生成されたソースコードはプロジェクト直下のこの名前のディレクトリに格納されます。

ファクトリパス(Factory Path)の設定
プロジェクトのプロパティ画面を開き、左側のツリーメニューから Java Compiler - Annotation Processing - Factory Path と辿り、 「Enable project specific settings」のチェックボックスにチェックを入れてください。
次に、「Add JARs...」ボタンを押して、ビルドパスに通したdoma-x.x.x.jarと同じjarをファクトリパスにも追加してください。

セットアップの確認
エンティティクラスの作成
注釈処理が行われることを確認するため、エンティティクラスを作成します。 Javaエディタを開き、次のようなクラスを作成してください。
package example; import org.seasar.doma.Entity; import org.seasar.doma.domain.BuiltinStringDomain; @Entity public interface Employee { BuiltinStringDomain name(); }
ビルド後(自動でビルドされる設定ならばエディタの保存後)に、実装クラス「example.Employee_」が自動生成されれば、セットアップは成功していると言えます。 生成されたソースコードは、注釈処理(Annotation Processing)の設定画面で変更していなければ、プロジェクト直下の「.apt_generated」というディレクトリに保存されます。