Mục tiêu
Sau bài này, bạn sẽ:
- Hiểu cách Spring Boot xử lý form HTML
- Sử dụng thành thạo
@ModelAttributeđể binding dữ liệu form vào object - Thực hiện validation dữ liệu form với
@Validvà các annotation - Hiển thị lỗi validation trở lại giao diện
- Phân biệt rõ
@ModelAttributevới các annotation khác
1. Xử lý form trong Servlet/JSP – Nhìn lại
Trong Servlet/JSP, xử lý form thường như sau:
register.jsp:
<form action="register" method="post">
<input type="text" name="username">
<input type="password" name="password">
<input type="email" name="email">
<input type="submit">
</form>RegisterServlet.java:
protected void doPost(HttpServletRequest request, HttpServletResponse response) {
// 1. Lấy từng tham số
String username = request.getParameter("username");
String password = request.getParameter("password");
String email = request.getParameter("email");
// 2. Tạo object
User user = new User();
user.setUsername(username);
user.setPassword(password);
user.setEmail(email);
// 3. Validate thủ công
List<String> errors = new ArrayList<>();
if (username == null || username.trim().isEmpty()) {
errors.add("Username không được để trống");
}
// ... kiểm tra tiếp
// 4. Nếu có lỗi, forward về form kèm errors
if (!errors.isEmpty()) {
request.setAttribute("errors", errors);
request.setAttribute("user", user);
request.getRequestDispatcher("register.jsp").forward(request, response);
return;
}
// 5. Xử lý tiếp...
}Vấn đề: Rất nhiều code lặp lại, dễ sai sót, khó maintain.
2. Spring Boot xử lý form thế nào?
Spring Boot tự động hóa hầu hết các bước trên:
| Bước | Servlet/JSP | Spring Boot |
|---|---|---|
| Lấy tham số | request.getParameter() | @ModelAttribute tự động binding |
| Tạo object | Tự new và set thủ công | Tự động tạo và set thuộc tính |
| Validate | Viết if-else thủ công | @Valid + annotation |
| Hiển thị lỗi | Tự đưa vào request | Tự động binding lỗi vào BindingResult |
| Giữ lại dữ liệu | Tự set lại vào request | Tự động giữ nhờ Spring MVC |
3. @ModelAttribute – Chi tiết
3.1. Cách hoạt động
Khi bạn dùng @ModelAttribute trong parameter của method:
@PostMapping("/register")
public String register(@ModelAttribute User user) {
// Spring tự động:
// 1. Tạo đối tượng User mới (nếu cần)
// 2. Đọc tất cả request parameters
// 3. Tìm method set tương ứng (setUsername, setEmail,...)
// 4. Gọi các setter đó với giá trị từ form
// 5. Đưa user vào Model (để view có thể dùng)
}3.2. Nguồn dữ liệu của @ModelAttribute
@ModelAttribute có thể lấy dữ liệu từ:
- Request parameters (form data) – mặc định
- Query string (nếu là GET)
- Path variables (nếu kết hợp)
@PostMapping("/users/{userId}/update")
public String update(
@PathVariable Long userId, // Từ URL
@RequestParam String action, // Từ query/form
@ModelAttribute User user) { // Từ form
// user có các thuộc tính được bind từ form
// userId và action là các tham số riêng
}3.3. @ModelAttribute ở method level
Ngoài dùng ở parameter, bạn có thể dùng @ModelAttribute cho method để thêm dữ liệu chung vào model:
@Controller
public class UserController {
@ModelAttribute("countries")
public List<String> populateCountries() {
// Method này chạy TRƯỚC mọi request trong controller
// Kết quả trả về sẽ được thêm vào model với key "countries"
return Arrays.asList("Việt Nam", "USA", "Japan");
}
@GetMapping("/register")
public String showForm() {
// Model đã có "countries" từ method trên
return "register";
}
}Trong form, bạn có thể dùng:
<select name="country">
<option th:each="c : ${countries}" th:value="${c}" th:text="${c}"></option>
</select>4. Validation với Bean Validation (JSR-380)
Spring Boot tích hợp sẵn Hibernate Validator – implementation của Bean Validation.
4.1. Thêm dependency
Nếu dùng Spring Boot 2.3+, bạn cần thêm thủ công:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-validation</artifactId>
</dependency>4.2. Các annotation validation phổ biến
| Annotation | Mục đích |
|---|---|
@NotNull | Không được null |
@NotEmpty | Không được null và độ dài > 0 (với String, Collection) |
@NotBlank | Không được null, độ dài > 0 sau khi trim (chỉ String) |
@Size(min, max) | Giới hạn độ dài |
@Min / @Max | Giá trị số tối thiểu/tối đa |
@Email | Định dạng email |
@Pattern(regexp) | Kiểm tra theo regex |
@Past / @Future | Ngày trong quá khứ/tương lai |
4.3. Sử dụng trong Entity/Model
public class User {
@NotBlank(message = "Tên đăng nhập không được để trống")
@Size(min = 3, max = 20, message = "Tên đăng nhập phải từ 3-20 ký tự")
private String username;
@NotBlank(message = "Mật khẩu không được để trống")
@Size(min = 6, message = "Mật khẩu phải có ít nhất 6 ký tự")
private String password;
@NotBlank(message = "Email không được để trống")
@Email(message = "Email không đúng định dạng")
private String email;
@Min(value = 18, message = "Tuổi phải từ 18 trở lên")
@Max(value = 100, message = "Tuổi không được quá 100")
private Integer age;
// getters, setters
}5. Thực hành: Form đăng ký hoàn chỉnh
Bước 1: Tạo User class với validation
package com.example.demo.model;
import javax.validation.constraints.*;
public class User {
@NotBlank(message = "Username không được để trống")
@Size(min = 3, max = 20, message = "Username phải từ 3-20 ký tự")
private String username;
@NotBlank(message = "Password không được để trống")
@Size(min = 6, message = "Password phải có ít nhất 6 ký tự")
private String password;
@NotBlank(message = "Email không được để trống")
@Email(message = "Email không hợp lệ")
private String email;
@NotNull(message = "Tuổi không được để trống")
@Min(value = 18, message = "Bạn phải đủ 18 tuổi")
@Max(value = 100, message = "Tuổi không hợp lệ")
private Integer age;
// Constructors
public User() {}
public User(String username, String password, String email, Integer age) {
this.username = username;
this.password = password;
this.email = email;
this.age = age;
}
// Getters and Setters
public String getUsername() { return username; }
public void setUsername(String username) { this.username = username; }
public String getPassword() { return password; }
public void setPassword(String password) { this.password = password; }
public String getEmail() { return email; }
public void setEmail(String email) { this.email = email; }
public Integer getAge() { return age; }
public void setAge(Integer age) { this.age = age; }
}Bước 2: Tạo Controller
package com.example.demo.controller;
import com.example.demo.model.User;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.validation.BindingResult;
import org.springframework.web.bind.annotation.*;
import javax.validation.Valid;
import java.util.Arrays;
import java.util.List;
@Controller
public class UserController {
// Thêm dữ liệu chung cho mọi form
@ModelAttribute("countries")
public List<String> countries() {
return Arrays.asList("Việt Nam", "USA", "Japan", "Korea", "Singapore");
}
// Hiển thị form đăng ký
@GetMapping("/register")
public String showRegisterForm(Model model) {
model.addAttribute("user", new User());
return "register";
}
// Xử lý submit form
@PostMapping("/register")
public String processRegister(
@Valid @ModelAttribute User user,
BindingResult bindingResult,
Model model) {
// Kiểm tra lỗi validation
if (bindingResult.hasErrors()) {
// Nếu có lỗi, quay lại form
// User vẫn được giữ lại cùng với lỗi
return "register";
}
// Nếu không lỗi, xử lý đăng ký (giả lập)
model.addAttribute("message", "Đăng ký thành công cho user: " + user.getUsername());
return "success";
}
}Bước 3: Tạo view register.html (Thymeleaf)
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>Đăng ký tài khoản</title>
<style>
.error { color: red; font-size: 0.9em; }
.form-group { margin-bottom: 15px; }
label { display: inline-block; width: 100px; }
</style>
</head>
<body>
<h2>Đăng ký tài khoản</h2>
<form th:action="@{/register}" th:object="${user}" method="post">
<!-- Username field -->
<div class="form-group">
<label>Username:</label>
<input type="text" th:field="*{username}" />
<span class="error" th:if="${#fields.hasErrors('username')}"
th:errors="*{username}">Lỗi username</span>
</div>
<!-- Password field -->
<div class="form-group">
<label>Password:</label>
<input type="password" th:field="*{password}" />
<span class="error" th:if="${#fields.hasErrors('password')}"
th:errors="*{password}">Lỗi password</span>
</div>
<!-- Email field -->
<div class="form-group">
<label>Email:</label>
<input type="email" th:field="*{email}" />
<span class="error" th:if="${#fields.hasErrors('email')}"
th:errors="*{email}">Lỗi email</span>
</div>
<!-- Age field -->
<div class="form-group">
<label>Tuổi:</label>
<input type="number" th:field="*{age}" />
<span class="error" th:if="${#fields.hasErrors('age')}"
th:errors="*{age}">Lỗi tuổi</span>
</div>
<!-- Country dropdown từ @ModelAttribute method -->
<div class="form-group">
<label>Quốc gia:</label>
<select name="country">
<option th:each="c : ${countries}"
th:value="${c}"
th:text="${c}"></option>
</select>
</div>
<button type="submit">Đăng ký</button>
</form>
</body>
</html>Bước 4: Tạo view success.html
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>Thành công</title>
</head>
<body>
<h2 th:text="${message}">Thông báo</h2>
<a href="/register">Quay lại đăng ký</a>
</body>
</html>Bước 5: Chạy và kiểm tra
GET /register: Hiển thị form- Submit form với dữ liệu lỗi: form hiện lại, các trường vẫn giữ giá trị, có thông báo lỗi
- Submit hợp lệ: chuyển sang trang success
6. Giải thích chi tiết BindingResult
@PostMapping("/register")
public String processRegister(
@Valid @ModelAttribute User user, // 1. Validate object
BindingResult bindingResult, // 2. Kết quả validation (phải đứng ngay sau @Valid)
Model model) {
if (bindingResult.hasErrors()) {
// 3. Nếu lỗi, trả về tên view
// Spring tự động giữ user và errors trong model
return "register";
}
// Xử lý thành công...
}Quy tắc quan trọng:
BindingResultphải đứng ngay sau tham số được validate (@Validobject)- Nếu không, Spring sẽ ném exception
- Khi có lỗi, bạn không cần thêm user hay errors vào model – Spring tự làm
7. So sánh các cách nhận dữ liệu form
| Tiêu chí | HttpServletRequest | @RequestParam | @ModelAttribute |
|---|---|---|---|
| Cách dùng | request.getParameter() | Khai báo từng tham số | Binding vào object |
| Số lượng code | Nhiều, thủ công | Trung bình, khai báo từng cái | Ít, tự động |
| Validation | Tự viết | Tự viết hoặc kết hợp | Tích hợp với @Valid |
| Giữ lại dữ liệu khi lỗi | Tự làm | Tự làm | Tự động |
| Phù hợp | Form nhỏ, đơn giản | Form ít trường, cần xử lý đặc biệt | Form nhiều trường, chuẩn CRUD |
9. Bài tập thực hành
- Form đăng ký khóa học:
- Tạo class
CourseRegistrationvới các trường:fullName(NotBlank, min=5)email(Email)phone(tự định nghĩa pattern: 10-11 số)courseId(NotNull)startDate(Future)
- Tạo form HTML với đầy đủ validation
- Hiển thị lỗi chi tiết cho từng trường
- Tạo class
- Form đổi mật khẩu:
- Các trường:
oldPassword,newPassword,confirmPassword - Validate:
- Các trường không được trống
newPasswordmin=6confirmPasswordphải trùng vớinewPassword(dùng custom validator)
- Hiển thị lỗi phù hợp
- Các trường:
- Nâng cao: Form nhiều bước (multi-step form)
- Bước 1: Thông tin cá nhân (username, email)
- Bước 2: Thông tin địa chỉ (address, city)
- Bước 3: Xác nhận
- Dùng
@SessionAttributesđể giữ dữ liệu qua nhiều request
10. Tổng kết
@ModelAttributetự động binding dữ liệu form vào object@Validkích hoạt validation dựa trên các annotation trong modelBindingResultchứa kết quả validation, phải đứng ngay sau@Valid- Khi có lỗi, Spring tự động giữ lại dữ liệu đã nhập và lỗi trong model
- Thymeleaf hỗ trợ hiển thị lỗi qua
#fields.hasErrors()vàth:errors
