[이펙티브 자바] 아이템 27. 비검사 경고를 제거하라

[callmeaxxe]

아이템 27. 비검사 경고를 제거하라.

핵심 정리

Set names = new HashSet(); // 로타입. 비검사 경고가 발생한다

• “비검사 (unchecked) 경고”란?
  • 컴파일러가 타입 안정성을 확인하는데 필요한 정보가 충분치 않을 때 발생시키는 경고.
  • 주로 컬렉션, Optional 등 특정 타입을 담아주는 컨테이너 역할을 하는 클래스에서 발생한다
• 할 수 있는 한 모든 비검사 경고를 제거하라.
• 경고를 제거할 수 없지만 안전하다고 확신한다면 @SuppressWarnings(“unchecked”) 애노테이션을 달아 경고를 숨기자.
• @SuppressWarnings 애너테이션은 항상 가능한 한 좁은 범위에 적용하자.
• @SuppressWarnings(“unchecked”) 애너테이션을 사용할 때면 그 경고를 무시해 도 안전한 이유를 항상 주석으로 남겨야 한다.

    public <T> T[] toArray(T[] a) {
        if (a.length < size) {
            // 이 애노테이션을 왜 여기서 선언했는지..
            @SuppressWarnings("unchecked")
            T[] result = (T[]) Arrays.copyOf(elements, size, a.getClass());
            return result;
        }
        System.arraycopy(elements, 0, a, 0, size);
        if (a.length > size)
            a[size] = null;
        return a;
    }

• @SuppressWarnings("unchecked") 을 사용함으로써 해당 경고에 대해 내가 인지하고 있다는것을 드러내는 역할

[callmeaxxe]

완벽 공략 41. 애너테이션

자바 애너테이션을 정의하는 방법

@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE, MODULE})
@Retention(RetentionPolicy.SOURCE)
public @interface SuppressWarnings {
    String[] value();
}

• @Retention : 애노테이션의 정보를 얼마나 오래 유지할 것인가.

  • Runtime : 가장 scope 가 넓은 범위. 런타임중에도 해당 어노테이션을 쓰겠다는것
  • Class : 컴파일을 하게되면 생성되는 클래스 파일 까지의 scope (런타임중엔 x)
  • Source : 가장 좁은 범위. 바이트코드에서도 어노테이션 정보를 참조할 수 없어 단순 주석처럼 사용하고 싶을때 해당 범위로 지정

• @Target : 애노테이션을 사용할 수 있는 위치.

  • Type : 클래스, 인터페이스 등의 타입
  • Field
  • Method
  • Parameter
  • ...

• @Documented : 어노테이션을 새로 정의한 경우, 해당 어노테이션을 Java doc 에 포함시킬때 사용