Effective Java - item 41

들어가며

마커 인터페이스(marker interface)란 아무 메서드도 담고 있지 않고, 단지 자신을 구현하는 클래스가 특정 속성을 가짐을 표시해주는 인터페이스를 말한다. Serializable 인터페이스가 좋은 예시다.

public interface Serializable {
    // 메서드 없음 - 직렬화 가능함을 표시하는 마커
}

마커 인터페이스 vs 마커 애너테이션

마커 인터페이스의 장점

1. 마커 인터페이스는 타입이다

마커 인터페이스는 이를 구현한 클래스의 인스턴스들을 구분하는 타입으로 쓸 수 있다. 반면 마커 애너테이션은 그렇지 않다. 마커 인터페이스는 타입이기 때문에 마커 애너테이션을 사용했다면 런타임에야 발견될 오류를 컴파일타임에 잡을 수 있다.

1. 적용 대상을 더 정밀하게 지정할 수 있다

마커 애너테이션은 @Target(ElementType.TYPE)으로 선언하면 모든 타입에 달 수 있다. 하지만 특정 인터페이스를 구현한 클래스에만 적용하고 싶다면 마커 인터페이스를 사용하면 된다.

// 특정 인터페이스의 하위 타입에만 마킹
public interface MyMarker extends SomeInterface {
    // SomeInterface를 구현한 클래스만 이 마커를 사용 가능
}

마커 애너테이션의 장점

거대한 애너테이션 시스템의 지원을 받는다는 점이다. 애너테이션을 활용하는 프레임워크에서는 마커 애너테이션을 쓰는 쪽이 일관성을 지키는 데 유리하다.

// 스프링 같은 애너테이션 기반 프레임워크
@Component
@Service
@MyMarker  // 일관성 있음
public class MyService {
}

언제 무엇을 사용할까?

• 마커 인터페이스를 사용하는 경우

  이 마킹이 된 객체를 매개변수로 받는 메서드를 작성할 일이 있으면 마커 인터페이스를 써야한다. 그ㄹ야만 컴파일 타임에 오류를 잡을 수 있기 때문이다.

• 마커 애너테이션을 사용하는 경우 클래스와 인터페이스 외의 요소(모듈, 패키지, 필드, 지역변수 등)에 마킹해야 한다면 애너테이션을 쓸 수밖에 없다. 그래야만 일관성 측면에서 좋기 때문이다.

마치며

마커 인터페이스와 마커 애너테이션은 각자의 쓰임새가 있다. 새로 추가하는 메서드 없이 단지 타입 정의가 목적이라면 마커 인터페이스를 선택하자. 클래스나 인터페이스 외의 프로그램 요소에 마킹해야 하거나, 애너테이션을 적극 활용하는 프레임워크의 일부라면 마커 애너테이션이 올바른 선택이다. 적용 대상이 ElementType.TYPE인 마커 애너테이션을 작성하고 있다면, 정말 애너테이션으로 구현하는 게 옳은지, 마커 인터페이스가 낫지는 않을지 곰곰이 생각해보자.