Ngoài API, Spring Boot làm được website tạo HTML phía máy chủ với Thymeleaf. Bài này dùng @Controller, Model và cú pháp Thymeleaf để hiển thị danh sách và form.

50 phútTrung cấp
Bạn sẽ học được
  • @Controller và Model
  • Biểu thức th:text, th:each, th:if
  • Form với th:object, th:field
  • Layout dùng chung

Cơ sở lý thuyết

Kết xuất phía máy chủ (SSR): máy chủ kết hợp dữ liệu với template để tạo HTML hoàn chỉnh gửi về trình duyệt. Spring MVC theo mô hình MVC: controller đưa dữ liệu vào Model (một Map), trả về tên view; ViewResolver tìm tệp template tương ứng; template engine (Thymeleaf) tạo HTML.

  • Thymeleaf dùng natural template: template là HTML hợp lệ, mở trực tiếp bằng trình duyệt vẫn xem được bố cục (giá trị mẫu được thay khi chạy) – thuận tiện cho người thiết kế.
  • Ngôn ngữ biểu thức: ${...} (biến), *{...} (thuộc tính của đối tượng form), @{...} (URL), #{...} (thông điệp đa ngôn ngữ).
  • th:text tự thoát ký tự chống XSS; th:utext in nguyên bản.
  • Binding form: th:object và th:field liên kết ô nhập với thuộc tính đối tượng; lỗi kiểm tra hiển thị bằng th:errors.

Controller và template

@Controller
@RequestMapping("/sinhvien")
class SinhVienWebController {
    private final SinhVienService svc;
    SinhVienWebController(SinhVienService svc) { this.svc = svc; }

    @GetMapping
    String danhSach(Model model) {
        model.addAttribute("ds", svc.tatCa());
        return "sinhvien/danh-sach";    // templates/sinhvien/danh-sach.html
    }
}
<table>
  <tr th:each="sv, st : ${ds}">
    <td th:text="${st.count}">1</td>
    <td th:text="${sv.ten}">Tên</td>
    <td th:text="${#numbers.formatDecimal(sv.diem, 1, 1)}">0.0</td>
    <td th:if="${sv.diem >= 8}">Giỏi</td>
  </tr>
</table>
<form th:action="@{/sinhvien}" th:object="${moi}" method="post">
  <input th:field="*{ten}">
  <span th:errors="*{ten}"></span>
  <button>Lưu</button>
</form>

Ứng dụng thực tế

Bài toán: trang công khai danh sách đề tài nghiên cứu khoa học sinh viên, cần SEO tốt (bot tìm kiếm đọc được nội dung) nên dùng SSR thay vì SPA, có phân trang:

@GetMapping("/de-tai")
String danhSach(@RequestParam(defaultValue = "0") int trang, Model model) {
    Page<DeTai> p = repo.findAll(PageRequest.of(trang, 10, Sort.by("namThucHien").descending()));
    model.addAttribute("trang", p);
    return "de-tai/danh-sach";
}
<article th:each="dt : ${trang.content}">
  <h2 th:text="${dt.ten}">Tên đề tài mẫu</h2>
  <p>Chủ nhiệm: <span th:text="${dt.chuNhiem}">Nguyễn Văn A</span> – năm <span th:text="${dt.namThucHien}">2026</span></p>
</article>
<nav>
  <a th:if="${trang.hasPrevious()}" th:href="@{/de-tai(trang=${trang.number - 1})}">Trang trước</a>
  <a th:if="${trang.hasNext()}" th:href="@{/de-tai(trang=${trang.number + 1})}">Trang sau</a>
</nav>
Mẹo hay

Nếu làm frontend riêng bằng React, Vue, Angular thì chỉ cần REST API, không cần Thymeleaf.

Thực hành
  1. Hiển thị danh sách sinh viên bằng Thymeleaf.
  2. Làm form thêm sinh viên.
  3. Dùng Bootstrap 5 cho giao diện.
Tóm tắt bài học
  • @Controller trả tên template.
  • Model truyền dữ liệu sang giao diện.
  • th:each, th:text, th:field là cú pháp chính.