Spring Validation

Spring Validation은 사용자 입력 데이터의 유효성을 검증하는 기능을 제공합니다. 애플리케이션에서 잘못된 데이터가 처리되는 것을 방지하고, 데이터의 무결성을 보장하는데 도움을 줍니다.

주요 특징

•

Bean Validation API를 사용한 쉬운 유효성 검증

•

다양한 내장 검증 어노테이션 제공

•

커스텀 검증 로직 구현 가능

•

컨트롤러에서 자동 검증 처리

•

오류 메시지 커스터마이징 지원

이 강의에서는 Spring과 MyBatis를 이용하여 user 테이블 기반 회원가입 기능을 구현하고, Validation을 적용하는 방법을 학습합니다.

Validation 주요 어노테이션

어노테이션	설명
@NotNull	null 값 불허
@NotBlank	null, 빈 문자열, 공백만으로 이루어진 문자열 불허
@Size	문자열, 배열의 길이 검증 (min, max 속성)
@Email	이메일 형식 검증
@Past	과거 날짜만 허용
@Future	미래 날짜만 허용
@Valid	중첩된 객체의 유효성 검사 실행

BidingResult 주요 메소드

메소드	설명
hasErrors()	어떤 종류든 오류가 있는지 확인
hasGlobalErrors()	객체 레벨의 오류가 있는지 확인
hasFieldErrors()	필드 레벨의 오류가 있는지 확인
getFieldError()	특정 필드의 첫 번째 오류 메시지 반환
getAllErrors()	모든 오류 목록 반환

DB 테이블 정의

CREATE TABLE `user` (
    `no`            INT             AUTO_INCREMENT PRIMARY KEY,
    `id`            VARCHAR(64)     UNIQUE,
    `username`      VARCHAR(100)    UNIQUE,
    `password`      VARCHAR(100)    NOT NULL,
    `name`          VARCHAR(100)    NOT NULL,
    `email`         VARCHAR(100)    NOT NULL,
    `created_at`    TIMESTAMP       DEFAULT CURRENT_TIMESTAMP,
    `updated_at`    TIMESTAMP       DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);
SQL
복사

DTO + Validation 어노테이션

어노테이션	설명
@NotBlank	null 및 공백 불허
@Size	길이 제약 설정
@Email	이메일 형식 검증

User.java

import jakarta.validation.constraints.Email;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Size;

import java.util.Date;

public class User {

    private Integer no;

    @Size(min = 4, max = 64, message = "아이디는 4자 이상 64자 이하로 입력하세요.")
    private String id;

    @NotBlank(message = "아이디는 필수입니다.")
    private String username;

    @NotBlank(message = "비밀번호는 필수입니다.")
    private String password;

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

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

    private Date createdAt;
    private Date updatedAt;

}
Java
복사

Controller + Validation

UserController.java

@Controller
public class UserController {

    @Autowired
    private UserService userService;

    @GetMapping("/join")
    public String joinForm(Model model) {
        model.addAttribute("User", new User());
        return "join";
    }

    @PostMapping("/join")
    public String join(@Validated @ModelAttribute("User") User User,
                         BindingResult bindingResult) {

        if (bindingResult.hasErrors()) {
            return "join";
        }

        userService.registerUser(User);
        return "redirect:/login";
    }
}
Java
복사

BindingResult 동작 구조

Spring의 Validation 처리 과정에서 BindingResult는 다음과 같은 순서로 동작합니다:

유효성 검사 실행: @Validated 어노테이션이 붙은 객체에 대해 검증 실행

오류 수집: BindingResult 객체가 검증 과정에서 발생한 모든 오류 정보를 수집

•

필드 오류 (Field Errors)

•

글로벌 오류 (Global Errors)

오류 처리: bindingResult.hasErrors()로 오류 존재 여부 확인

•

true 반환 시 폼 페이지로 다시 이동

•

오류 메시지는 자동으로 Model에 포함되어 뷰로 전달

예시 코드 동작:

// 1. 폼에서 데이터 제출
// 2. @Validated로 검증 실행
// 3. BindingResult에 오류 정보 저장
if (bindingResult.hasErrors()) {
    // 4. 오류 발생 시 폼 페이지로 리턴
    // - 오류 메시지가 자동으로 뷰로 전달됨
    // - form:errors 태그를 통해 오류 표시
    return "join";
}
// 5. 검증 통과 시 정상 처리
Java
복사

JSP에서의 오류 표시:

<form:errors path="username" cssClass="error" />
<!-- username 필드에 오류가 있을 경우 메시지 표시 -->
HTML
복사

BindingResult는 반드시 @Validated 어노테이션이 붙은 파라미터 바로 다음에 위치해야 합니다. 순서가 다를 경우 정상적으로 동작하지 않습니다.

