Colin's Blog
[java] JSR 305을 활용한 자바 데이터 유효성 검사

자바 개발자라면 데이터의 유효성을 검사하는 일은 필수적입니다. 유효성 검사를 통해 잘못된 데이터가 애플리케이션으로 진입하는 것을 방지하고, 안정성을 향상시킬 수 있습니다. 이를 위해 JSR 305라는 자바 스펙을 활용할 수 있습니다.

JSR 305이란?

JSR 305는 “Java EE 6 Specification Requests”의 일부인 자바 어노테이션을 활용한 문서화 및 코드 표시 스펙입니다. 이 스펙은 코드에 어노테이션을 추가하여 데이터 유효성 검사와 관련된 정보를 명시적으로 표현할 수 있게 해줍니다.

JSR 305의 주요 어노테이션

JSR 305은 다양한 어노테이션을 제공합니다. 가장 일반적으로 사용되는 어노테이션은 다음과 같습니다:

이 외에도 @ReadOnly, @WriteOnly, @WillClose, @WillNotClose 등의 다양한 어노테이션이 있으며, 상황에 맞게 사용할 수 있습니다.

JSR 305의 활용

JSR 305의 어노테이션을 활용하여 데이터 유효성 검사를 수행할 수 있습니다. 아래는 예시 코드입니다:

public class User {
    private String username;

    public User(@Nonnull String username) {
        this.username = username;
    }

    public void setUsername(@Nonnull String username) {
        this.username = username;
    }

    public void processUserData(@Nullable String data) {
        // 데이터 처리 로직
    }

    @CheckReturnValue
    public boolean isUsernameValid() {
        // 유효성 검사 로직
    }
}

위의 코드에서 @Nonnull 어노테이션은 username 매개변수와 setUsername 메서드의 매개변수가 null이 될 수 없음을 나타냅니다. @Nullable 어노테이션은 processUserData 메서드의 매개변수 data가 null일 수 있다는 것을 의미합니다.

@CheckReturnValue 어노테이션은 isUsernameValid 메서드의 반환값을 반드시 사용해야 함을 표시합니다.

결론

JSR 305을 활용하면 자바 어플리케이션에서 데이터 유효성 검사를 간단하게 수행할 수 있습니다. 이를 통해 코드의 가독성과 안정성을 향상시킬 수 있습니다. 또한, JSR 305을 활용하여 문서화를 추가할 수 있어 다른 개발자들이 코드를 더욱 쉽게 이해하고 사용할 수 있게 됩니다.

더 자세한 내용은 JSR 305 스펙 문서를 참고하세요.

© 2018 Colin. All rights reserved.