# 1. Spring MVC (Model-View-Controller) ## 1.1. Giới thiệu về Spring MVC Spring MVC là một framework trong Spring Framework giúp chúng ta xây dựng ứng dụng web dễ dàng hơn. Spring MVC sử dụng mô hình MVC (Model-View-Controller) để phân chia ứng dụng thành 3 phần chính: - **Model**: Là phần dữ liệu của ứng dụng. - **View**: Là phần hiển thị dữ liệu cho người dùng. - **Controller**: Là phần điều khiển và xử lý dữ liệu giữa Model và View. Spring MVC cung cấp các Annotation giúp chúng ta dễ dàng xây dựng ứng dụng web như: `@Controller`, `@RequestMapping`, `@ResponseBody`, `@GetMapping`, `@PostMapping`, `@PutMapping`, `@DeleteMapping`,... > Lưu ý: Trong Controller, chúng ta chỉ sử dụng Annotation `@Controller`, không sử dụng `@RestController` vì `@RestController` chỉ trả về dữ liệu dạng JSON hoặc XML, không phải là trang web. > Nếu trả về 1 trang `HTML` thì phải sử dụng `StringBuilder` để nối các `tag` tạo `HTML` hoặc sử dụng `Thymeleaf` hoặc `JSP`. > Cấu hình cho `JSP` để Java có thể hiểu được `JSP` trong file `application.properties` và thêm dependency `tomcat-embed-jasper` trong file `pom.xml` như sau, và không thêm @ResponseBody trong Controller: ```properties # Thư mục chứa file JSP, mặc định sẽ ở thư mục src/main/resources/META-INF/resources, chỉ cần lấy phần WEB-INF/views/, nơi chứa file JSP spring.mvc.view.prefix=/WEB-INF/views/ # Đuôi file JSP spring.mvc.view.suffix=.jsp ``` ```xml org.apache.tomcat.embed // Thêm dependency này để Java có thể hiểu được JSP tomcat-embed-jasper // Thêm dependency này để Java có thể hiểu được JSP provided // scope provided để không đóng gói vào file WAR khi build ``` ## 1.2. Tạo Controller trong Spring MVC với việc trả về chuỗi HTML Để tạo một Controller trong Spring MVC, chúng ta tạo một class và đánh dấu class đó với Annotation `@Controller`. Trước mỗi method, phải có @ResponseBody để trả về dữ liệu dạng HTML. Ví dụ: >`HelloController.java` ```java package com.example.demo; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; @Controller public class HelloController { @RequestMapping("/hello") @ResponseBody public String hello() { StringBuilder html = new StringBuilder(); html.append(""); html.append(""); html.append(""); html.append("Hello"); html.append(""); html.append(""); html.append("

Hello World!

"); html.append(""); html.append(""); return html.toString(); // Trả về trang web HTML } } ``` ## 1.3. Tạo Controller trong Spring MVC với việc trả về file .JSP Để trả về file `.JSP`, chúng ta cần cấu hình trong file `application.properties` và thêm dependency `tomcat-embed-jasper` trong file `pom.xml`. Đặc biệt trước mỗi phương thức trong Controller, không được thêm `@ResponseBody`. Ví dụ: Tạo file `.JSP` trong thư mục `src/main/resources/META-INF/resources/WEB-INF/views/` với tên `hello.jsp`. >`hello.jsp` ```jsp Hello

Hello World!

