Đến nội dung chính
notes.vinhnq.com

Tìm kiếm

SpringMid20 phút đọc

Form binding và validation trong Spring MVC

Ôn 19 thẻ
Trong bài này

Cụm bài Spring MVC từ đầu đến cuối: 1. Maven và cấu trúc dự án · 2. DispatcherServlet và view · 3. Form và validation · 4. Form login với Spring Security · 5. Session và remember-me · 6. Upload file · 7. Giỏ hàng và đặt hàng · 8. Phân trang và lọc động

Một trang web render ở server sống nhờ form: tạo user, sửa sản phẩm, đăng ký, đặt hàng. Bài này đi từ lúc trình duyệt gửi chuỗi name=value tới lúc controller nhận một object đã kiểm tra, và trang hiện lỗi đúng dưới ô nhập. Phía REST (lỗi trả về dạng JSON) đã có ở bài xử lý lỗi và validate DTO; ở đây là phía form HTML.

1. Dữ liệu form đi vào object thế nào

Ý chính: trình duyệt chỉ gửi chuỗi. Spring tạo object form, dùng WebDataBinder chép và đổi kiểu từng tham số, ghi lỗi vào BindingResult, rồi mới chạy validation.

Một form có hai request. GET mở form: controller đặt một object rỗng (hoặc dữ liệu cũ) vào Model, view dùng nó để điền các ô. POST gửi form: body là application/x-www-form-urlencoded, ví dụ fullName=Alice&role=USER.

sequenceDiagram
    participant B as Trình duyệt
    participant D as DispatcherServlet
    participant W as WebDataBinder
    participant V as Validator
    participant C as Controller
    B->>D: POST /register (fullName=Al, role=BOSS)
    D->>W: Tạo RegisterForm, chép và đổi kiểu từng tham số
    W-->>D: Lỗi đổi kiểu ghi vào BindingResult
    D->>V: @Valid thì chạy Bean Validation
    V-->>D: Lỗi ràng buộc ghi vào cùng BindingResult
    D->>C: register(form, bindingResult)
    C-->>B: Có lỗi thì render lại form, không thì redirect
  • Tạo object: class có constructor không tham số thì dùng nó rồi gọi setter. Record, hay class chỉ có một constructor public có tham số, thì Spring 6.1+ truyền tham số request thẳng vào constructor (constructor binding).
  • Đổi kiểu: ConversionService đổi "USER" thành Role.USER, "2026-11-18" thành LocalDate (cần @DateTimeFormat), "APPLE,DELL" thành List<String>.
  • Lỗi đổi kiểu: role=BOSS không phải enum hợp lệ, binder ghi lỗi mã typeMismatch cho field role và để field rỗng. Chạy thử: errors=2 [role:typeMismatch, fullName:NotBlank], hai loại lỗi nằm chung một BindingResult.
Mã lỗi, messages.properties và @InitBinder

Mỗi lỗi có một danh sách mã, từ cụ thể tới chung. Lỗi @NotBlank trên form.fullName cho ra:

NotBlank.form.fullName, NotBlank.fullName, NotBlank.java.lang.String, NotBlank

Spring tra messages.properties theo đúng thứ tự đó, mã nào có trước thì dùng. Nhờ vậy có thể viết một thông báo chung NotBlank=Không được để trống và vài thông báo riêng cho field đặc biệt. Trong annotation, message = "{user.phone.invalid}" cũng tra theo khoá.

@InitBinder chỉnh binder cho một controller (hoặc mọi controller nếu đặt trong @ControllerAdvice):

@InitBinder("form")                       // chỉ áp cho model attribute tên "form"
void init(WebDataBinder b) {
    b.registerCustomEditor(String.class, new StringTrimmerEditor(true)); // "  " -> null
}

StringTrimmerEditor(true) cắt khoảng trắng và đổi chuỗi rỗng thành null, để @NotNull và @NotBlank cùng chặn ô bỏ trống, và DB không bị lưu chuỗi " ".

2. Form DTO thay vì bind thẳng entity

Ý chính: binder chép mọi tham số khớp tên field. Bind thẳng entity thì client sửa được cả cột không có trên form (role, passwordHash). Form DTO chỉ chứa field người dùng được phép gửi.

