JavaのAnnotationの処理

投稿日:

この記事はhydrogen Advent Calender 2024の12日目の記事です。

Annotation

JavaにはAnnotation(注釈)という機能がある。これは、次のように定義される。

@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
    String value();
    int number() default 0;
}

注釈に与える値の名前の定義はこのように抽象メソッドのように書く。これは、実態としてはjava.lang.annotation.Annotationを継承したインターフェースであるからだ。だが、これは糖衣構文ではなくAnnotationを継承したインターフェースを素直に書いても注釈として使うことはできない。

また、valueという名前のメソッドは注釈を付与する際に省略することができる。

また、@Targetはこの注釈をどこに付けることが可能であるかを、@Retentionはこの注釈がどの時点まで保持されるかを指定する。

後者について注目しよう。RetentionPolicyには次の3つの値がある。

@RetentionRUNTIMEである場合、実行時もリフレクションを使ってその注釈を取得することができる。

public class Main {
    @MyAnnotation("Hello, world!")
    public static final int FOO = 42;
    public static final int BAR = 1337;
    public static void main(String[] args) {
        Field[] fields = Main.class.getDeclaredFields();
        for (Field field : fields) {
            if (field.isAnnotationPresent(MyAnnotation.class)) {
                MyAnnotation annotation = field.getAnnotation(MyAnnotation.class);
                System.out.printf("Field %s: %s\n", field.getName(), annotation.value());
            }
        }
        System.out.println("Done.");
    }
}
Field FOO: Hello, world!
Done.

では、CLASSSOURCEの場合はどうなるかというと取得することはできない。

なら何のためにCLASSSOURCEがあるのかというと、コンパイル時に指示を出したり、IDEの補完機能を使ったりするために使われる。

例えば、@SuppressWarningsRetentionPolicy.SOURCEである。これは、コンパイラに対して警告を抑制する指示を出すために使われる。

また、検査用フレームワークによくある@NotNull@NullableRetentionPolicy.CLASSである。これは、IDEがコードの解析を行う際に使われる。

そしてそのような注釈はAnnotationProcessorというコンパイラの機能を使って処理することができる。

AnnotationProcessor

アノテーションプロセッサは次のようにして実装できる。

package mypackage;

@SupportedAnnotationTypes("mypackage.MyAnnotation")
@SupportedSourceVersion(SourceVersion.RELEASE_21)
public class MyAnnotationProcessor extends AbstractProcessor {
    @Override
    public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {
        for (Element element : roundEnv.getElementsAnnotatedWith(MyAnnotation.class)) {
            MyAnnotation annotation = element.getAnnotation(MyAnnotation.class);
            System.out.printf("Element %s: %s\n", element.getSimpleName(), annotation.value());
        }
        return true;
    }
}

これは、MyAnnotationという注釈が付与された要素を取得して、その値を表示するプロセッサである。 これを使うには、META-INF/services/javax.annotation.processing.Processorに次のように書く。

mypackage.MyAnnotationProcessor

あるいは、javac-processorオプションで指定することもできる。

javac -processor mypackage.MyAnnotationProcessor Main.java

これによって、コンパイル時に注釈を処理することができる。これを利用した例として検査用フレームワークや、Lombokなどがある。

Lombokのval型は実は注釈であり、プロセッサーからASTを操作してコードを生成している。