1. Micronautにおけるログ出力とAOPの役割

Micronautでアプリケーションを開発していると、処理の流れを確認するためにログ出力が欠かせません。しかし、すべてのメソッドに同じようなログコードを書くと、ソースコードが読みにくくなり、修正も大変になります。

そこで役立つのがAOPです。AOPを使うことで、ログ出力のような共通処理をビジネスロジックから分離できます。MicronautのAOPはコンパイル時に処理が決まるため、性能面でも安心して利用できます。

2. ログ出力AOPの基本構成を理解しよう

Micronautでログ出力AOPを実装する場合、主に三つの要素を用意します。ログ用のアノテーション、インターセプタ、そしてログを適用したいクラスやメソッドです。

この構成を理解すると、ログ以外の共通処理にも応用できるようになります。初心者のうちは、まず全体の流れを把握することが大切です。

3. ログ用アノテーションを作成する

最初に、ログ出力を有効にするためのアノテーションを作成します。このアノテーションを付けたメソッドが、AOPの対象になります。


import io.micronaut.aop.Around;
import io.micronaut.context.annotation.Type;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
import java.lang.annotation.ElementType;

@Around
@Type(LogInterceptor.class)
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD})
public @interface Logged {
}

このアノテーションは、ログ用インターセプタと結びついています。初心者でも、名前を見るだけで役割が想像しやすいのがポイントです。

4. ログ出力を行うインターセプタを実装する

次に、実際にログを出力するインターセプタを作成します。インターセプタでは、メソッドの実行前と実行後に処理を挟み込めます。


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("start: " + context.getMethodName());
        Object result = context.proceed();
        System.out.println("end: " + context.getMethodName());
        return result;
    }
}

このように書くだけで、対象メソッドの前後にログを自動で出力できます。複雑な設定は必要ありません。

5. ログ出力AOPをメソッドに適用する

作成したアノテーションは、ログを出したいメソッドに付与します。これだけで、共通ログ処理が有効になります。


import jakarta.inject.Singleton;

@Singleton
public class SampleService {

    @Logged
    public String execute(String name) {
        return "Hello " + name;
    }
}

この方法なら、ログが不要なメソッドには一切影響を与えません。コードの見通しも良くなります。