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

生徒

「Micronautのコードを見ていたら、メソッドにアノテーションが付いているだけで、ログ出力や処理が追加されていました。あれは何をしているんですか？」

先生

「それはAOPと呼ばれる仕組みです。Micronautでは、アノテーションを付けるだけで、共通処理を自動的に組み込めます。」

生徒

「クラスの中に書いていない処理が、いつの間にか動いている感じがして不思議です。」

先生

「仕組みを理解すると、なぜそうなるのかが分かります。では、MicronautのAOPを基礎から整理していきましょう。」

1. AOPとは何かをイメージで理解する

AOPとは、プログラムの処理を横断的に分離して扱う考え方です。 Javaプログラミングでは、ログ出力、処理時間計測、トランザクション管理など、多くのクラスで共通して行いたい処理が存在します。

これらを各クラスやメソッドに直接書いてしまうと、同じようなコードが何度も登場し、修正や管理が難しくなります。 AOPを使うと、こうした共通処理をまとめて定義し、必要な場所にアノテーションで適用できるようになります。

MicronautのAOPは、DIとアノテーションベース開発と深く結びついており、シンプルな記述で強力な拡張が可能です。

2. MicronautにおけるAOPの特徴

MicronautのAOPには、大きな特徴があります。それは、コンパイル時にAOPの処理が解析される点です。実行時にリフレクションを多用しないため、起動が速く、メモリ消費も抑えられます。

そのため、マイクロサービスやクラウド環境でも扱いやすく、 Java初心者でも比較的安全に利用できます。 AOPと聞くと難しそうに感じますが、実際にはアノテーションを付けるだけで使える場面が多いです。

3. AOPでよく使われるアノテーションの例

Micronautには、AOPを活用したアノテーションがいくつか用意されています。代表的なものとして、処理時間の計測やメソッドの前後処理があります。ここでは、自作アノテーションを使った基本例を見てみましょう。


import io.micronaut.aop.Around;
import io.micronaut.context.annotation.Type;

import java.lang.annotation.*;

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.TYPE})
@Around
@Type(LogInterceptor.class)
public @interface LogExecution {
}

このアノテーションは、メソッドやクラスに付けることで、指定したインターセプタを介した処理を行います。アノテーション自体には処理を書かず、実際のロジックは別クラスにまとめる点が特徴です。

4. インターセプタで処理を追加する仕組み

AOPの中核となるのがインターセプタです。インターセプタは、対象となるメソッドの前後に割り込んで処理を実行します。これにより、元のコードを変更せずに機能を追加できます。


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

@Singleton
public class LogInterceptor 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;
    }
}

このインターセプタでは、対象メソッドの実行前後でログを出力しています。実際のビジネスロジックには一切手を加えていない点が重要です。これがAOPの基本的な考え方になります。

5. AOPアノテーションを使う側のクラス

次に、作成したアノテーションを使う側のクラスを見てみましょう。ここでは、シンプルなサービスクラスに適用します。


import jakarta.inject.Singleton;

@Singleton
public class SampleService {

    @LogExecution
    public void execute() {
        System.out.println("サービスの本処理を実行");
    }
}

このクラスでは、メソッドにアノテーションを付けただけで、ログ出力の処理が自動的に追加されます。 AOPを知らないと魔法のように見えますが、実際にはインターセプタが間に入って処理しています。