Lỗi này có tên là mass assignment (gán hàng loạt): ứng dụng nhận nguyên object từ request rồi lưu, không lọc field nào. Form HTML không có ô role không có nghĩa là request không có role; ai cũng thêm được bằng DevTools hay curl.

Giáo trình bind thẳng entity User trong mọi lab. Lab của mình dùng RegisterForm (email, họ tên, mật khẩu, nhập lại mật khẩu) và UserForm cho trang admin (họ tên, số điện thoại, vai trò). Test registerIgnoresInjectedRole gửi thêm role=ADMIN khi đăng ký: user tạo ra vẫn là USER, mật khẩu lưu dạng {bcrypt}....

3. Bean Validation: spec và implementation

Ý chính: Jakarta Bean Validation là bộ quy tắc chung (annotation @NotBlank, @Email, API Validator); Hibernate Validator là thư viện cài đặt nó. Thêm spring-boot-starter-validation là đủ.

Giáo trình đặt câu hỏi “dùng Hibernate Validator hay Jakarta Validation, chọn một” và thêm tay hibernate-validator:8.0.1.Final. Cả hai ý đều lệch.

Bảng các annotation hay dùng
Annotation Kiểm gì Ghi chú
@NotNull khác null chuỗi rỗng "" vẫn qua
@NotEmpty khác null, độ dài > 0 " " vẫn qua
@NotBlank có ít nhất một ký tự không phải khoảng trắng dùng cho chuỗi nhập tay
@Size(min, max) độ dài chuỗi, số phần tử collection null coi là hợp lệ
@Email dạng email a@b vẫn qua; kiểm thật bằng email xác nhận
@Pattern(regexp) khớp regex cả chuỗi null coi là hợp lệ
@Min, @Max, @Positive số
@Past, @Future ngày giờ

Hầu hết ràng buộc coi null là hợp lệ, để bạn ghép tự do: @NotBlank @Size(max = 100).

@Valid (của spec) bảo Spring validate tham số đó, và đi sâu vào object con. @Validated (của Spring) làm việc tương tự nhưng nhận group, ví dụ group OnCreate bắt buộc mật khẩu, group OnUpdate thì không.

4. BindingResult và thứ tự tham số

Ý chính: BindingResult gắn với tham số đứng ngay trước nó. Có nó thì Spring để controller tự xử lý lỗi; thiếu hoặc đặt sai chỗ thì Spring ném exception, người dùng nhận trang lỗi 400.

@PostMapping("/register")
String register(@Valid @ModelAttribute("form") RegisterForm form, BindingResult result,
                RedirectAttributes ra) {
    if (result.hasErrors()) return "auth/register";   // render lại: giữ dữ liệu đã nhập + lỗi
    users.save(new AppUser(form.getEmail(), encoder.encode(form.getPassword()),
                           form.getFullName(), Role.USER));
    ra.addFlashAttribute("message", "Đăng ký thành công, mời đăng nhập");
    return "redirect:/login";                         // PRG
}

Khi có lỗi, controller trả lại tên view, không redirect: object form và BindingResult vẫn nằm trong model, nên view điền lại các ô đã nhập và in lỗi. Redirect lúc này sẽ làm mất cả hai.

5. Hiện lỗi trên view

Ý chính: Thymeleaf đọc BindingResult qua th:object, th:field, th:errors và #fields. Lỗi gắn với field thì in dưới ô đó; lỗi mức object (global error) in ở đầu form.

<form th:action="@{/register}" th:object="${form}" method="post">
  <div th:if="${#fields.hasGlobalErrors()}" th:each="e : ${#fields.globalErrors()}" th:text="${e}"></div>

  <input th:field="*{email}" class="form-control" th:errorclass="is-invalid">
  <div class="invalid-feedback" th:errors="*{email}"></div>

  <input type="password" th:field="*{password}" class="form-control" th:errorclass="is-invalid">
  <div class="invalid-feedback" th:errors="*{password}"></div>
  <button>Đăng ký</button>
