[이펙티브 자바] 아이템 41. 정의하려는 것이 타입이라면 마커 인터페이스를 사용하라

마커 인터페이스 : 아무 메서드도 담고 있지 않고, 자기 자신을 구현하는 클래스가 특정 속성을 가짐을 표시해주는 인터페이스.

// 마크 인터페이스
public interface MarkerInterface {
    // 메서드나 상수를 정의하지 않음
}

// 위의 마크 인터페이스를 구현하는 클래스
public class MyClass implements MarkerInterface {
    // 클래스의 구현
}

 

마커 애너테이션 : 단순히 존재 여부로 정보를 제공하는 애너테이션.

 

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

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

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

 

@Target : 해당 애너테이션이 적용될 수 있는 대상을 지정하는 데 사용. 

• ElementType.TYPE: 클래스, 인터페이스, 열거형 등의 타입
• ElementType.FIELD: 필드
• ElementType.METHOD: 메서드
• ElementType.PARAMETER: 매개변수
• ElementType.CONSTRUCTOR: 생성자
• ... 기타

import java.lang.annotation.*;

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface Entity {
    // 애너테이션의 속성 및 메서드를 정의할 수 있습니다.
}

@Entity
class MyClass {
    // MyClass 클래스에 적용되는 애너테이션입니다.
}

이 코드에서 @Entity는 마커 애너테이션이다. @Target(ElementType.TYPE)으로 설정되어 있으므로 이 애너테이션은 클래스에만 적용된다. 따라서 @Entity 애너테이션이 있는 클래스는 엔티티 클래스임을 나타내는 역할을 한다.

 

 

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

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

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

 

정의하려는 것이 타입일때는 마커 인터페이스를 사용한 예시 : 

// 마커 인터페이스
interface MarkerInterface {
    // 아무 메서드도 정의하지 않음
}

// 마커 인터페이스를 구현한 클래스
class MyClass implements MarkerInterface {
    // MyClass의 구현
}

// 마커 인터페이스를 사용하는 메서드
public void process(Object obj) {
    if (obj instanceof MarkerInterface) {
        // obj가 MarkerInterface를 구현한 객체인 경우에만 처리
        // 해당 객체가 특정한 속성이나 동작을 가지고 있다고 가정
        System.out.println("Processing object...");
    } else {
        System.out.println("Object cannot be processed.");
    }
}

마커 인터페이스는 아무 메서드도 정의하지 않고, 단지 해당 인터페이스를 구현한 클래스가 특정한 속성이나 동작을 가지고 있다는 것을 나타낸다. 이 코드에서 process메서드는 'Object'를 파라미터로 받아 해당 객체가 MarkerInterface를 구현한 경우에만 처리한다는 것을 보여준다. 따라서 MarkerInterface는 타입으로 사용되어 해당 조건을 나타내는 역할을 하고 있다.

 

 

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