注釈処理

注釈処理プログラムは、追加 Java コードまたはその他のファイルを生成し、Java 5 (JSR-175) 注釈に基づいて問題マーカーを作成することができるユーティリティー・プログラムです。 プロセッサーは、その基礎を Java 5 ミラー API または Java 6 注釈処理 API のいずれかに置くことができます。「注釈処理の設定」ペインでは、プロジェクトまたはワークスペース内すべてのプロセッサーに適用する設定を構成することを許可します。 「ファクトリー・パスの設定」ペインでは、 使用可能なプロセッサーを指定し、個々のプロセッサーの構成を許可します。

注釈処理を使用可能にする

注釈処理オプションはデフォルトでオフになっているので、注釈処理を必要とするプロジェクトごとに、該当するチェック・ボックスをチェックしてこのオプションをオンにする必要があります。 あるプロジェクトのコード上で注釈処理プログラムを動作させるのに必要なことは、そのプロジェクト内で注釈処理を使用可能にすることだけです。 コード内に注釈が存在するだけで、注釈処理が必要になるということはありません。例えば、@Deprecated や @Override という注釈は通常、処理しなくてもかまいません。

エディターでの処理を使用可能にする

このオプションを有効にすると、Java エディターで変更が加えられた場合に常に処理プログラムが実行されるだけでなく、 プロジェクトのビルド時にも常に処理プログラムが実行されます。プロセッサーをエディターで実行できるようにすると、プロセッサーは入力時にエラーおよび警告を生成することができます。 例えば、処理プログラムは、コンパイラーが単独で検出できない セマンティックの問題を指示するため、不正な注釈値を赤で示すことができます。 しかし、注釈処理プログラムのなかには、エディター内で実行するとエディターの使用可能度の妨げになるほど速度が遅いものもあります。このような状況では、このオプションを使用不可にすることで、 エディターのパフォーマンスが改善される場合があります。処理プログラムは、プロジェクトがビルドされる場合にも常に、 実行されます。このオプションは、Java 6 注釈プロセッサーには適用されません。Java 6 注釈プロセッサーは、(現在のところ) Eclipse がビルド中にのみ実行できます。

生成されたソース・ディレクトリー

ファイルは指定したディレクトリーに対応するディスク上に生成されます。デフォルトでは、このディレクトリーは ".apt_generated" という名前が付けられます。このディレクトリーは '.' で始まっているので、フィルターにより「パッケージ・エクスプローラー」ビューには表示されません。生成されたファイルには、「派生」ビットが設定されます。プロジェクトがクリーン処理されると、生成されたソース・ディレクトリーの派生ファイルはすべて削除されます。 プロセッサーにより生成されたファイルに対しては、このディレクトリーの使用のみが推奨されます。このディレクトリーの中に手動で作成したファイルを置かないこと、また既存ディレクトリーを生成されたソース・ディレクトリーとして使用しないでください。

プロセッサーのオプション

ここで入力されたオプションは、AnnotationProcessorEnvironment インターフェース (Java 5 プロセッサーの場合) または ProcessingEnvironment インターフェース (Java 6 プロセッサーの場合) を介して使用できます。 特定のオプションは、Java 5 プロセッサーに自動的に提供され、このダイアログにオプションを入力しても影響はありません。自動的に提供された値はここで設定されている値を上書きするためです。 自動オプションについては、ここで説明されています。 プロセッサーのオプションについてさらに詳しい情報は、「プロセッサー・オプション入力」ダイアログのトピックにあります。