</form>
  • th:field="*{email}" sinh id, name, value từ object, nên sau khi lỗi ô vẫn giữ giá trị đã nhập. Với ô password, Thymeleaf cố ý không điền lại giá trị.
  • th:errorclass="is-invalid" thêm class của Bootstrap khi field có lỗi; invalid-feedback của Bootstrap chỉ hiện khi đứng sau ô có is-invalid.
  • th:action="@{...}" với method="post" tự chèn ô ẩn _csrf khi có Spring Security. Form tự viết action bằng chuỗi thô sẽ thiếu token và bị 403.
Bản JSP tương đương (form:form, form:errors)

Giáo trình dùng JSP với thư viện thẻ của Spring. Cùng form đó:

<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %>
<form:form action="/register" method="post" modelAttribute="form">
  <form:errors cssClass="alert alert-danger" element="div"/>          <%-- global errors --%>
  <form:input path="email" cssClass="form-control" cssErrorClass="form-control is-invalid"/>
  <form:errors path="email" cssClass="invalid-feedback"/>
  <form:password path="password" cssClass="form-control" cssErrorClass="form-control is-invalid"/>
  <form:errors path="password" cssClass="invalid-feedback"/>
  <button>Đăng ký</button>
</form:form>

Ánh xạ: modelAttribute ↔ th:object, path ↔ th:field, form:errors path ↔ th:errors, cssErrorClass ↔ th:errorclass. <form:form> cũng tự thêm ô _csrf. Cách giáo trình dùng <spring:bind> để lấy trạng thái lỗi rồi tự ghép class chạy được, nhưng cssErrorClass gọn hơn. Vì sao Spring Boot nghiêng về Thymeleaf hơn JSP thì xem phần 2.

6. Custom validator: mức field và mức class

Ý chính: viết một annotation có @Constraint(validatedBy = ...) và một class ConstraintValidator. Đặt trên field để kiểm một giá trị; đặt trên class để so nhiều field với nhau.

Form đăng ký cần hai quy tắc không có sẵn: email chưa được dùng, và hai ô mật khẩu khớp nhau. Test registerShowsFieldAndClassLevelErrors gửi email đã có, họ tên 2 ký tự, mật khẩu ngắn, nhập lại sai: trang trả 200, view auth/register, có lỗi ở cả bốn field, và hiện câu “Email đã được dùng”.

@PasswordsMatch                       // mức class: thấy cả object
public class RegisterForm {
    @NotBlank @Email @UniqueEmail     // mức field: chỉ thấy một chuỗi
    private String email;
    // fullName, password, confirmPassword...
}
  • Mức field (@UniqueEmail): Spring tạo validator như một bean, nên constructor inject được UserRepository.
  • Mức class (@PasswordsMatch): lỗi mặc định là global error. Gọi addPropertyNode("confirmPassword") để gắn lỗi vào ô nhập lại, hiện ngay dưới ô đó.
Code đầy đủ của hai validator
@Target(ElementType.FIELD) @Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = UniqueEmailValidator.class)
public @interface UniqueEmail {
    String message() default "Email đã được dùng";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

public class UniqueEmailValidator implements ConstraintValidator<UniqueEmail, String> {
    private final UserRepository users;
    public UniqueEmailValidator(UserRepository users) { this.users = users; }  // Spring inject
    @Override public boolean isValid(String email, ConstraintValidatorContext ctx) {
        return email == null || !users.existsByEmailIgnoreCase(email);        // null để @NotBlank lo
    }
}

@Target(ElementType.TYPE) @Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = PasswordsMatchValidator.class)
public @interface PasswordsMatch {
    String message() default "Mật khẩu nhập lại không khớp";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

public class PasswordsMatchValidator implements ConstraintValidator<PasswordsMatch, RegisterForm> {
    @Override public boolean isValid(RegisterForm f, ConstraintValidatorContext ctx) {
        if (f.getPassword() == null || f.getPassword().equals(f.getConfirmPassword())) return true;
        ctx.disableDefaultConstraintViolation();                 // bỏ global error mặc định
        ctx.buildConstraintViolationWithTemplate(ctx.getDefaultConstraintMessageTemplate())
           .addPropertyNode("confirmPassword").addConstraintViolation();
        return false;
    }
}

Validator inject repository chỉ chạy được khi do Spring tạo (LocalValidatorFactoryBean). Nếu đặt @UniqueEmail lên entity, Hibernate cũng validate entity trước khi insert, thường bằng validator factory riêng không qua Spring, và constructor cần tham số sẽ hỏng. Giữ loại validator này trên DTO.

7. Độ dài chuỗi: @Size, varchar(255) và kiểu text

Ý chính: Hibernate mặc định tạo cột varchar(255) cho String. Giới hạn trong @Size của form phải khớp với độ dài cột, không thì chuỗi dài lọt qua validation và vỡ ở DB thành lỗi 500.

