Spring MVC 2: Validation과 전역 예외 처리

package cloud.oxxultus.webmvc.dto;

import jakarta.validation.constraints.*;

public class SignUpRequest {

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

    @Email(message = "올바른 이메일 형식이 아닙니다.")
    @NotBlank(message = "이메일은 필수 입력 항목 입니다.")
    private String email;

	// Getter Setter 추가
}

package cloud.oxxultus.webmvc.controller;


import cloud.oxxultus.webmvc.dto.SignUpRequest;
import jakarta.validation.Valid;
import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.*;

@Slf4j
@RestController
public class UserController {

    @PostMapping("/api/signup")
    public String signup(@Valid @RequestBody SignUpRequest request) {

        log.info("컨트롤러 안으로 진입 성공! 이름: {}", request.getName());

        return "회원가입 완료!";
    }
}

@RestController
@Validated // 클래스 위에 이 어노테이션을 붙여줘야 일반 파라미터 검증이 활성화됩니다!
public class SimpleController {

    @GetMapping("/api/user")
    public String getUser(@NotBlank(message = "ID는 필수입니다.") @RequestParam("id") String id) {
        return "조회 성공: " + id;
    }
}

package cloud.oxxultus.webmvc.controller;

import lombok.extern.slf4j.Slf4j;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.FieldError;
import org.springframework.web.bind.*;

import java.util.HashMap;
import java.util.Map;

@Slf4j
// 애플리케이션 전체에서 발생하는 예외를 가로채는 '전역 예외 처리 빈'으로 등록합니다.
@RestControllerAdvice
public class GlobalExceptionHandler {
	
    // @Valid 검증 실패 시 발생하는 'MethodArgumentNotValidException'을 전담 마크합니다.
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<Map<String, String>> handleValidationException(MethodArgumentNotValidException ex) {

        log.warn("데이터 검증 실패 예외 발생!");

        Map<String, String> errors = new HashMap<>();

       	ex.getBindingResult().getAllErrors().forEach(error -> {
       		// 1. 에러가 난 필드명(예: "name")을 찾아내서 강제 형변환
         	String fieldName = ((FieldError) error).getField();

           	// 2. 개발자가 DTO에 적어둔 'message' 문자열을 추출!! (★ 핵심)
           	String errorMessage = error.getDefaultMessage();

           	// 3. 바구니(Map)에 "name" = "이름은 입력 필수 항목입니다." 형태로 저장
           	errors.put(fieldName, errorMessage);
		});

        return ResponseEntity.badRequest().body(errors);
    }
}

package cloud.oxxultus.webmvc.filter;

import jakarta.servlet.*;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Component;

import java.io.IOException;

@Slf4j
@Component
public class MyWebFilter implements Filter {

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {

        log.info("[1. 필터 작동] 톰캣 바로 다음(스프링 입구 전)에서 요청을 감지함 ");

        chain.doFilter(request, response);

        log.info("[1. 필터 종료] 모든 처리가 끝나고 톰캣 나가는 중);

    }
}

package cloud.oxxultus.webmvc.filter;


import jakarta.servlet.http.*;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerInterceptor;

@Slf4j
@Component
public class MyWebInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
            throws Exception{

        log.info("[2. 인터셉터 작동] 디스패처 서블릿 통과 후, 컨트롤러 직전에서 가로챔");

        return true;
    }
}

package cloud.oxxultus.webmvc.config;

import cloud.oxxultus.webmvc.filter.MyWebInterceptor;
import lombok.RequiredArgsConstructor;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.*;

@Configuration
@RequiredArgsConstructor
public class WebConfig implements WebMvcConfigurer {

    private final MyWebInterceptor myWebInterceptor;

    @Override
    public void addInterceptors(InterceptorRegistry registry){
       // "/**"를 적으면 모든 URL 요청에 이 인터셉터를 적용하겠다는 뜻입니다 
       registry.addInterceptor(myWebInterceptor).addPathPatterns("/**");

    }
}