출처 - https://github.com/jmxx219/CS-Study (opens in a new tab)

Java Annotation

어노테이션이란

• 어노테이션은 주석이다. 주석처럼 프로그래밍 언어에 영향을 미치지 않고 정보를 제공할 수 있다. 즉, 작동하는(구현된) 코드가 아니라 표시를 해놓은 것이다.
• 어노테이션을 사용하여 프로그램에 필요한 설정 정보를 소스 코드안에 심을 수 있다.

@Test // 이 메서드가 테스트 대상임을 테스트 프로그램에게 알린다.
void method(){
 
        }

등장 배경

• 예전에는 소스 코드에 대한 문서를 따로 관리했고, 소스 코드 변경이 발생할 때마다 관련 문서를 수정해줬어야 했다. 이러한 불편한 점 때문에 소스 코드에 대한 문서를 따로 만들기보다 소스 코드와 문서를 하나의 파일로 관리할 수 있도록 소스 코드에 주석을 함께 작성하여 문서를 관리했다.

• 위 기능을 응용하여 소스 코드 안에 프로그램을 위한 정보를 미리 약속된 형식으로 포함시킨 것이 어노테이션이다. 예전에는 프로그램을 위한 정보를 소스 코드와 분리된 설정 파일(ex: XML)을 따로 관리했었는데, 어노테이션을 사용함으로써 관리를 용이하게 했다.

엘리먼트 규칙

• 어노테이션 내에 선언된 메서드를 엘리먼트라고 한다.

• 각 엘리먼트는 타입과 이름으로 구성되며, 디폴트 값을 가질 수 있다.

  • 타입으로는 기본형, String, enum, annotation, Class 그리고 이들의 배열을 허용한다.
  • 엘리먼트 이름 뒤에는 ()를 붙여야 한다. ()안에 매개변수는 선언할 수 없다.
  • 엘리먼트를 타입 매개변수로 정의할 수 없다. (ex: ArrayList<T> list();)
  • 엘리먼트가 하나 뿐이고, 이름이 value인 경우, 어노테이션을 적용할 때 엘리먼트 이름을 생략하고 값만 적어도 된다.

    • public @interface MyAnnotation {
        String value();
      } 
      @MyAnnotation("Hello World")
        public class MyClass {
      }

• 어노테이션에 값을 전달할 때 런타임 중에 알아내어야 하는 값은 들어갈 수 없다. 컴파일러 수준에서 해석되는 정적인 값만 들어갈 수 있다.

• 엘리먼트에는 예외를 선언할 수 없다. (ex: int count() throws RuntimeException;)

@interface AnnotationElement {
    int count() default 1;
 
    String testBy();
 
    String[] testTools() default {"aaa", "bbb", "ccc"};
 
    EnumType enumType();
}

표준 어노테이션

자바에서 기본적으로 제공해주는 어노테이션이다.

@FunctionalInterface

• 함수형 인터페이스라는 것을 알림
• 함수형 인터페이스는 하나의 추상 메서드만을 가지는 인터페이스 (default 메서드나 static 메서드는 제외)

@FunctionalInterface
public interface SimpleFunctionalInterface {
    void execute();
}
 
public class Test {
    public static void main(String[] args) {
        // 람다 표현식을 사용하여 인터페이스 구현
        SimpleFunctionalInterface sfi = () -> System.out.println("Executing...");
        sfi.execute();
    }
}

메타 어노테이션

어노테이션을 정의하기 위한 어노테이션의 어노테이션이다.

예시: @Target

 
@Documented
@Retention(RetentionPolicy.RUNTIME) // 런타임까지 어노테이션 유지됨
@Target(ElementType.ANNOTATION_TYPE) // 적용 대상은 어노테이션
public @interface Target {
    ElementType[] value();
}
 

Spring Annotation

상기 어노테이션 말고도 스프링에서 사용되는 어노테이션은 엄청나게 많은데, 스프링에서 많은 어노테이션을 사용하는 이유가 뭘까?

어노테이션이 개발된 이유와 동일하다. 스프링 설정을 위한 정보를 소스 코드에 포함시키기 위해서 어노테이션을 사용한다. 또한 어노테이션을 통해 클래스나 메서드의 역할을 바로 알 수 있기 때문에 가독성을 향상시킨다.

Lombok

반복적인 코드 작성을 줄이기 위해서 사용하는 라이브러리이다.

• @Getter, @Setter, @ToString, @EqualsAndHashCode는 필드별로 적용할 수 있다.
• @Getter, @Setter, @ToString, @EqualsAndHashCode등의 Annotation은 클래스 파일을 디컴파일 해보면 실제로 구현된 메서드를 볼 수 있다.
  • User.java 파일에 실제로 구현된 @Getter 클래스의 메서드를 보고 싶으면 User.class 파일을 디컴파일 해보면 된다.

주의점

@AllArgsConstructor와 @RequiredArgsConstructor를 사용할 경우, 같은 타입의 필드의 순서가 바뀌어도 알아차기 어렵다.

@AllArgsConstructor
public class Product {
    private int discountPrice; // 할인 가
    private int price;         // 정가
}

서비스 레이어에서 이렇게 사용하고 있다고 가정해보자

@Service
public class ProductService {
    public void test() {
        new Product(5_000, 10_000);
    }
}

어떠한 이유로 Product 필드 순서를 바꾼다고 가정해보자

@AllArgsConstructor
public class Product {
    private int price;
    private int discountPrice;
}

이렇게 변경되었을 때, 해당 클래스를 생성하는 다른 클래스는 변경을 알아차리기 어렵다. 동일한 문제가 @RequiredArgsConstructor에서도 발생한다.

@Data, @Value, @Builder 어노테이션은 모두 내부적으로 @AllArgsConstructor, @RequiredArgsConstructor 어노테이션을 사용한다.