  • Mô tả sản phẩm dài vài nghìn ký tự: giáo trình dùng @Column(columnDefinition = "MEDIUMTEXT"). Chạy được trên MySQL nhưng gắn chặt code với MySQL (H2 trong test, PostgreSQL đều không có MEDIUMTEXT).
  • Trung lập hơn: @Column(length = 10_000) để Hibernate chọn kiểu theo dialect, hoặc @Lob (lab dùng cách này). Tốt nhất là schema do migration (Flyway) quản lý, entity chỉ mô tả (ORM và JPA).
  • Form DTO đặt @Size(max = 10_000) cùng con số. Hai nơi giữ cùng một hằng số thì sửa một chỗ.

8. Lab: CRUD user trong trang admin

Ý chính: danh sách có phân trang, trang sửa dùng form DTO và kèm upload avatar, cập nhật xong redirect kèm flash message, xoá bằng POST có CSRF.

Đề (viết lại từ giáo trình): trang admin có danh sách user, xem chi tiết, sửa (họ tên, số điện thoại, vai trò, avatar), xoá. Giáo trình làm từng màn bằng JSP, bind entity, xoá qua link GET /admin/user/delete/{id}, cập nhật bằng cách lấy entity rồi chép tay từng field.

Việc Giáo trình Lab
Object nhận form entity User UserForm (không có email, mật khẩu)
Sau khi lưu redirect redirect + flash message
Xoá GET hoặc form không rõ method POST /admin/users/{id}/delete + CSRF
Danh sách findAll() Pageable, 10 dòng/trang
Không tìm thấy null → lỗi 500 NotFoundException → trang 404

Test deleteUserNeedsPostAndAdmin: GET .../delete trả 405, POST thiếu CSRF trả 403, POST có CSRF thì redirect về /admin/users và user biến mất. Test checkoutFormValidated cho thấy record (CheckoutForm) cũng làm form DTO được: thiếu tên người nhận và số điện thoại sai thì render lại cart/checkout với lỗi ở hai field đó.

Lời giải: AdminUserController
@Controller
@RequestMapping("/admin/users")
public class AdminUserController {
    private final UserRepository users; private final FileStorageService storage;
    public AdminUserController(UserRepository users, FileStorageService storage) {
        this.users = users; this.storage = storage;
    }

    @GetMapping
    String list(@PageableDefault(size = 10, sort = "id") Pageable pageable, Model model) {
        model.addAttribute("page", users.findAll(pageable));
        return "admin/users/list";
    }

    @GetMapping("/{id}/edit")
    String edit(@PathVariable Long id, Model model) {
        AppUser u = find(id);
        UserForm f = new UserForm();
        f.setFullName(u.getFullName()); f.setPhone(u.getPhone()); f.setRole(u.getRole());
        model.addAttribute("form", f); model.addAttribute("user", u);
        return "admin/users/edit";
    }

    @PostMapping("/{id}")
    String update(@PathVariable Long id, @Valid @ModelAttribute("form") UserForm form, BindingResult result,
                  @RequestParam(name = "avatar", required = false) MultipartFile avatar,
                  Model model, RedirectAttributes ra) {
        AppUser u = find(id);
        if (result.hasErrors()) { model.addAttribute("user", u); return "admin/users/edit"; }
        u.setFullName(form.getFullName()); u.setPhone(form.getPhone()); u.setRole(form.getRole());
        if (avatar != null && !avatar.isEmpty()) u.setAvatar(storage.store(avatar, "avatar"));
        users.save(u);
        ra.addFlashAttribute("message", "Đã lưu");
        return "redirect:/admin/users";
    }