BindingResult의 에러 메시지 처리 과정

BindingResult가 폼에 에러 메시지를 전달하는 과정은 다음과 같습니다:

에러 감지: Validation 어노테이션 검증 실패 시 에러 정보가 생성됨

에러 저장: BindingResult 객체에 에러 정보 자동 저장

•

필드 에러: FieldError 객체로 저장

•

글로벌 에러: ObjectError 객체로 저장

Model 전달: Spring MVC가 자동으로 BindingResult를 Model에 추가

•

별도의 model.addAttribute() 불필요

•

뷰에서 자동으로 접근 가능

JSP 출력: form:errors 태그가 해당 에러 메시지 표시

•

필드별 에러: <form:errors path="필드명" />

•

글로벌 에러: <form:errors path="*" />

// 예시: 컨트롤러에서의 처리
@PostMapping("/join")
public String join(@Validated User user, BindingResult bindingResult) {
    if (bindingResult.hasErrors()) {
        // 자동으로 에러 정보가 뷰로 전달됨
        return "join";
    }
    // 검증 통과시 처리
}
Java
복사

JSP에서는 다음과 같이 에러 메시지를 표시할 수 있습니다:

<form:form modelAttribute="user">
    <form:input path="username" />
    <form:errors path="username" cssClass="error" />
    
    <!-- 모든 글로벌 에러 표시 -->
    <form:errors path="*" cssClass="error" />
</form:form>
HTML
복사

form:errors와 FieldError의 관계

form:errors 태그는 BindingResult에 저장된 FieldError 객체로부터 오류 메시지를 가져와 표시합니다. 이 과정은 다음과 같습니다:

FieldError 생성: 검증 실패 시 Spring이 자동으로 FieldError 객체 생성

•

필드명

•

거절된 값

•

에러 메시지

메시지 검색: form:errors 태그가 BindingResult에서 해당 필드의 FieldError를 찾음

메시지 출력: FieldError에서 설정된 메시지를 화면에 표시

예시 코드:

// 컨트롤러에서 FieldError 확인
if (bindingResult.hasFieldErrors("username")) {
    FieldError error = bindingResult.getFieldError("username");
    String message = error.getDefaultMessage(); // @NotBlank 등에서 설정한 메시지
}
Java
복사

JSP에서는 간단히 다음과 같이 사용:

<form:errors path="username" /> <!-- username 필드의 모든 에러 메시지 표시 -->
HTML
복사

MyBatis Mapper 설정

UserMapper.xml

<insert id="insertUser" parameterType="com.aloha.spring.dto.User">
    INSERT INTO user (id, username, password, name, email)
    VALUES (#{id}, #{username}, #{password}, #{name}, #{email})
</insert>
XML
복사

UserMapper.java

@Mapper
public interface UserMapper {
    void insertUser(User User);
}
Java
복사

Service

•

UserService.java

•

UserServiceImpl.java

UserService.java

@Service
public interface UserService {

   
}
Java
복사

UserServiceImpl.java

@Service
public class UserServiceImpl implements UserService {

   
}
Java
복사

JSP 폼 구성 (spring form 태그)

join.jsp

<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %>

<h2>회원가입</h2>
<form:form modelAttribute="User" method="post" action="/join">
    아이디: <form:input path="id" />
    <form:errors path="id" cssClass="error" /><br/>

    사용자명: <form:input path="username" />
    <form:errors path="username" cssClass="error" /><br/>

    비밀번호: <form:password path="password" />
    <form:errors path="password" cssClass="error" /><br/>

    이름: <form:input path="name" />
    <form:errors path="name" cssClass="error" /><br/>

    이메일: <form:input path="email" />
    <form:errors path="email" cssClass="error" /><br/>

    <button type="submit">회원가입</button>
</form:form>
HTML
복사

<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %>

위의 디렉티브 태그를 명시해야 Spring Form 태그를 사용할 수 있습니다.

이 디렉티브가 없으면 다음과 같은 문제가 발생합니다:

•

form:form, form:input 등의 태그를 인식하지 못함

•

컴파일 에러 발생

•

페이지 렌더링 실패

Spring Form 태그 라이브러리는 다음과 같은 이점을 제공합니다:

•

모델 객체와 자동 바인딩

•

유효성 검사 오류 메시지 표시 기능

•

HTML 폼 요소들을 더 쉽게 처리

•

Spring의 데이터 바인딩 기능과 완벽한 통합

핵심 정리

요소	설명
DTO	입력 데이터 구조 정의 및 유효성 검사 설정
Controller	@Validated, BindingResult로 입력 검증 처리
Service	비즈니스 로직 처리
MyBatis	DB 저장 처리
JSP	spring form 태그로 입력 및 오류 표시