참조

• 블로그: https://mangkyu.tistory.com/174

의존성 추가

implementation("org.springframework.boot:spring-boot-starter-validation")

동작 원리

• spring에서는 일종의 어댑터인 LocalValidatorFactoryBean이 제약 조건 검증을 처리하며 이용하기 위해서는 LocalValidatorFactoryBean을 빈으로 등록해야 하는데 의존성만 추가한다면 자동 구성으로 인해 빈으로 등록됨
• 모든 요청은 프론트 컨트롤러인 디스패처 서블릿을 통해 컨트롤러로 전달됨
• 전달 과정에서는 컨트롤러 메서드의 객체를 만들어주는 ArgumentResolver가 동작하는데 @Valid 역시 ArgumentResolver에 의해 처리됨
• 대표적으로는 @RequestBody 의 Json을 ArgumentResolver 구현체인 RequestResponseBodyMethodProcessor가 처리하며 내부에서는 @Valid로 시작하는 어노테이션 있는 경우 검사를 진행함(따라서 @Validxxx 형태의 어노테이션이여도 동작)
• @ModelAttribute를 사용하는 경우 ModelAttributeMethodProcessor에 의해 처리됨
• 검증을 하던 중 요류가 있는 경우 MethodArgumentNotValidException 예외가 발생하며 디스패처 서블릿에 기본으로 등록된 ExceptionResolver인 DefaultHandlerExceptionResolver에 의해 400 BadRequest 에러 발생
• 이러한 동작 원리로 인해 기본적으로 컨트롤러에 의해서만 동작하며 다른 계층에서는 검증되지 않지만 다른 계층에서 파라미터를 검증하기 위해서 @Validated 와 결합해서 사용해야함

@Valid

• JSR-303 format 으로 빈 검증기를 이용해 객체의 제약 조건을 검증하도록 지시하는 어노테이션

• 이후 컨트롤러 메서드에 @Valid를 적용하면 유효성 검증이 진행됨

• 코드 예시

  // DTO Class
  public class AddUserRequest {
  	
  	@Email
  	private final String email;
  	
  	@NotBlank
  	private final String pw;
  	
  	@NotNull
  	private final UserRole userRole;
  	
  	@Min(12)
  	private final int age;
  	
  }
  
  // Controller Class
  @RestController
  @RequestMapping("/api/v1/user")
  public class UserController {
  	@PostMapping
  	public ResponseEntity addUser(@RequestBody @Valid AddUserRequest addUserRequest) {
  		// service 코드
  	}
  }
  

@Validated

• 파라미터 검증은 최대한 컨트롤러 단에서 검증하고 넘겨주는 것이 좋지만 불가피한 경우 생김
• 스프링은 이를 위해 AOP 기반으로 메서드의 요청을 가로채서 유효성을 검증하는 @Validated 제공(JSR 표준이 아니며 Spring에서 제공)
• @Valid와 다른 점은 MethodArgumentNotValidException 예외가 아닌 ConstraintViolocationException 예외가 발생