先生と生徒の会話形式で理解しよう

生徒

「Micronautを勉強していたら、AOPとかインターセプタという言葉が出てきました。これは何をする仕組みなんですか？」

先生

「MicronautのAOPは、処理の前後に共通の処理を差し込むための仕組みです。ログ出力やトランザクション管理などでよく使われます。」

生徒

「共通処理をまとめられるということですか？」

先生

「その通りです。AOPを使うと、コードをシンプルに保ちながら、保守しやすい設計ができます。では、順番に仕組みを見ていきましょう。」

1. MicronautにおけるAOPの基本的な考え方

MicronautのAOPは、アプリケーションの横断的な関心事を分離するための仕組みです。横断的な関心事とは、業務ロジックとは直接関係しないものの、多くのクラスで共通して必要になる処理を指します。代表的な例として、ログ出力、パフォーマンス計測、例外処理、セキュリティチェックなどがあります。

初心者がMicronautを学ぶとき、サービスクラスやコントローラに同じようなコードを何度も書いてしまいがちです。AOPを使えば、そうした重複を減らし、読みやすく管理しやすいコードを書くことができます。

2. AOPが必要とされる理由とメリット

MicronautのAOPを使う最大のメリットは、関心事の分離です。業務ロジックと共通処理を分けることで、コードの見通しが良くなります。また、修正が必要になった場合も、共通処理だけを変更すればよいため、影響範囲を小さく抑えられます。

さらに、Micronautはコンパイル時にAOPを処理するため、実行時のオーバーヘッドが小さいという特徴があります。これは、高速起動や低メモリ使用量を重視するマイクロサービス開発において、大きな利点です。

3. MicronautのAOPとインターセプタの仕組み

MicronautのAOPは、アノテーションとインターセプタを組み合わせて動作します。アノテーションは「どの処理にAOPを適用するか」を示し、インターセプタは「実際にどんな処理を差し込むか」を定義します。

メソッドが呼び出されるとき、Micronautは対象のアノテーションを検出し、対応するインターセプタを通して処理を実行します。この流れにより、元のメソッドを変更せずに振る舞いを追加できます。

4. シンプルなAOP用アノテーションの作成例

ここでは、処理の開始と終了をログに出力するための簡単なアノテーションを例にします。初心者でも理解しやすいよう、最小限の構成にしています。


import io.micronaut.aop.Around;
import java.lang.annotation.*;

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.TYPE})
@Around
public @interface SimpleLog {
}

このアノテーションを付けることで、後ほど定義するインターセプタが適用されるようになります。Micronautでは、このようにアノテーションを起点としてAOPが動作します。

5. インターセプタを使った処理の実装例

次に、先ほどのアノテーションに対応するインターセプタを作成します。インターセプタでは、メソッドの前後に実行したい処理を記述します。


import io.micronaut.aop.InterceptorBean;
import io.micronaut.aop.MethodInterceptor;
import io.micronaut.aop.MethodInvocationContext;
import jakarta.inject.Singleton;

@Singleton
@InterceptorBean(SimpleLog.class)
public class SimpleLogInterceptor implements MethodInterceptor<Object, Object> {

    @Override
    public Object intercept(MethodInvocationContext<Object, Object> context) {
        System.out.println("処理開始: " + context.getMethodName());
        Object result = context.proceed();
        System.out.println("処理終了: " + context.getMethodName());
        return result;
    }
}

このように記述することで、対象メソッドの前後にログ出力が自動的に追加されます。業務ロジック側には一切変更を加えていない点がポイントです。

6. AOPを適用するクラスの例

最後に、作成したアノテーションを実際のクラスに適用してみます。以下は、サービスクラスの簡単な例です。


import jakarta.inject.Singleton;

@Singleton
public class GreetingService {

    @SimpleLog
    public String greet(String name) {
        return "こんにちは、" + name + "さん";
    }
}

このメソッドを呼び出すと、処理の前後でログが出力されます。AOPを使うことで、共通処理を意識せずにサービスの本来の役割に集中できるようになります。