Gửi dữ liệu từ form – @PostMapping và @ModelAttribute chuyên sâu

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 @Valid và các annotation
  • Hiển thị lỗi validation trở lại giao diện
  • Phân biệt rõ @ModelAttribute vớ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ướcServlet/JSPSpring Boot
Lấy tham sốrequest.getParameter()@ModelAttribute tự động binding
Tạo objectTự new và set thủ côngTự động tạo và set thuộc tính
ValidateViết if-else thủ công@Valid + annotation
Hiển thị lỗiTự đưa vào requestTự động binding lỗi vào BindingResult
Giữ lại dữ liệuTự set lại vào requestTự độ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

AnnotationMục đích
@NotNullKhông được null
@NotEmptyKhông được null và độ dài > 0 (với String, Collection)
@NotBlankKhông được null, độ dài > 0 sau khi trim (chỉ String)
@Size(min, max)Giới hạn độ dài
@Min / @MaxGiá trị số tối thiểu/tối đa
@EmailĐịnh dạng email
@Pattern(regexp)Kiểm tra theo regex
@Past / @FutureNgà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:

    • BindingResult phải đứng ngay sau tham số được validate (@Valid object)
    • 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ùngrequest.getParameter()Khai báo từng tham sốBinding vào object
    Số lượng codeNhiều, thủ côngTrung bình, khai báo từng cáiÍt, tự động
    ValidationTự viếtTự viết hoặc kết hợpTích hợp với @Valid
    Giữ lại dữ liệu khi lỗiTự làmTự làmTự động
    Phù hợpForm nhỏ, đơn giảnForm ít trường, cần xử lý đặc biệtForm nhiều trường, chuẩn CRUD

    9. Bài tập thực hành

    1. Form đăng ký khóa học:
      • Tạo class CourseRegistration vớ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
    2. Form đổi mật khẩu:
      • Các trường: oldPassword, newPassword, confirmPassword
      • Validate:
        • Các trường không được trống
        • newPassword min=6
        • confirmPassword phải trùng với newPassword (dùng custom validator)
      • Hiển thị lỗi phù hợp
    3. 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

    • @ModelAttribute tự động binding dữ liệu form vào object
    • @Valid kích hoạt validation dựa trên các annotation trong model
    • BindingResult chứ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

    Comments are closed.