reflection과 annotation은 무엇에 사용됩니까?

Question

Accepted Answer

**Reflection**은 프로그램이 **런타임에 클래스, 메서드, 필드를 검사하고 조작**하게 합니다 — 컴파일 시점에 알려지지 않은 것들조차도요. **Annotation**은 도구와 프레임워크가 (흔히 reflection을 통해) 읽어 동작을 구동하는 메타데이터를 코드에 부착합니다. 이들이 함께 Java 프레임워크의 "마법"(Spring, JPA, JUnit) 대부분을 뒷받침합니다.

## Reflection — 런타임 검사와 호출

```java
// 컴파일 시점에 알지 못해도 런타임에 클래스의 구조를 검사
Class<?> clazz = Class.forName("com.example.User");

for (Field field : clazz.getDeclaredFields()) {
    System.out.println(field.getName() + ": " + field.getType());
}
for (Method method : clazz.getDeclaredMethods()) {
    System.out.println(method.getName());
}

// 인스턴스를 생성하고 메서드를 동적으로 호출
Object instance = clazz.getDeclaredConstructor().newInstance();
Method m = clazz.getMethod("setName", String.class);
m.invoke(instance, "Ann");        // setName("Ann") 을 reflection 으로 호출

// private 멤버에도 접근 가능 (프레임워크가 DI 에 이를 사용)
Field f = clazz.getDeclaredField("secret");
f.setAccessible(true);             // private 접근을 우회
```

Reflection은 코드가 타입을 동적으로 발견하고 사용하게 합니다 — 이름으로 클래스 인스턴스화, 필드 읽기/설정, 메서드 호출 — 이것이 프레임워크가 *여러분의* 클래스를 미리 알지 못한 채 다루는 방법입니다.

## Annotation — 도구/프레임워크를 위한 메타데이터

```java
// 내장 및 프레임워크 annotation 이 메타데이터를 부착
@Override               // 컴파일러 검사
@Deprecated             // 구식 API 표시
@Entity                 // JPA: 이 클래스는 DB 테이블에 매핑됨
@Autowired              // Spring: 여기에 의존성을 주입
@Test                   // JUnit: 이 메서드는 테스트
```

## 커스텀 annotation 정의

```java
@Retention(RetentionPolicy.RUNTIME)   // 런타임에 사용 가능 (reflection 으로 읽을 수 있음)
@Target(ElementType.METHOD)
public @interface Loggable {
    String value() default "";
}

// 사용
class Service {
    @Loggable("audit")
    void process() { ... }
}
```

## 이들이 결합하는 방법: 프레임워크가 reflection 으로 annotation 을 읽는다

```java
// 프레임워크가 메서드를 스캔하고, annotation 을 찾아, 그에 따라 행동
for (Method m : clazz.getDeclaredMethods()) {
    if (m.isAnnotationPresent(Loggable.class)) {
        Loggable l = m.getAnnotation(Loggable.class);
        // 메타데이터에 기반하여 메서드를 감싸기/로깅/가로채기
    }
}
```

이것이 Spring(`@Autowired`, `@Component`), JPA(`@Entity`), JUnit(`@Test`), 검증(`@NotNull`) 뒤의 핵심 메커니즘입니다 — 이들은 reflection을 통해 여러분의 annotation이 붙은 코드를 스캔하고 그에 따라 동작을 연결합니다.

## 트레이드오프

```text
✗ Reflection 은 직접 호출보다 느리고 (런타임 조회), 컴파일 시점 타입 검사를
  우회하며, 캡슐화를 깰 수 있음 (setAccessible) → 신중하게 사용
✓ 하지만 범용 프레임워크, DI, 직렬화, 테스트 도구에 필수적
```

## 왜 중요한가

Reflection과 annotation은 **Java 프레임워크 생태계 뒤의 기계 장치**입니다.

Reflection은 범용적이고 동적인 동작을 가능하게 합니다 — 컴파일 시점 지식 없이 런타임에 클래스를 검사하고 다룸 — 이것이 의존성 주입, ORM(객체를 테이블에 매핑), 직렬화 라이브러리(Jackson이 필드를 읽음), 테스트 프레임워크가 여러분의 임의 클래스에 작동하는 방법입니다.

Annotation은 이 도구들이 (reflection을 통해) 읽어 동작을 구동하는 선언적 메타데이터를 제공하여, 장황한 설정을 간단한 마커(`@Entity`, `@Autowired`, `@Test`)로 대체합니다.

이들을 이해하면 Spring, JPA, JUnit이 그 "마법"을 달성하는 방법이 명확해지고, 자신만의 프레임워크 같은 도구를 만들 수 있으며, 성능/안전성 트레이드오프(더 느림, 타입 검사 우회)를 명확히 하여 적절히 사용할 수 있습니다.

이는 고급이지만 Java 생태계에서 깊이 일하기 위한 필수 지식입니다.