    @PostMapping("/{id}/delete")
    String delete(@PathVariable Long id, RedirectAttributes ra) {
        users.deleteById(id);
        ra.addFlashAttribute("message", "Đã xoá");
        return "redirect:/admin/users";
    }

    private AppUser find(Long id) {
        return users.findById(id).orElseThrow(() -> new NotFoundException("user " + id));
    }
}

Nút xoá trong danh sách là một form nhỏ, th:action tự chèn CSRF:

<form th:action="@{/admin/users/{id}/delete(id=${u.id})}" method="post"
      onsubmit="return confirm('Xoá user này?')"><button>Xoá</button></form>

Upload avatar trong form này được giải thích ở phần 6.

PRG (Post/Redirect/Get): sau POST thành công, trả redirect: để trình duyệt GET trang mới. Nhấn F5 sau đó chỉ tải lại trang GET, không gửi lại form. Flash attribute là dữ liệu sống qua đúng một lần redirect: Spring giữ nó trong session, đưa vào model của request kế tiếp rồi xoá.

Senior sẽ làm thêm: chuyển logic cập nhật vào service @Transactional (controller chỉ đọc form và chọn view); không cho admin tự hạ quyền chính mình hay xoá admin cuối cùng; xoá mềm (soft delete) thay vì xoá cứng khi user đã có đơn hàng (xoá dữ liệu cũ an toàn); xoá file avatar cũ sau khi commit.

Đã chạy: các test nhắc ở trên (23/23 trong ShopTests), cùng ba thí nghiệm riêng về thứ tự BindingResult, lỗi typeMismatch và setAllowedFields với constructor binding, trên Spring Boot 3.5.9, JDK 21, H2. Chưa chạy: bản JSP, và messages.properties.

Ghi nhớ