``` >`HelloController.java` ```java package com.example.demo; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; @Controller public class HelloController { @RequestMapping("/hello") public String hello() { return "hello"; // Trả về file hello.jsp (= spring.mvc.view.prefix + hello + spring.mvc.view.suffix) } } ``` ### 1.3.1. Tạo file `.jspf` để chia nhỏ file `.jsp` thành các phần nhỏ hơn và include vào file `.jsp` chính, tránh việc lặp lại code. >`header.jspf` ```jsp Hello ``` >`footer.jspf` ```jsp ``` >`hello.jsp` ```jsp <%@ include file="header.jspf" %>

Hello World!

<%@ include file="footer.jspf" %> ``` ## 1.4. Sử dụng @PathVariable để truyền tham số (params) và @RequestParam để truyền tham số (query) trong URL ### 1.4.1. Sử dụng @PathVariable Để truyền tham số vào URL, chúng ta sử dụng `@PathVariable`. Ví dụ: Truyền tham số `name` vào URL và hiển thị ra màn hình. >`HelloController.java` ```java package com.example.demo; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.PathVariable; import org.springframework.web.bind.annotation.RequestMapping; @Controller public class HelloController { @RequestMapping("/hello/{name}") // Khi truy cập vào URL /hello/{name}, thì tham số {name} sẽ được truyền vào phương thức hello. VD: http://localhost:8080/hello/John public String hello(@PathVariable String name) { System.out.println(name); // In ra màn hình giá trị của tham số name return ... } } ``` ### 1.4.2. Sử dụng @RequestParam Để truyền chuỗi truy vấn vào URL, chúng ta sử dụng `@RequestParam`. `@RequestParam` cũng được sử dụng để đọc từ `form data` hoặc `query parameters` từ URL. Ngoài ra `@RequestParam` còn có thể truyền giá trị mặc định cho tham số bằng cách thêm tham số `defaultValue`. Ví dụ: Truyền query `name`, `age` vào URL và hiển thị ra màn hình. >`HelloController.java` ```java package com.example.demo; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestParam; @Controller public class HelloController { @RequestMapping("/hello") // Khi truy cập vào URL /hello?name=John&age=20, thì tham số name và age sẽ được truyền vào phương thức hello public String hello(@RequestParam String name, @RequestParam int age) { System.out.println(name); // In ra màn hình giá trị của tham số name System.out.println(age); // In ra màn hình giá trị của tham số age return ... } } ``` ## 1.5. Sử dụng ModelMap để truyền dữ liệu từ Controller sang View (JSP) Để truyền dữ liệu từ Controller sang View (JSP), chúng ta sử dụng `ModelMap`. `ModelMap` giúp chúng ta truyền dữ liệu từ Controller sang View thông qua các thuộc tính. Ví dụ: Truyền dữ liệu `name` từ Controller sang View (JSP). >`HelloController.java` ```java package com.example.demo; import org.springframework.stereotype.Controller; import org.springframework.ui.ModelMap; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.SessionAttributes; @Controller @SessionAttributes("name") // Lưu trữ attribute name vào Session public class HelloController { @RequestMapping("/hello") public String hello(ModelMap model) { model.addAttribute("name", "John"); // Truyền dữ liệu name sang View với giá trị là John return "hello"; // Trả về file hello.jsp } @RequestMapping("/sub-hello") // redirect sang URL /hello public String subHello(ModelMap model) { String name = (String) model.get("name"); // Lấy dữ liệu name từ View, nếu trước đó đã truy cập vào URL /hello, thì sẽ có dữ liệu name, nếu không sẽ trả về null, do đã lưu vào Session return "redirect:hello"; // redirect sang URL /hello } } ``` >`hello.jsp` ```jsp

Hello ${name}

``` ## 1.6. Sử dụng JSTL (JavaServer Pages Standard Tag Library) trong JSP để hiển thị dữ liệu `JSTL (JavaServer Pages Standard Tag Library)` là một thư viện tag chuẩn của JSP giúp chúng ta thực hiện các thao tác logic, điều kiện, vòng lặp, hiển thị dữ liệu, ...Tương tự như `ejs` trong `Node.js`. Để sử dụng `JSTL`, chúng ta cần làm các bước sau: 1. Thêm dependency `jstl` trong file `pom.xml` (mvnrepository.com). >pom.xml ```xml jakarta.servlet.jsp.jstl jakarta.servlet.jsp.jstl-api org.eclipse.jetty glassfish-jstl 11.0.21 ``` 2. Thêm thẻ `taglib` vào đầu file `.jsp` để sử dụng `JSTL`. `https://docs.oracle.com/javaee/5/jstl/1.1/docs/tlddocs/index.html`. Bắt buộc phải thêm thẻ `taglib` vào đầu file `.jsp` nếu dùng `JSTL`. Vì khi thêm `dependency` `jstl` vào `pom.xml`, thì file `.jsp` bình thường sẽ không được render ra HTML nếu không thêm thẻ `taglib`. `<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>` để sử dụng thư viện `JSTL Core` với thẻ tag ;à ``.Khi sử dụng `JSTL Core`, chúng ta có thể sử dụng các thẻ như: - ``: Thực hiện một câu lệnh if. - ``: Thực hiện một câu lệnh switch-case. - ``: Thực hiện một vòng lặp. - ``: Hiển thị dữ liệu. - ``: Gán giá trị cho biến. - ``: Xóa giá trị của biến. - ``: Import một file. - ``: Chuyển hướng trang. - ``: Tạo URL. - ``: Thêm tham số vào URL. - ``: Bắt lỗi. - ``: Thực hiện một câu lệnh if trong ``. - ``: Thực hiện một câu lệnh else trong ``. - ``: Thực hiện vòng lặp với chuỗi được tách ra từ một chuỗi khác. `<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>` để sử dụng thư viện `JSTL Format` với thẻ tag là ``.Khi sử dụng `JSTL Format`, chúng ta có thể sử dụng các thẻ như: - ``: Định dạng ngày tháng. - ``: Định dạng số. - ``: Định dạng thông điệp. - ``: Chuyển đổi ngày tháng. `<%@ taglib prefix="sql" uri="http://java.sun.com/jsp/jstl/sql" %> ` để sử dụng thư viện `JSTL SQL` với thẻ tag là ``.Khi sử dụng `JSTL SQL`, chúng ta có thể sử dụng các thẻ như: - ``: Thiết lập nguồn dữ liệu. - ``: Thực hiện một câu lệnh truy vấn. - ``: Thực hiện một câu lệnh cập nhật. - ``: Thêm tham số vào câu lệnh truy vấn hoặc cập nhật. `<%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %>` để sử dụng thư viện `JSTL Functions` với thẻ tag là ``.Khi sử dụng `JSTL Functions`, chúng ta có thể sử dụng các thẻ như: - ``: Kiểm tra chuỗi có chứa chuỗi con không. - ``: Kiểm tra chuỗi có chứa chuỗi con không (không phân biệt chữ hoa chữ thường). - ``: Kiểm tra chuỗi kết thúc bằng chuỗi con không. - ``: Escape XML. - ``: Trả về vị trí đầu tiên của chuỗi con trong chuỗi. - ``: Nối các phần tử của một mảng thành một chuỗi. - ``: Trả về độ dài của chuỗi. - ``: Thay thế chuỗi con trong chuỗi. - ``: Tách chuỗi thành mảng. - ``: Kiểm tra chuỗi bắt đầu bằng chuỗi con không. - ``: Trích xuất một phần của chuỗi. - ``: Trích xuất phần sau của chuỗi. - ``: Trích xuất phần trước của chuỗi. - ``: Chuyển đổi chuỗi thành chữ thường.... - ... Ví dụ: Sử dụng `JSTL` để hiển thị dữ liệu từ Controller sang View (JSP) qua ModelMap. >`hello.jsp` ```jsp <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> Hello

Hello ${name}

Welcome ${name}!

``` ## 1.7. Sử dụng Bootstrap và Jquery trong JSP `Bootstrap` và `Jquery` là 2 thư viện phổ biến giúp chúng ta xây dựng giao diện web đẹp và tương tác với người dùng dễ dàng hơn. Để sử dụng `Bootstrap` và `Jquery` trong `JSP`, chúng ta cần thực hiện các bước sau: 1. Thêm dependency `webjars` trong file `pom.xml` (mvnrepository.com). >pom.xml ```xml org.webjars bootstrap 5.3.3 org.webjars jquery 3.7.1 ``` 2. Copy đường dẫn của `Bootstrap` và `Jquery` từ `webjars` vào file `.jsp`. - Sau khi thêm `dependency` `webjars` vào `pom.xml`, chúng ta mở maven dependencies, tìm đến `bootstrap` và `jquery`, copy đường dẫn của `bootstrap` và `jquery` vào file `.jsp`. - Đường dẫn bootstrap css: `/META-INF/resources/webjars/bootstrap/5.3.3/css/bootstrap.min.css` - Đường dẫn bootstrap js: `/META-INF/resources/webjars/bootstrap/5.3.3/js/bootstrap.min.js` - Đường dẫn jquery js: `/META-INF/resources/webjars/jquery/3.7.1/jquery.min.js` 3. Thêm đường dẫn của `Bootstrap` và `Jquery` vào file `.jsp` qua thẻ `link` và `script`. Vì `SpringBoot` hiểu đường dẫn `/META-INF/resources/` nên không cần thêm prefix này vào đường dẫn. >`hello.jsp` ```jsp <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> Hello

Hello ${name}

Welcome ${name}!

``` # 2. Sử dụng CommandLineRunner trong ứng dụng SpringBoot Trong SpringBoot, chúng ta có thể sử dụng `CommandLineRunner` để thực thi một số công việc khi ứng dụng SpringBoot khởi chạy (Khi ứng dụng SpringBoot khởi chạy, `CommandLineRunner` sẽ được thực thi). Để sử dụng `CommandLineRunner`, chúng ta cần: - Tạo một class và implement interface `CommandLineRunner`. - Đánh dấu class với Annotation `@Component` để SpringBoot có thể quét và tạo Bean từ class. - Override phương thức `run` của interface `CommandLineRunner`. Ví dụ: >`AppRunner.java` ```java package com.example.demo; import org.springframework.boot.CommandLineRunner; import org.springframework.stereotype.Component; @Component public class AppRunner implements CommandLineRunner { @Override public void run(String... args) throws Exception { System.out.println("Hello World!"); } } ``` Trong ví dụ trên, khi ứng dụng SpringBoot khởi chạy, phương thức `run` sẽ được thực thi và in ra `Hello World!`. # 3. Logging Sl4fj ## 3.1. Giới thiệu Trong bài viết này, chúng ta sẽ tìm hiểu về thư viện `slf4j` (Simple Logging Facade for Java) để ghi log trong ứng dụng Java. `slf4j` là một facade logging API cho Java. Nó cung cấp một API đơn giản để ghi log trong ứng dụng Java. `slf4j` không phải là một framework logging mà nó chỉ là một facade logging API. Nó cung cấp một API chung cho các framework logging khác như `log4j`, `logback`, `java.util.logging`,... ## 3.2. Cấu hình mức độ log Chúng ta có thể cấu hình `log level` cho ứng dụng thông qua file `application.properties` hoặc `application.yml`. Có 5 mức độ log: - `TRACE`: Mức độ log thấp nhất, dùng để ghi log chi tiết nhất. - `DEBUG`: Mức độ log thấp, dùng để ghi log chi tiết. - `INFO`: Mức độ log thông tin, dùng để ghi log thông tin. - `WARN`: Mức độ log cảnh báo, dùng để ghi log cảnh báo. - `ERROR`: Mức độ log lỗi, dùng để ghi log lỗi. > Nếu chúng ta cấu hình mức độ log là `INFO`, thì tất cả các log ở mức `INFO`, `WARN`, `ERROR` sẽ được ghi log, còn `DEBUG` và `TRACE` sẽ không được ghi log. >VD: `application.properties` ```properties # Logging cho toàn bộ framework Spring logging.level.org.springframework=debug # Cấu hình mức độ log cho ứng dụng (thay org.example.demo bằng package của ứng dụng) logging.level.com.example.demo=info ``` Mặc định nó sẽ lắng nghe logger ở lớp info, để cho nó về lớp trace to nhất thì thay đổi `logging.level.root={loại log}` ở `application.properties` Để log ra ` file ` thì thêm `logging.file={đường dẫn file}` ở `application.properties (classpath:logs/app.log)` Tạo file cấu hình `logback-spring.xml` để `cấu hình logger thay vì cấu hình trong application.properties` (src/main/resources/logback-spring.xml) Các định dạng của logger: - `%d{yyyy-MM-dd HH:mm:ss.SSS}` : thời gian log - `${PID}` : process id - `$-5level` : In ra tất cả các log có level từ trace đến error - `%5p` : loại log (trace, debug, info, warn, error) - `%logger`{36} : tên class log (36 ký tự) - `%t` : thread - `%c` : class - `%M` : method - `%L` : line - `%msg` : message chính - `%n` : xuống dòng - `%ex` : log ra exception - `%X` : log ra các thông tin trong MDC (Mapped Diagnostic Context) dùng để lưu trữ thông tin trong quá trình xử lý request >VD: ```bash %d{yyyy-MM-dd HH:mm:ss.SSS} ${PID:-} $-5level %logger{36} %t %c %M %L %msg %n %ex ``` ## 3.3. Sử dụng `slf4j` trong ứng dụng Java Sau khi cấu hình mức độ log, chúng ta sử dụng `slf4j` trong ứng dụng Java như sau: > `Controller.java` ```java package com.example.demo; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RestController; @RestController public class HelloController { private static final Logger logger = LoggerFactory.getLogger(getClass()); // Khai báo Logger, lấy class hiện tại để ghi log @GetMapping("/hello") public String hello() { logger.info("The log is {}", "hello"); // Ghi log ở mức INFO, log message là "The log is hello" return "Hello World!"; } } ``` # 4. Validation in Spring ## 4.1. Giới thiệu Trong bài viết này, chúng ta sẽ tìm hiểu cách sử dụng `Validation` trong ứng dụng Spring. `Validation` là một cơ chế kiểm tra dữ liệu đầu vào của người dùng. Chúng ta có thể kiểm tra dữ liệu đầu vào của người dùng thông qua `Annotation` hoặc `@Valid`. ## 4.2. Sử dụng `Validation` trong Spring MVC Để sư dụng `Validation` trong Spring MVC, chúng ta cần thực hiện các bước sau: ### 4.2.1. Thêm `dependency` vào `pom.xml` ```xml org.springframework.boot spring-boot-starter-validation ``` ### 4.2.2. Tạo `Command Bean` (Form Backing Object) chứa dữ liệu cần kiểm tra Lúc này sẽ tạo ra một class chứa dữ liệu cần kiểm tra, class này sẽ được gọi là `Command Bean` hoặc `Form Backing Object`. Và sẽ tạo ra 2 ràng buộc (File `.jsp` và `Controller`) để kiểm tra dữ liệu nhập vào. Ví dụ: Thêm các `Annotation` vào trên các thuộc tính của class để kiểm tra: - `@NotNull`: Kiểm tra giá trị không được `null`. - `@NotEmpty`: Kiểm tra giá trị không được `null` và không được rỗng. - `@NotBlank`: Kiểm tra giá trị không được `null`, không được rỗng và không được chứa khoảng trắng. - `@Size`: Kiểm tra kích thước của giá trị. - `@Email`: Kiểm tra giá trị có đúng định dạng email không. - `@Pattern`: Kiểm tra giá trị có đúng định dạng không... - ... >`User.java` ```java package com.example.demo; import javax.validation.constraints.Size; public class User { @Size(min=5, message="Username must be at least 5 characters long") // Kiểm tra username có ít nhất 5 kí tự private String username; private String password; public User(String username, String password) { this.username = username; this.password = password; } 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; } } ``` Thêm `@Valid` và `BindingResult` vào phương thức của `Command Bean` trong `Controller` để kiểm tra dữ liệu: >`UserController.java` ```java package com.example.demo; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.RequestMapping; import jakarta.validation.Valid; import org.springframework.validation.BindingResult; @Controller public class UserController { @RequestMapping(value="user", method=RequestMethod.GET) public String getUserPage(Model model) { User user = new User("admin", "123456"); // Tạo 1 user ngẫu nhiên để truyền vào View, giá trị mặc định model.put("user", user); // Truyền user vào Model để hiển thị lên View return "user"; // Trả về tên của View } @RequestMapping(value="user", method=RequestMethod.POST) public String postUserPage(@Valid User user, BindingResult result, Model model) { if (result.hasErrors()) { // Nếu có lỗi return "user"; // Trả về trang user để hiển thị lỗi } userService.save(user.getUsername()); // Sau khi thực hiện POST, username sẽ được truyền vào đối tượng User, thay vì dùng @RequestParam return "redirect:all-users"; // Redirect đến trang hiển thị tất cả user } } ``` Thêm `taglib form` vào `View` để hiển thị lỗi, thẻ của `taglib` sẽ phải dùng `cssClass` để dùng với `class` trong `CSS`: >`user.jsp` ```jsp <%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %> <%@ page contentType="text/html;charset=UTF-8" language="java" %> User Page

User Page

``` ## 4.3. Sử dụng `Validation` trong Spring Boot RESTful API Để sử dụng `Validation` trong Spring Boot RESTful API, chúng ta cần thực hiện các bước sau: ### 4.3.1. Thêm `dependency` vào `pom.xml` ```xml org.springframework.boot spring-boot-starter-validation ``` ### 4.3.2. Tạo `Command Bean` chứa dữ liệu cần kiểm tra Tạo ra một class chứa dữ liệu cần kiểm tra, class này sẽ được gọi là `Command Bean`. Ví dụ: >`User.java` ```java package com.example.demo; import javax.validation.constraints.Size; import javax.validation.constraints.NotNull; public class User { @NotNull @Size(min=5, message="Username must be at least 5 characters long") private String username; private String password; // constructor, getter, setter } ``` ### 4.3.3. Sử dụng `@Validated`, `@Valid` trong `Controller` Trong `RestFul API`, chúng ta sẽ sử dụng `Validation` để kiểm tra dữ liệu đầu vào của người dùng bằng cách: - Sử dụng `@Validated` trên đầu `Class` để bắt tất cả các `api` trong `Class` đó phải kiểm tra dữ liệu đầu vào. - Đặt`@Valid` trước `@RequestBody` hoặc trước `@ModelAttribute` với các class `dữ liệu` được yêu cầu kiểm tra để kiểm tra dữ liệu đầu vào của người dùng trong 1 `method` cụ thể. - Sử dụng các Annotation kiểm tra dữ liệu đầu vào của người dùng như `@NotNull`, `@Size`, `@Email`, `@Pattern`,...đặt ngay trước các params, fields cần kiểm tra. Ví dụ: >`UserController.java` ```java package com.example.demo; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RequestBody; import org.springframework.web.bind.annotation.RestController; import jakarta.validation.Valid; @RestController @Validated // Bắt tất cả các api trong class này phải kiểm tra dữ liệu đầu vào public class UserController { @PostMapping("/user") public String postUser(@Valid @RequestBody User user) { return ... } // Nếu không có lỗi, trả về dữ liệu\ // Nếu có lỗi sẽ trả về BAD_REQUEST với trường thông báo lỗi mặc định của Spring @GetMapping("/user") public String getUser(@RequestParam @Size(min=5, message="Username must be at least 5 characters long") // Kiểm tra username truyền vào có ít nhất 5 kí tự String username) { return ... } } ```

Spring: Làm việc với kiến trúc MVC