1. 導入：なぜ@Retentionの理解が重要なのか
Java開発において、アノテーションは単なる「印」ではありません。フレームワーク（SpringやHibernateなど）が実行時に動的に挙動を変えるための重要なメタデータです。しかし、誤った「寿命（RetentionPolicy）」を設定すると、コンパイル時には見えていたはずのアノテーションが実行時に消えてしまい、リフレクションで取得できないといったトラブルが発生します。本稿では、アノテーションを正しく設計・運用するためのRetention戦略について解説します。
2. 基礎知識：アノテーションの寿命を決める3つのポリシー
@Retentionアノテーションは、対象のアノテーションが「いつまで保持されるか」を決定します。
・RetentionPolicy.SOURCE
コンパイル時にのみ使用されます。.classファイルには残りません。Lombokの@Getterのように、コード生成ツールが「ソースコードの解析」のために使う場合に適しています。
・RetentionPolicy.CLASS
.classファイルには記録されますが、JVMが実行時にロードした際には無視されます。デフォルトの設定ですが、実務で自作アノテーションを作る際はあまり使いません。
・RetentionPolicy.RUNTIME
.classファイルに記録され、JVM実行時にもメモリ上に保持されます。リフレクションを使用して実行中にアノテーション情報を読み取る場合に必須です。Springの@Serviceや@Transactionalなどが代表例です。
3. 実装/解決策：リフレクションを用いた実行時解析
実行時にアノテーションを読み取るためには、@Retention(RetentionPolicy.RUNTIME)と、適用箇所を制限する@Targetが必要です。
以下は、独自の「実行ログ出力用」アノテーションを作成し、リフレクションでメソッドを特定して処理を実行する例です。
4. サンプルプログラム
import java.lang.annotation.;
import java.lang.reflect.Method;
// 1. アノテーションの定義
// 実行時にリフレクションで取得するためRUNTIMEを指定
@Retention(RetentionPolicy.RUNTIME)
// メソッドにのみ適用可能にする
@Target(ElementType.METHOD)
@interface ExecLog {
String value() default “デフォルトメッセージ”;
}
// 2. アノテーションを使用したクラス
class Service {
@ExecLog(“重要な処理を実行しました”)
public void executeTask() {
System.out.println(“タスク実行中…”);
}
}
// 3. リフレクションを用いた実行処理
public class RetentionDemo {
public static void main(String[] args) throws Exception {
Service service = new Service();
Method[] methods = service.getClass().getDeclaredMethods();
for (Method method : methods) {
// アノテーションが付与されているかチェック
if (method.isAnnotationPresent(ExecLog.class)) {
ExecLog anno = method.getAnnotation(ExecLog.class);
System.out.println(“ログ出力: ” + anno.value());
method.invoke(service);
}
}
}
}
5. 応用・注意点：現場で役立つ設計の勘所
・迷ったらRUNTIMEにする
もしアノテーションを「実行時に何かを判断する基準」として使いたいのであれば、迷わずRUNTIMEを選択してください。CLASSやSOURCEは、特定のビルドツールや静的解析ツールを作成する場合を除き、一般的なアプリケーション開発では混乱の元になります。
・@Targetとの組み合わせ
Retention（いつまで）だけでなく、Target（どこに付けるか）を適切に制限することも重要です。例えば「クラスにしか付けられないアノテーション」をメソッドに付与してコンパイルエラーにしたい場合は、@Targetで厳密に制御しましょう。
・Proxyとの連携
実務では、RUNTIMEアノテーションを付与したメソッドを、Spring AOPのような「Proxy」パターンでインターセプトするのが定石です。Proxy経由でメソッド呼び出しをフックし、アノテーションの内容に基づいて前処理・後処理（トランザクション管理や権限チェック）を自動化するのがJavaエンタープライズ開発の基本戦略です。
コメント