Validation

🔍 개요

• **Bean Validation(JSR 380)**은 자바 표준 유효성 검사 프레임워크.
• Spring MVC는 @Valid 또는 @Validated를 통해 이를 컨트롤러 레벨에서 쉽게 적용.
• 입력값 제약 조건을 어노테이션 기반으로 선언하여, 재사용성과 가독성을 높인다.

---

☝🏻 한줄 요약

컨트롤러 메서드 파라미터에 @Valid/@Validated를 붙이고 BindingResult로 결과를 확인하여 유효성 검사를 수행한다.

---

🤔 왜 필요한가?

• 클라이언트 입력값의 형식과 범위를 보장하기 위함
• 잘못된 값으로 인한 비즈니스 로직 오류 예방
• 선언형 제약 조건으로 코드 간결화
• 중복 검사 로직 제거

---

⚙️ 주요 구성 요소

1. 검사 트리거

• @Valid: Bean Validation 표준
• @Validated: Spring 전용, 그룹 검증(Group Validation) 지원

2. 제약 조건 어노테이션

Annotation	설명
@NotNull	null 금지 (빈 문자열은 허용)
@NotEmpty	null 및 길이 0 금지 (컬렉션 포함)
@NotBlank	null, 길이 0, 공백 문자 금지
@Size	문자열/컬렉션 크기 제한
@Length	문자열 길이 제한 (Hibernate Validator)
@Email	이메일 형식 검증
@Pattern	정규식 패턴 일치 검증
@Past / @Future	과거/미래 날짜인지 확인
@Min / @Max	숫자 범위 제한

3. BindingResult / Errors

• 유효성 검사 결과를 담는 객체
• @Valid/@Validated 바로 다음 파라미터로 선언
• 오류 발생 시 컨트롤러에서 직접 처리 가능

---

🔧 예시

(A) 기본 사용

@PostMapping("/users")
public String createUser(
    @Valid @ModelAttribute UserRequest request,
    BindingResult bindingResult
) {
    if (bindingResult.hasErrors()) {
        throw new ValidationFailedException(bindingResult);
    }
    // 로직 수행
    return "redirect:/users";
}

(B) 그룹 검증

public interface OnCreate {}
public interface OnUpdate {}
 
public class UserDto {
    @NotNull(groups = OnUpdate.class)
    private Long id;
 
    @NotBlank(groups = {OnCreate.class, OnUpdate.class})
    private String name;
}
 
@PostMapping("/users")
public String create(@Validated(OnCreate.class) UserDto dto, BindingResult br) { ... }

(C) JSON 요청 바디 검증

@PostMapping("/api/users")
@ResponseBody
public ApiResponse createUser(@Valid @RequestBody UserRequest request) {
    // 유효성 검사 실패 시 MethodArgumentNotValidException 발생
    return ApiResponse.ok();
}

---

⚠️ 주의할 점

• BindingResult를 사용하지 않으면 유효성 실패 시 예외 발생 (MethodArgumentNotValidException)
• JSON 요청 검증 시 @RequestBody와 함께 사용해야 함
• @Valid와 @Validated는 기능이 같지만, 그룹 검증은 @Validated만 지원
• 커스텀 제약 조건은 @Constraint로 정의 가능

---

🔗 관련

• 예외 처리
• Spring MVC 개요
• BindingResult와 Errors 차이
• JSR 380 Bean Validation Spec