[PT선생님][9]자바 javax.lang.model.util.AbstractAnnotationValueVisitor8 알아보기

 

javax.lang.model.util.AbstractAnnotationValueVisitor8 클래스는 Java 언어에서 어노테이션 값(annotation value)을 방문하는(visitor) 클래스를 작성할 때 도움이 되는 추상 클래스입니다. 이 클래스는 JDK 1.8 버전 이후에 추가되었습니다.

AbstractAnnotationValueVisitor8 클래스는 AnnotationValueVisitor8 인터페이스를 구현하고, 모든 방문 메서드에 대한 기본 구현을 제공합니다. 따라서 이 클래스를 상속하면, AnnotationValueVisitor8 인터페이스의 모든 메서드를 오버라이드할 필요가 없습니다. 대신, 필요한 방문 메서드만 오버라이드하면 됩니다.

이 클래스의 구성원은 다음과 같습니다.

- 생성자(Constructor): 이 클래스의 생성자는 protected로 선언되어 있습니다. 즉, 이 클래스를 직접 인스턴스화할 수는 없습니다. 대신, 이 클래스를 상속한 하위 클래스에서 생성자를 호출하여 인스턴스화합니다.

- visit(AnnotationValue av, P p): 이 메서드는 모든 어노테이션 값의 기본 방문 동작을 수행합니다. 만약 어노테이션 값이 null이면, 이 메서드는 null을 반환합니다.

- visit(AnnotationValue av): 이 메서드는 visit(AnnotationValue av, P p) 메서드를 호출하고, 두 번째 매개변수 p에 null을 전달합니다.

- visitBoolean(boolean b, P p): 이 메서드는 boolean 어노테이션 값의 방문 동작을 수행합니다.

- visitByte(byte b, P p): 이 메서드는 byte 어노테이션 값의 방문 동작을 수행합니다.

- visitChar(char c, P p): 이 메서드는 char 어노테이션 값의 방문 동작을 수행합니다.

- visitDouble(double d, P p): 이 메서드는 double 어노테이션 값의 방문 동작을 수행합니다.

- visitEnumConstant(VariableElement c, P p): 이 메서드는 열거형 상수(enum constant) 어노테이션 값의 방문 동작을 수행합니다.

- visitFloat(float f, P p): 이 메서드는 float 어노테이션 값의 방문 동작을 수행합니다.

- visitInt(int i, P p): 이 메서드는 int 어노테이션 값의 방문 동작을 수행합니다.

- visitLong(long i, P p): 이 메서드는 long 어노테이션 값의 방문 동작을 수행합니다.

- visitShort(short s, P p): 이 메서드는 short 어노테이션 값의 방문 동작을 수행합니다.

- visitString(String s, P p): 이 메서드는 String 어노테이션 값의 방문 동작을 수행합니다.

- visitType(TypeMirror t, P p): 이 메서드는 TypeMirror인터페이스 어노테이션 값의 방문 동작을 수행합니다.

- visitArray(List<? extends AnnotationValue> values, P p): 이 메서드는 배열(array) 어노테이션 값의 방문 동작을 수행합니다.

AbstractAnnotationValueVisitor8 클래스를 상속하여 어노테이션 값의 방문 동작을 정의할 때, 원하는 메서드만 오버라이드하고, 필요한 경우 visit(AnnotationValue av, P p) 메서드를 오버라이드하여 모든 어노테이션 값의 기본 방문 동작을 재정의할 수 있습니다.

예를 들어, 다음은 어노테이션 값이 배열인 경우 배열의 각 요소를 출력하는 방문자(visitor) 클래스의 예입니다.

 

import javax.lang.model.element.AnnotationValue;
import javax.lang.model.util.AbstractAnnotationValueVisitor8;

public class ArrayAnnotationValueVisitor extends AbstractAnnotationValueVisitor8<Void, Void> {
    @Override
    public Void visitArray(List<? extends AnnotationValue> values, Void aVoid) {
        for (AnnotationValue value : values) {
            value.accept(this, null);
        }
        return null;
    }
    
    // 다른 visit 메서드들은 구현하지 않음
}

위의 클래스에서 visitArray 메서드만 오버라이드하고, visit 메서드들은 구현하지 않았습니다. 따라서, visit 메서드들은 AbstractAnnotationValueVisitor8 클래스에서 제공하는 기본 구현을 사용하게 됩니다.

이 방문자 클래스를 사용하여 다음과 같이 어노테이션 값이 배열인 어노테이션의 각 요소를 출력할 수 있습니다.

 

import java.lang.annotation.*;

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface MyAnnotation {
    int[] values();
}

public class Main {
    public static void main(String[] args) {
        MyAnnotation annotation = Main.class.getAnnotation(MyAnnotation.class);
        int[] values = annotation.values();
        ArrayAnnotationValueVisitor visitor = new ArrayAnnotationValueVisitor();
        for (int i : values) {
            System.out.println(i);
        }
    }
}

위의 코드에서는 getAnnotation 메서드를 사용하여 Main 클래스에 적용된 MyAnnotation 어노테이션을 가져온 다음, 배열 어노테이션 값의 각 요소를 출력하기 위해 ArrayAnnotationValueVisitor 클래스의 인스턴스를 생성하고 accept 메서드를 호출하였습니다.다음은 AbstractAnnotationValueVisitor8의 예제 코드입니다. 이 예제 코드는 어노테이션 값이 문자열, 숫자, 불리언, 클래스 등 다양한 타입일 때 각각의 어노테이션 값에 대해 방문자(visitor)를 사용하여 처리하는 방법을 보여줍니다.

 

import javax.lang.model.element.AnnotationValue;
import javax.lang.model.util.AbstractAnnotationValueVisitor8;
import java.util.List;

public class MyAnnotationValueVisitor extends AbstractAnnotationValueVisitor8<Void, Void> {

    // 문자열 어노테이션 값 처리
    @Override
    public Void visitString(String s, Void aVoid) {
        System.out.println("String value: " + s);
        return null;
    }

    // 숫자 어노테이션 값 처리
    @Override
    public Void visitInt(int i, Void aVoid) {
        System.out.println("Int value: " + i);
        return null;
    }

    // 불리언 어노테이션 값 처리
    @Override
    public Void visitBoolean(boolean b, Void aVoid) {
        System.out.println("Boolean value: " + b);
        return null;
    }

    // 클래스 어노테이션 값 처리
    @Override
    public Void visitType(javax.lang.model.type.TypeMirror t, Void aVoid) {
        System.out.println("Class value: " + t.toString());
        return null;
    }

    // 배열 어노테이션 값 처리
    @Override
    public Void visitArray(List<? extends AnnotationValue> values, Void aVoid) {
        System.out.println("Array value: ");
        for (AnnotationValue value : values) {
            value.accept(this, null);
        }
        return null;
    }

    // 열거형 상수 어노테이션 값 처리
    @Override
    public Void visitEnumConstant(javax.lang.model.element.VariableElement c, Void aVoid) {
        System.out.println("Enum value: " + c.toString());
        return null;
    }

    // 다른 모든 어노테이션 값 처리
    @Override
    public Void visitUnknown(AnnotationValue av, Void aVoid) {
        System.out.println("Unknown value: " + av.toString());
        return null;
    }
}

위의 코드에서는 visitString, visitInt, visitBoolean, visitType, visitArray, visitEnumConstant, visitUnknown 메서드를 오버라이드하여 각각의 어노테이션 값 타입에 대해 처리하는 방법을 정의하고 있습니다.

이제 이 방문자 클래스를 사용하여 다음과 같이 어노테이션의 값을 처리할 수 있습니다.