  • Kể được các bước từ chuỗi name=value tới object đã validate, và phân biệt lỗi binding với lỗi validation.
  • Giải thích được vì sao form DTO an toàn hơn entity cộng setAllowedFields.
  • Biết BindingResult phải đứng ở đâu và chuyện gì xảy ra nếu thiếu.
  • Viết được validator mức class gắn lỗi vào một field cụ thể.
  • Biết vì sao vẫn cần unique constraint dù đã có @UniqueEmail, và vì sao sau POST phải redirect.

Câu hỏi phỏng vấn

Junior

Bean Validation và Hibernate Validator khác nhau thế nào?

Bean Validation (Jakarta Validation) là spec gồm annotation và API; Hibernate Validator là implementation tham chiếu của spec đó.

Code import jakarta.validation.*; lúc chạy Hibernate Validator làm việc kiểm. Trong Spring Boot, spring-boot-starter-validation mang nó vào với version đã quản lý sẵn.

@NotNull, @NotEmpty và @NotBlank khác nhau ra sao?

@NotNull chỉ cấm null; @NotEmpty cấm thêm chuỗi hoặc collection rỗng; @NotBlank cấm thêm chuỗi chỉ có khoảng trắng.

Ô nhập tay dùng @NotBlank. Ngoài ra @Size, @Pattern, @Email coi null là hợp lệ, nên thường ghép với một ràng buộc “not”.

Vì sao sau khi submit form thành công nên redirect thay vì trả view?

Để F5 không gửi lại POST (đặt hàng hai lần, tạo user hai lần); đó là mẫu Post/Redirect/Get.

Thông báo “đã lưu” truyền qua flash attribute, sống đúng một lần redirect. Khi form có lỗi thì ngược lại: trả view trực tiếp để giữ dữ liệu đã nhập và lỗi.

Mid

Chuyện gì xảy ra nếu bỏ BindingResult khỏi handler có @Valid @ModelAttribute?

Handler không chạy; Spring ném MethodArgumentNotValidException (một loại BindException) và mặc định trả 400.

BindingResult phải đứng ngay sau tham số mà nó thuộc về. Có nó thì controller tự quyết: render lại form với lỗi. Trong REST, thường để exception bay ra và @ControllerAdvice đổi thành JSON lỗi.

Mass assignment là gì và phòng thế nào trong Spring MVC?

Là khi ứng dụng bind mọi tham số request vào object rồi lưu, nên client sửa được field không có trên form như role, id; phòng bằng form DTO chỉ chứa field được phép.

@InitBinder với setAllowedFields là lớp phụ: mình đã thử, nó không chặn tham số đi qua constructor binding (Spring 6.1+). Chép từ DTO sang entity bằng code tường minh, kiểm quyền ở service.

Làm sao viết validator kiểm hai field khớp nhau và hiện lỗi dưới đúng ô?

Viết constraint mức class (@Target(TYPE)), trong isValid tắt violation mặc định và tạo violation mới với addPropertyNode("confirmPassword").

Không gắn property node thì lỗi là global error, chỉ hiện được ở đầu form. Validator mức field không làm được việc này vì chỉ thấy một giá trị.

@Valid và @Validated khác nhau thế nào?

@Valid thuộc spec, validate object và đi sâu vào object con; @Validated của Spring nhận thêm validation group, và đặt trên class để bật method validation.

Ví dụ group: tạo user bắt buộc mật khẩu, sửa user thì không. Nhiều đội tránh group vì khó đọc và tách thành hai DTO riêng cho tạo và sửa.

Senior

Đã có validator kiểm email trùng, có cần unique constraint không?

Có. Validator đọc rồi mới ghi, nên hai request đồng thời cùng thấy “chưa có” và cùng insert; chỉ unique constraint trong DB chặn được.

Bắt DataIntegrityViolationException (hoặc kiểm tên constraint) và đổi thành lỗi field. Validator vẫn hữu ích cho trường hợp thường vì cho thông báo đẹp cùng lúc với lỗi khác. Chuẩn hoá email về chữ thường trước khi so ở cả hai lớp.

Review đoạn: @PostMapping update(@ModelAttribute User user) { repo.save(user); }. Bạn góp ý gì?

Ba vấn đề: mass assignment (client sửa role, id), save là merge nên các cột không có trên form bị ghi null, và không có validation hay kiểm quyền.

Sửa: UserForm với @Valid + BindingResult, id lấy từ path, findById rồi chép từng field trong service @Transactional, kiểm người sửa có quyền với user đó, xong redirect kèm flash message.

Từ vựng tiếng Anh

Term Phát âm Nghĩa Ví dụ câu tiếng Anh dùng trong phỏng vấn
data binding /ˈdeɪ.tə ˈbaɪn.dɪŋ/ chép tham số request vào object “Data binding turns request parameters into a typed form object.”
type mismatch /taɪp ˈmɪs.mætʃ/ sai kiểu khi đổi “A type mismatch is a binding error, not a validation error.”
mass assignment /mæs əˈsaɪn.mənt/ gán hàng loạt field “Binding the entity directly opens the door to mass assignment.”
form object / DTO /fɔːrm ˈɑːb.dʒekt/ object riêng cho form “Each screen gets its own form object with only the editable fields.”
constraint /kənˈstreɪnt/ ràng buộc “I wrote a class-level constraint to compare the two passwords.”
reference implementation /ˈref.ɚ.əns ˌɪm.plə.menˈteɪ.ʃən/ bản cài đặt tham chiếu “Hibernate Validator is the reference implementation of Bean Validation.”
global error /ˈɡloʊ.bəl ˈer.ɚ/ lỗi mức object “Without a property node, the error shows up as a global error.”
Post/Redirect/Get /poʊst ˌriː.dəˈrekt ɡet/ mẫu redirect sau POST “Post/Redirect/Get stops the browser from resubmitting the form on refresh.”
flash attribute /flæʃ ˈæt.rɪ.bjuːt/ dữ liệu sống qua một redirect “The success message travels as a flash attribute.”
upsert /ˈʌp.sɝːt/ insert hoặc update “save() is effectively an upsert: persist when new, merge otherwise.”

Ghi chép dựa trên tài liệu khoá học của Hỏi Dân IT, viết lại và bổ sung theo cách hiểu của mình.