Sau khi đã cài đặt xong môi trường phát triển, trong bài học này bạn sẽ:
- Tạo một project Spring Boot mới.
- Cấu hình các thông số cơ bản.
- Thêm các dependency cần thiết cho ứng dụng bán hàng online.
🧰 1. Tạo project Spring Boot mới trong Eclipse
Bước 1: Mở Eclipse → File > New > Spring Starter Project
- Project Name:
banhang-online
- Type: Maven
- Packaging: Jar
- Java Version: 17 hoặc phù hợp với JDK bạn đã cài
Group: com.lungcode
Artifact: banhang
Name: banhang-online
Description: Ứng dụng bán hàng online với Spring Boot
Package: com.lungcode.banhang
📌 Ảnh minh họa gợi ý: Chụp màn hình bước cấu hình project Spring Starter.
Bước 2: Chọn các dependency:
- Spring Web:
- Cung cấp các công cụ để tạo Controller, xử lý request/response
- Tích hợp sẵn Tomcat làm web server nội bộ
- Dễ dàng tạo các API hoặc giao diện web HTML với Thymeleaf
- 📦 Bao gồm:
- Spring MVC
- Tomcat embedded
- Jackson (để convert JSON)
- Thymeleaf:
- Template engine để hiển thị HTML động
- Tích hợp chặt với Spring MVC
- Cho phép truyền dữ liệu từ Controller ra view
- Hỗ trợ các tính năng như điều kiện (
th:if
), vòng lặp (th:each
) - Spring Data JPA:
- Giúp làm việc với DB bằng interface (
JpaRepository
) - Hạn chế viết SQL thủ công
- Tự động ánh xạ entity với bảng
- Hỗ trợ custom query theo tên hàm
- SQL Server Driver:
- Driver JDBC giúp kết nối đến CSDL SQL Server
- Nếu dùng Oracle, thay thế bằng:
ojdbc8
(Java 8+)ojdbc11
(Java 11+)
- Spring Boot DevTools:
- Tự động reload khi sửa code
- Hữu ích trong quá trình phát triển
- Không nên dùng trong môi trường production
- Validation:
- Hỗ trợ kiểm tra dữ liệu người dùng nhập
- Sử dụng annotation:
@NotNull
,@NotBlank
@Email
,@Size
,@Min
,@Max
Nhấn Finish để hoàn tất.
🗂 2. Cấu trúc thư mục mặc định của Spring Boot
Khi tạo xong, bạn sẽ thấy cấu trúc thư mục như sau:
src/
└─ main/
├── java/
│ └─ com/lungcode/banhang/
│ └─ BanhangOnlineApplication.java
└── resources/
├── static/
├── templates/
└── application.properties
Giải thích:
static/
: chứa file tĩnh như CSS, JS, hình ảnh.templates/
: chứa các file Thymeleaf HTML.application.properties
: nơi cấu hình ứng dụng.
🔧 3. Kiểm tra file pom.xml
File pom.xml
sẽ chứa các dependency bạn đã chọn. Kiểm tra nội dung có dạng:
<dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-thymeleaf</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-jpa</artifactId> </dependency> <dependency> <groupId>com.microsoft.sqlserver</groupId> <artifactId>mssql-jdbc</artifactId> <version>12.2.0.jre11</version> </dependency> </dependencies>
📌 Nếu thiếu, bạn có thể thêm thủ công các dependency cần thiết.
🚀 4. Viết Controller đầu tiên để kiểm tra ứng dụng
Tạo một class mới tên là HomeController.java
trong package controller
.
package com.yourcompany.banhang.controller; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.GetMapping; @Controller public class HomeController { @GetMapping("/") public String home() { return "index"; // sẽ trả về file index.html trong thư mục templates } }
🧾 5. Tạo file index.html
để hiển thị giao diện
Tạo file index.html
trong thư mục src/main/resources/templates
.
<!DOCTYPE html> <html xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>Trang chủ</title> </head> <body> <h1>Chào mừng đến với ứng dụng bán hàng online!</h1> </body> </html>
⚙ 6. Chạy thử ứng dụng
Nhấn chuột phải vào file BanhangOnlineApplication.java
→ Run As > Spring Boot App
(Hoặc có thể click chuôt phải vào thư mưc ứng dụng -> Run As > Spring Boot App
)
Mở trình duyệt và truy cập:
http://localhost:8080/
Bạn sẽ thấy dòng chữ “Chào mừng đến với ứng dụng bán hàng online!”
📌 Kết luận
Bạn đã hoàn thành bài học 3 với các nội dung:
- Tạo project Spring Boot bằng Eclipse
- Thêm dependency phù hợp
- Tạo controller và view cơ bản
- Chạy ứng dụng đầu tiên