Cách thiết lập nhanh một dự án Spring Boot - bắn cá xèng 777

| May 16, 2025 min read

Ngày 03 tháng 06 năm 2023 - Máy tính

Spring Boot cho phép tạo ra một ứng dụng Spring độc lập và sẵn sàng sản xuất với mức cấu hình tối thiểu nhất.

Bài viết này sẽ hướng dẫn bạn cách thiết lập nhanh một dự án Spring Boot với thông điệp “Hello World!”. Hệ điều hành được sử dụng trong bài viết này là MacOS. Ngoài ra, các phiên bản của JDK, Maven và Spring Boot tại thời điểm viết bài lần lượt là:

Việc tải về và cài đặt JDK cũng như Maven rất đơn giản, vì vậy bài viết sẽ không đề cập chi tiết về phần này.

1 Tạo dự án mẫu

Truy cập vào trang web start.spring.io và sử dụng công cụ Spring Initializr để tạo một dự án Spring Boot Web.

Các tùy chọn được sử dụng trong bài viết này bao gồm:

  • Project: Chọn Maven
  • Language: Chọn Java
  • Spring Boot: Chọn phiên bản 3.1.0
  • Packaging: Chọn Jar
  • Java: Chọn phiên bản 17
  • Dependencies: Đánh dấu chọn Spring Web

Sau khi chọn xong, nhấn nút “Generate” để tạo ra dự án mẫu. File zip sẽ được tải xuống máy tính, sau đó giải nén file và mở bằng IDE yêu thích.

Khi mở dự án, bạn sẽ thấy cấu trúc thư mục như sau:

demo
├─ src/main/java
│  └─ com.example.demo
│    └─ DemoApplication.java
└─ pom.xml

2 Thêm mã nguồn

Tiếp theo, thay thế nội dung của tệp DemoApplication.java trong thư mục src/main/java/com/example/demo bằng sv388 sv288 com đoạn mã sau:

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
@SpringBootApplication
public class DemoApplication {

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

    @GetMapping("/hello")
    public String hello(@RequestParam(value = "name", defaultValue = "World") String name) {
        return String.format("Hello %s!", name);
    }
}

Đây là toàn bộ mã nguồn cần thiết để xây dựng một dịch vụ Web “Hello World!” bằng Spring Boot.

Dưới đây là giải thích về các annotation được sử dụng:

  • @RestController: Thông báo cho Spring rằng lớp này cung cấp một điểm kết nối (endpoint) trên Web.
  • @GetMapping("/hello"): Chỉ định rằng phương thức hello() sẽ xử lý các yêu cầu GET đến đường dẫn /hello.
  • @RequestParam: Cho phép truyền giá trị tham số name trong yêu cầu (nếu không có giá trị, nó sẽ sử dụng giá trị mặc định là “World”).

3 Kiểm thử

Sử dụng Maven để xây dựng và chạy chương trình.

Mở terminal, di chuyển đến thư mục gốc của dự án và thực hiện các lệnh Maven sau:

mvn clean package
mvn spring-boot:run --quiet

Sau khi chương trình khởi động thành công, bạn có thể kiểm tra bằng cách sử dụng các lệnh CURL sau:

curl http://localhost:8080/hello
Hello World!
curl 'http://localhost:8080/hello?name=Larry'
Hello Larry!

Như vậy, chúng ta đã hoàn tất việc thiết lập nhanh một dự án Spring Boot. Có thể thấy rằng Spring Boot rất dễ sử dụng và đơn giản.

Toàn bộ mã nguồn của dự án đã được lưu trữ trên GitHub, bạn có thể theo dõi hoặc fork dự án.

[1] Hướng dẫn nhanh Spring | Spring - spring.io
[2] Spring Initializr | Spring - spring.io
[3] Spring Boot | Spring - spring.io
[4] Tải xuống Java - Các phiên bản OpenJDK dành cho Linux, Windows & macOS | BellSoft - bell-sw.com
[5] Tải xuống Apache Maven | Maven - maven.apache.org

#Java #Spring #Maven