item 41 leekyunghee - JAVA-JIKIMI/EFFECTIVE-JAVA3 GitHub Wiki

정의하려는 것이 타입이라면 마커 인터페이스를 사용하라

• 마커 인터페이스란?

아무런 메서드도 담고있지 않고 단지 자신을 구현하는 클래스가 특정 속성을 가짐을 표시해주는 인터페이스를 말한다.

• Serializable 인터페이스(12장) 가 좋은 예이다.
• Serializable은 자신을 구현한 클래스의 인스턴스는 ObjectOutputStream을 통해 쓸(wirte)수 있다고 즉 직렬화할 수 있다고 알려준다.

마커 애너테이션보다 마커 인터페이스가 나은 두가지 장점

1. 마커 인터페이스는 이를 구현한 클래스의 인스턴스들을 구분하는 타입으로 쓸 수 있으나 마커 애너테이션은 그렇지 않다.

마커 인터페이스는 어엿한 타입이기 때문에 마커 애너테이션을 사용했다면 런타임에야 발견될 오류를 컴파일타임에 잡을 수 있다.

자바의 직렬화는 Serializable 마커 인터페이스를 보고 그 대상이 직렬화할 수 있는 타입인지를 확인한다.

• 예를 들어 ObjectOutputStream.wirteObject 메서드는 당연히 인수로 받은 객체가 Serializable을 구현했을 거라고 가정한다. 그런데 이 메서드는 Serializable이 아닌 Object객체를 받도록 설계되었다.

즉 직렬화를 할 수 없는 객체를 넘겨도 런타임에야 문제를 확인할 수 있다. 마커 인터페이스를 사용하는 주요 이유가 컴파일타임 오류 검출인데 그 이점을 살리지 못한 것이다.

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

적용 대상(@Target)을 더 정밀하게 지정할 수 있다는 것이다.

적용 대상을 ElementType.Type으로 선안한 애너테이션은 모든 타입(클래스, 인터페이스, 열거 타입, 애너테이션)에 달 수 있다. 부착할 수 있는 타입을 더 세밀하게 제한하지는 못한다는 뜻이다.

마커 애너테이션이 마커 인터페이스보다 나은 점

거대한 애너테이션 시스템의 지원을 받는다.

애너테이션을 적극 활용하는 프레임워크에서는 마커 애너테이션을 쓰는 쪽이 일관성을 지키는 데 유리할 것이다.

적용 예시

어떤 경우 마커 애너테이션을 사용해야 하는가?

클래스와 인터페이스 외의 프로그램 요소 (모듈, 패키지, 필드, 지역변수 등)에 마킹해야할 때 애너테이션을 쓸 수밖에 없다.

• 클래스와 인터페이스만이 인터페이스를 구현하거나 확장할 수 있기 때문이다.

어떤 경우 마커 인터페이스를 사용해야 하는가?

마커를 클래스와 인터페이스에 적용해야 한다면 물어보자. 이 마킹된 객체를 매개변수로 받을 메서드를 작성할 일이 있을까?

• yes: 마커인터페이스 사용. 컴파일 타임에 오류를 잡아낼 수 있다.

• no: 마커애너테이션 사용

핵심 정리

마커 인터페이스와 마커 애너테이션은 각자의 쓰임이 있다. 
새로 추가하는 메서드 없이 단지 타입 정의가 목적이라면 마커 인터페이스를 선택하자. 
- 타입을 정의할 거라면 인터페이스를 쓰라
- 타입을 정의할게 아니라면 인터페이스를 사용하지 말라고한 (아이템 22) 내용의 반대