<?xml version="1.0" encoding="UTF-8"?>
<document xmlns="http://maven.apache.org/XDOC/2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
	<properties>
		<title>セットアップ</title>
	</properties>
	<body>
		<section name="目次">
			<ul>
				<li><a href="#セットアップ">セットアップ</a>
					<ul>
						<li><a href="#JDKのインストール">JDKのインストール</a></li>
						<li><a href="#Eclipseのインストール">Eclipseのインストール</a></li>
						<li><a href="#Eclipseの設定">Eclipseの設定</a></li>
						<li><a href="#プロジェクトの設定">プロジェクトの設定</a>
							<ul>
								<li><a href="#JREの設定">JREの設定</a></li>
								<li><a href="#ビルドパスの設定">ビルドパス（Build Path）の設定</a></li>
								<li><a href="#注釈処理の設定">注釈処理（Annotation Processing）の設定</a></li>
								<li><a href="#ファクトリパスの設定">ファクトリパス（Factory Path）の設定</a></li>
							</ul>
						</li>
					</ul>
				</li>
				<li><a href="#セットアップの確認">セットアップの確認</a>
					<ul>
						<li><a href="#エンティティクラスの作成">エンティティクラスの作成</a></li>
						<li><a href="#その他">その他</a></li>
					</ul>
				</li>
				<li><a href="#Eclipseプラグインのインストール">Eclipseプラグインのインストール</a></li>
			</ul>
		</section>
		<section name="セットアップ">
			<subsection name="JDKのインストール">
				<p>
					バージョン6以上のJDKをインストールします。
					JREではなくJDKが必要であることに注意してください。
					JDK 6 は以下のURLのサイトからダウンロードできます。
				</p>
				<p>
					<a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">http://www.oracle.com/technetwork/java/javase/downloads/index.html</a>
				</p>
			</subsection>
			<subsection name="Eclipseのインストール">
				<p>
					バージョン3.5以上のEclipseをインストールします。
					<a href="http://jcp.org/en/jsr/detail?id=269">Pluggable Annotation Processing API</a>
					をサポートしていれば、Eclipse以外のIDEであってもかまいませんが、
					このドキュメントではEclipseを使うことを前提に説明を進めます。
					Eclipseは以下のURLのサイトからダウンロードできます。
				</p>
				<p>
					<a href="http://www.eclipse.org/downloads/">http://www.eclipse.org/downloads/</a>
				</p>
				<p>
					Eclipseは、バージョン6以上の<b>JDKに含まれるJRE</b>で起動されるようにしてください。
					明示的にJREを指定するには、-vm オプションを使用します。
				</p>
				<pre>-vm %JAVA_HOME%\bin\javaw.exe</pre>
			</subsection>
			<subsection name="Eclipseの設定">
				<p>
					Installed JREsに、バージョン6以上の<b>JDKに含まれるJRE</b>を登録します（登録されていない場合）。
				</p>
				<p>
					Installed JREsの設定は、メニューの Window - Preferences と選択してPreferences画面を開き、左のメニューから Java - Installed JREs と辿ります。
				</p>
				<img src="images/eclipse_installed_jres.png" width="454" height="152" alt="Installed JREsの設定" />
			</subsection>
			<subsection name="プロジェクトの設定">
				<p>
					EclipseのJavaプロジェクトや動的Webプロジェクトに対し、以下の設定を行います。
				</p>
				<h4><a name="JREの設定"></a>JREの設定</h4>
				<p>
					プロジェクトのJREの設定項目には、<a href="#Eclipseの設定">Eclipseの設定</a>で登録したJREを指定してください。
				</p>
				<h4><a name="ビルドパスの設定"></a>ビルドパス（Build Path）の設定</h4>
				<p>
					doma-x.x.x.jarをプロジェクトのビルドパスに追加してください。
				</p>
				<img src="images/eclipse_buildpath_settings.png" width="454" height="152" alt="ビルドパスの設定" />
				<h4><a name="注釈処理の設定"></a>注釈処理（Annotation Processing）の設定</h4>
				<p>
					プロジェクトのプロパティ画面を開き、左側のツリーメニューから Java Compiler - Annotation Processing と辿り、
					「Enable project specific settings」のチェックボックスにチェックを入れてください。
				</p>
				<p>
					「Generated source directory」のテキストボックスに記入された値を確認してください。
					デフォルトでは「.apt_generated」です。
					注釈処理により生成されたソースコードはプロジェクト直下のこの名前のディレクトリに格納されます。
				</p>
				<img src="images/eclipse_apt_settings.png" width="454" height="152" alt="注釈処理の設定" />
				<h4><a name="ファクトリパスの設定"></a>ファクトリパス（Factory Path）の設定</h4>
				<p>
					プロジェクトのプロパティ画面を開き、左側のツリーメニューから Java Compiler - Annotation Processing - Factory Path と辿り、
					「Enable project specific settings」のチェックボックスにチェックを入れてください。
				</p>
				<p>
					次に、「Add JARs...」ボタンを押して、ビルドパスに通したdoma-x.x.x.jarと同じjarをファクトリパスにも追加してください。
				</p>
				<img src="images/eclipse_factorypath_settings.png" width="454" height="152" alt="ファクトリパスの設定" />
			</subsection>
		</section>
		<section name="セットアップの確認">
			<subsection name="エンティティクラスの作成">
				<p>
					注釈処理が行われることを確認するため、エンティティクラスを作成します。
					Javaエディタを開き、次のようなクラスを作成してください。
				</p>
				<source>package example;

import org.seasar.doma.Entity;

@Entity
public class Employee {

    String name;
}</source>
				<p>
					ビルド後（自動でビルドされる設定ならばエディタの保存後）に、実装クラス「example._Employee」が自動生成されれば、セットアップは成功していると言えます。
					生成されたソースコードは、注釈処理（Annotation Processing）の設定画面で変更していなければ、プロジェクト直下の「.apt_generated」というディレクトリに保存されます。
					「.apt_generated」は、デフォルトではPackage Explorerビューに表示されません。
					Package Explorerビューのフィルタリングの設定を変更するか、Nivigatorビューで確認してください。
				</p>
			</subsection>
			<subsection name="その他">
				<p>
					セットアップがうまくいかない場合は、<a href="faq.html">よくある質問</a>が参考になるかもしれません。
				</p>
			</subsection>
		</section>
		<section name="Eclipseプラグインのインストール">
			<p>
				開発をスムーズに進めるためには、Eclipseプラグイン<a href="extension/doma_tools.html">Doma Tools</a>の利用をお奨めします。
				このプラグインは以下の更新サイトからインストールできます。
			</p>
			<ul>
				<li><a href="http://eclipse.seasar.org/updates/3.5/">http://eclipse.seasar.org/updates/3.5/</a></li>
			</ul>
		</section>
	</body>
</document>
