Spring Validation

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 );

plugins { id 'java' id 'war' id 'org.springframework.boot' version '3.5.9' id 'io.spring.dependency-management' version '1.1.7' } group = 'com.aloha' version = '0.0.1-SNAPSHOT' description = 'Demo project for Spring Boot' java { toolchain { languageVersion = JavaLanguageVersion.of(23) } } configurations { compileOnly { extendsFrom annotationProcessor } } repositories { mavenCentral() } dependencies { implementation 'org.springframework.boot:spring-boot-starter-thymeleaf' implementation 'org.springframework.boot:spring-boot-starter-validation' implementation 'org.springframework.boot:spring-boot-starter-web' implementation 'org.mybatis.spring.boot:mybatis-spring-boot-starter:3.0.5' compileOnly 'org.projectlombok:lombok' developmentOnly 'org.springframework.boot:spring-boot-devtools' runtimeOnly 'com.mysql:mysql-connector-j' annotationProcessor 'org.projectlombok:lombok' providedRuntime 'org.springframework.boot:spring-boot-starter-tomcat' testImplementation 'org.springframework.boot:spring-boot-starter-test' testImplementation 'org.mybatis.spring.boot:mybatis-spring-boot-starter-test:3.0.5' testRuntimeOnly 'org.junit.platform:junit-platform-launcher' } tasks.named('test') { useJUnitPlatform() }

@Data public class Users { private Integer no; @Size(min = 4, max = 64, message = "아이디는 4자 이상 64자 이하로 입력하세요.") private String id; @NotBlank(message = "아이디는 필수입니다.") @Pattern( regexp = "^[A-Za-z0-9]{6,20}$", message = "아이디는 영문과 숫자만 가능하며 6~20자 이내로 작성해야합니다." ) private String username; @NotBlank(message = "비밀번호는 필수입니다.") @Pattern( regexp = "^(?=.*[A-Za-z])(?=.*\\d)(?=.*[@$!%*?&])[A-Za-z\\d@$!%*?&]{8,}$", message = "비밀번호는 8자 이상이며, 영문, 숫자, 특수문자를 포함해야합니다." ) private String password; @NotBlank(message = "이름은 필수입니다.") @Size(min = 2, max = 10, message = "이름은 2~10글자 이내로 작성해야합니다.") private String name; @Email(message = "이메일 형식이 아닙니다.") @NotBlank(message = "이메일은 필수입니다.") private String email; private Date createdAt; private Date updatedAt; }

@Slf4j @Controller @RequiredArgsConstructor public class UserController { private final UserService userService; /** * 회원가입 화면 * @param model * @param user * @return */ @GetMapping("/signup") public String signup(Model model, Users user) { return "signup"; } /** * 회원가입 처리 * @param user * @param bindingResult * @return * @throws Exception * ⭐ @Validated : 지정한 객체에 대해서 유효성 검사 실행 * ⭐ BindingResult : 유효성 검사에서 발생한 에러 결과를 담은 객체 */ @PostMapping("/signup") public String signup( @Validated @ModelAttribute("user") Users user, BindingResult bindingResult ) throws Exception { // 유효성 검증 에러 발생하면 ➡ 다시 회원가입 화면으로 if( bindingResult.hasErrors() ) { return "signup"; } // 유효성 검증 성공하면, 회원가입 처리 후 메인화면으로 boolean result = userService.insert(user); log.info("회원가입 성공 여부 : " + result); return "redirect:/"; } }

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

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

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

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

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

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

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> <!-- namespace="매퍼 인터페이스 경로" --> <mapper namespace="com.aloha.validation.mapper.UserMapper"> <insert id="insert"> INSERT INTO user( id, username, password, name, email ) VALUES ( #{id}, #{username}, #{password}, #{name}, #{email} ) </insert> </mapper>

@Mapper public interface UserMapper { // 회원 등록 int insert(Users user) throws Exception; }

public interface UserService { boolean insert(Users user) throws Exception; }

@Service @RequiredArgsConstructor public class UserServiceImpl implements UserService { private final UserMapper userMapper; @Override public boolean insert(Users user) throws Exception { int result = userMapper.insert(user); return result > 0; } }

<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>회원가입</title> </head> <body> <h2>회원가입</h2> <form th:action="@{/signup}" th:object="${user}" method="post"> <div> 아이디 : <input type="text" th:field="*{username}"> <span th:errors="*{username}" class="error"></span> </div> <div> 비밀번호 : <input type="password" th:field="*{password}"> <span th:errors="*{password}" class="error"></span> </div> <div> 이름 : <input type="text" th:field="*{name}"> <span th:errors="*{name}" class="error"></span> </div> <div> 이메일 : <input type="email" th:field="*{email}"> <span th:errors="*{email}" class="error"></span> </div> <button type="submit">회원가입</button> </form> </body> </html>