1. Chuẩn bị môi trường phát triển

Trước khi bắt đầu xây dựng ứng dụng Spring Boot, bạn cần đảm bảo hệ thống đã cài đặt các công cụ sau:

• JDK: Phiên bản 1.8 hoặc 11/17 (tùy thuộc vào phiên bản Spring Boot bạn chọn).
• Build Tool: Maven 3.6 trở lên hoặc Gradle.
• IDE: IntelliJ IDEA, Eclipse hoặc VS Code.

2. Khởi tạo dự án thủ công từ Maven

Phương pháp này giúp bạn hiểu rõ cấu trúc cốt lõi của một dự án Spring Boot thông qua việc cấu hình tệp pom.xml.

Sử dụng spring-boot-starter-parent

Đây là cách phổ biến nhất. Dự án của bạn sẽ kế thừa các cấu hình mặc định từ Spring Boot, bao gồm quản lý phiên bản thư viện (dependency management) và cấu hình trình biên dịch.

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.5</version>
        <relativePath/>
    </parent>

    <groupId>com.dev.pro</groupId>
    <artifactId>backend-service</artifactId>
    <version>1.0.0</version>

    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>
</project>

Sử dụng dependencyManagement

Nếu dự án của bạn đã có một parent khác và không thể kế thừa từ Spring Boot, bạn có thể sử dụng dependencyManagement để nhập (import) các định nghĩa phiên bản.

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>2.7.5</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

3. Tạo lớp khởi chạy ứng dụng (Main Class)

Sau khi cấu hình Maven, bạn cần tạo một lớp Java để kích hoạt Spring Boot. Lớp này nên nằm ở gói (package) gốc của dự án.

package com.dev.pro;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class MainApplication {
    public static void main(String[] args) {
        SpringApplication.run(MainApplication.class, args);
    }
}

Khi thực thi phương thức main, Spring Boot sẽ tự động khởi động máy chủ nhúng (như Tomcat) tại cổng mặc định 8080.

4. Sử dụng công cụ Spring Initializr

Đây là cách nhanh nhất và được khuyến khích sử dụng cho các dự án thực tế.

Khởi tạo trực tuyến

• Truy cập start.spring.io.
• Chọn Build Tool (Maven/Gradle), ngôn ngữ (Java/Kotlin), và phiên bản Spring Boot.
• Thêm các Dependencies cần thiết như Spring Web, Lombok, hoặc Spring Data JPA.
• Nhấn Generate để tải mã nguồn về máy.

Khởi tạo qua IntelliJ IDEA

1. Mở IntelliJ IDEA, chọn File -> New -> Project.
2. Chọn mục Spring Initializr ở cột bên trái.
3. Lưu ý về Server URL: Mặc định là trang chủ của Spring. Nếu bạn cần sử dụng Java 8 cho các phiên bản Spring Boot mới (vốn yêu cầu Java 17+), bạn có thể chuyển URL sang các máy chủ mirror hỗ trợ legacy Java như https://start.aliyun.com/.
4. Chọn các module cần thiết và nhấn Create.

5. Các thành phần chính trong dự án

Một dự án Spring Boot tiêu chuẩn sau khi khởi tạo sẽ bao gồm:

• src/main/java: Chứa mã nguồn logic của ứng dụng.
• src/main/resources: Chứa tệp cấu hình (application.properties hoặc application.yml) và các tài nguyên tĩnh.
• pom.xml: Quản lý thư viện và vòng đời xây dựng dự án.
• Spring Boot DevTools: Một thư viện hữu ích giúp tự động tải lại (hot swap) mã nguồn khi có thay đổi trong quá trình phát triển.