[java] JSR 305을 활용한 자바 예외 처리의 일관성 유지 전략

29 Nov 2023

자바 애플리케이션을 개발할 때, 예외 처리는 중요한 부분입니다. 예외 처리는 코드의 안정성을 보장하고, 오류 상황에 대한 적절한 대응을 제공합니다. 하지만 많은 개발자가 예외 처리를 하더라도 일관성이 부족하여 코드 가독성과 유지 보수성이 떨어지는 경우가 있습니다.

이러한 문제를 해결하기 위해 JSR 305(Java Specification Request)은 애너테이션을 제공합니다. 이 애너테이션들을 활용하여 예외 처리의 일관성을 유지하고, 코드 품질을 향상시킬 수 있습니다.

@NonNull 애너테이션

@NonNull 애너테이션은 메서드 또는 매개변수에 사용되어, 해당 값이 null이 될 수 없음을 명시합니다. 이렇게 명시하는 것은 호출하는 쪽에서 null을 전달할 경우 컴파일 오류를 발생시킴으로써 예외 처리의 일관성을 유지할 수 있습니다.

public void doSomething(@NonNull String parameter) {
    // 파라미터 사용
}

@Nullable 애너테이션은 값이 null이 될 수 있음을 명시합니다. 이 애너테이션은 메서드의 반환 타입 앞이나 필드 타입 앞에 사용하여 명시적으로 null 반환 가능 여부를 알립니다.

@Nullable
public String getData() {
    // 데이터 반환
    return null;
}

@CheckReturnValue 애너테이션은 메서드가 반환 값을 무시하지 않도록 경고를 발생시킵니다. 이 애너테이션은 메서드나 생성자의 반환 타입 앞에 사용하여 메서드 호출 결과를 처리하는 부분이 누락되지 않도록 안내합니다.

@CheckReturnValue
public String processInput(String input) {
    // 입력 데이터 처리
    return processedInput;
}

@Immutable 애너테이션은 클래스나 필드에 사용되어 해당 객체가 불변임을 명시합니다. 이 애너테이션을 활용하여 예외 처리 개발자가 코드를 안전하게 변경할 수 있고, 다른 개발자가 해당 객체를 변경하지 않도록 경고를 발생시킬 수 있습니다.

@Immutable
public class ImmutableObject {
    // 불변 객체 구현
}

JSR 305 애너테이션은 예외 처리 코드의 일관성 유지와 고품질의 코드를 작성하는 데 도움을 줍니다. 개발자가 애너테이션을 적극 활용하여 예외 처리를 보다 일관성 있고 안정적으로 구현할 수 있도록 노력해야 합니다.