[java] Hibernate Validator를 사용하여 유효성 검사 실패 시 자동으로 오류 메시지를 생성하는 방법은 무엇인가요?

17 Nov 2023

java

먼저, Hibernate Validator를 사용하려면 다음과 같이 의존성을 추가해야 합니다.

<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>6.2.0.Final</version>
</dependency>

이제 유효성 검사를 수행할 객체를 생성하고 아래와 같이 애너테이션을 사용하여 필드를 검증할 수 있습니다.

import javax.validation.constraints.NotBlank;
import javax.validation.constraints.Size;

public class User {

    @NotBlank(message = "이름은 필수 항목입니다.")
    private String name;

    @NotBlank(message = "이메일은 필수 항목입니다.")
    @Email(message = "올바른 이메일 주소를 입력하세요.")
    private String email;

    // Getter and Setter
}

위의 코드에서 @NotBlank와 @Email 애너테이션은 각각 필드가 비어 있지 않고, 유효한 이메일 주소인지 검증합니다. 만약 검증에 실패할 경우, message 속성에 지정한 오류 메시지가 자동으로 생성됩니다.

유효성 검사를 수행하는 코드에서는 Validator 인터페이스를 사용할 수 있습니다. 예를 들어, 아래와 같이 Validator 인터페이스를 사용하여 유효성 검사를 수행하고 오류 메시지를 출력할 수 있습니다.

import javax.validation.Validation;
import javax.validation.Validator;
import javax.validation.ValidatorFactory;
import javax.validation.ConstraintViolation;
import java.util.Set;

public class Main {

    public static void main(String[] args) {
        User user = new User();
        user.setName("");
        user.setEmail("invalid");

        ValidatorFactory factory = Validation.buildDefaultValidatorFactory();
        Validator validator = factory.getValidator();
        Set<ConstraintViolation<User>> violations = validator.validate(user);

        for (ConstraintViolation<User> violation : violations) {
            System.out.println(violation.getMessage());
        }
    }
}

위의 코드에서 validate() 메소드는 유효성 검사를 실행하고, ConstraintViolation 객체를 반환합니다. 이 객체에는 검증 실패한 필드와 해당 오류 메시지가 포함되어 있습니다. 따라서 violation.getMessage()를 호출하여 오류 메시지를 출력할 수 있습니다.

이와 같이 Hibernate Validator를 사용하여 유효성 검사 실패 시 자동으로 오류 메시지를 생성하고 전달할 수 있습니다. 자세한 내용은 Hibernate Validator 공식 문서를 참조하시기 바랍니다.

참고 문서: Hibernate Validator Reference Guide