@AliasFor

 

“어노테이션의 특정 엘리먼트(속성)에 별칭(alias)이 왜 필요하냐?”

그냥 하나의 속성으로 만들면 되지, 왜 굳이 다른 이름으로 같은 걸 연결하는 이유는?

 

✅ 1. 사용자가 익숙한 방식으로 쓰도록 하기 위해 (API 유연성)

예: @RequestMapping

 

Spring에서는 아래 두 가지 방식 모두 허용합니다:

@RequestMapping("/hello")              // value를 생략한 축약형
@RequestMapping(path = "/hello")       // 명시적으로 path 속성 지정

 

그런데 사실 value()와 path()는 같은 뜻입니다. 그래서 Spring에서는 이렇게 선언해놨습니다:

@AliasFor("path")
String value() default "";

@AliasFor("value")
String path() default "";

 

즉, 유저가 value로 쓰든 path로 쓰든 의미는 같다는 걸 표현한 겁니다.

📌 사용자 입장에서 더 자연스러운 방식으로 선택하게 해주는 것, 그것이 별칭의 목적입니다.

 

✅ 2. 상위 애너테이션의 속성과 연결하기 위해

Spring에서는 커스텀 스테레오타입을 만들 때 아래처럼 사용하기도 합니다:

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Component
public @interface MyService {
    String value() default "";
}

 

여기서 value()는 사실 @Component.value와 같은 뜻입니다. 근데 Java 언어 자체는 "이 속성은 다른 애너테이션의 value와 같다"는 걸 표현할 수 없습니다.

그래서 Spring은 @AliasFor를 도입해 이렇게 명시할 수 있게 했습니다:

@AliasFor(annotation = Component.class, attribute = "value")
String value() default "";

 

이렇게 하면 Spring 내부에서 @MyService("myBean") → @Component("myBean")로 간주하고, 정확하게 원하는 이름으로 빈을 등록할 수 있습니다.

 

✅ 3. 명시적 연결로 혼란 방지

public @interface MyAnno {
    String value() default "";
    String name() default "";
}

 

이렇게 만들면 value와 name이 서로 다른 속성이기 때문에,

@MyAnno(value = "hello", name = "world") // ❌ 둘 다 설정했는데 값이 달라! 모순!

 

이런 혼란이 생깁니다.

하지만 @AliasFor로 연결하면 Spring이 확인해줍니다:

• 둘 다 값이 설정되면 동일한 값인지 검증함.
• 하나만 설정하면 다른 쪽에 자동 전달됨.

📌 즉, 의도되지 않은 이중 정의나 충돌을 막는 안전장치 역할을 합니다.

 

🎯 비유: 왜 별칭을 쓰냐?

사람 이름 비유

• 김철수라는 사람에게 사람들이 어떤 사람은 “철수”라고 부르고, 어떤 사람은 “수철이”라고 부른다고 가정합니다.
• 이걸 공식 문서에 "철수는 수철이의 별칭이다"라고 명시하면, 누가 어떤 이름을 쓰든 간에 한 사람을 가리키는 거라는 걸 모두가 알 수 있게 됩니다.

 

🔚 결론 정리

이유	설명
✅ API 유연성	사용자가 익숙한 이름(value 또는 path)을 선택해 쓸 수 있도록
✅ 상위 애너테이션 연결	커스텀 애너테이션이 @Component 등과 의미 연결 가능하게
✅ 혼란 방지	속성이 두 개 있을 때 중복되거나 모순되는 값 설정 막기 위해
✅ 프레임워크 확장성	스프링 같은 복잡한 프레임워크에서 안정적으로 어노테이션 구성 가능