Spring / Thymeleaf 폼(Form) 정리 - Spring MVC 연동

Thymeleaf 폼이란

 

- Thymeleaf 폼은 HTML form 태그를 Spring MVC의 객체(Model)과 직접 바인딩하기 위한 기능이다.

- 입력값을 DTO(Form 객체)에 자동으로 매핑하고, 검증 결과 및 에러 메시지까지 쉽게 처리할 수 있다.

 

핵심 키워드

 

- th:object

- th:field

- @ModelAttribute

 

// Form 객체 (DTO) 예제
 
public class MemberForm {
    private String name;
    private Integer age;
 
    // getter, setter
}
 
// Entity를 직접 사용하면 안된다. -> 항상 Form 전용 DTO를 사용해야 한다. (보안, 책임 분리 문제)
 
// Controller에서 폼 생성 (GET)
 
@GetMapping("/members/new")
public String form(@ModelAttribute("form") MemberForm form){
    return "members/form";
}
 
// 1. MemberForm 객체 자동 생성
// 2. Model에 "form" 이름으로 등록
// 3. View에서 ${form} 사용 가능
 
// Thymeleaf 폼 기본 문법
 
// th:object
 
<form th:object="${form}" method="post">
 
// 이 폼이 어떤 객체와 연결되는지 지정
// 이후 필드들은 객체 기준으로 동작
 
// th:field
 
<input type="text" th:field="*{name}">
<input type="number" th:field="*{age}">
 
// 실제로 변환되는 HTML
 
<input type="text" name="name" value="">
<input type="number" name="age" value="">
 
// th:field 하나로 name, value, id를 자동 생성
 
// POST 요청 처리
 
@PostMapping("/members")
public String save(@ModelAttribute("form") MemberForm form) {
    System.out.println(form.getName());
    System.out.println(form.getAge());
    return "result";
}
 
// 검증(Validation)과 폼
 
@PostMapping("/members")
public String save(@Valid @ModelAttribute("form") MemberForm form, BindingResult result){
    
    if(result.hasErrors()){
        return "members/form";
    }
 
return "redirect:/"
}