Spring Boot 開發 RESTful 服務完整教程：從零構建用戶積分系統

Spring Boot 核心優勢

Spring Boot 由 Pivotal 團隊開發，旨在簡化 Spring 應用的初始搭建與開發流程。其核心特性包括：

• 約定優於配置：消除大量 XML 配置，實現「零配置」啟動
• 內嵌容器：內置 Tomcat/Jetty/Undertow，打包為可執行 JAR 即可獨立運行
• Starter 依賴：聚合常用功能模組（Web、Data、Security 等），一鍵引入
• 生產級監控：內建 Actuator 提供健康檢查、指標監控、外部化配置

開發環境準備

項目結構與核心依賴

1. Maven 多模塊結構（推薦）

mapp-project
├── mapp-common      # 公共模塊：實體、工具、常量
├── mapp-service     # 服務層：業務邏輯、事務控制
├── mapp-web         # Web 層：Controller、VO、攔截器
└── mapp-run         # 啟動模塊：主類、配置類

2. 父 POM 關鍵配置

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.7.14</version> <!-- 當前 LTS 版本 -->
    <relativePath/>
</parent>

<properties>
    <java.version>1.8</java.version>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

<dependencies>
    <!-- Web 開發起步依賴，含 Spring MVC + 內嵌 Tomcat + Jackson -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    
    <!-- 測試起步依賴 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
    
    <!-- 熱部署（開發期） -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-devtools</artifactId>
        <optional>true</optional>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

RESTful API 設計規範

核心代碼實現

1. 實體類設計

@Data
@NoArgsConstructor
@AllArgsConstructor
public class User {
    private Long id;
    private String username;
    private Integer points;
    private LocalDateTime createTime;
    private LocalDateTime updateTime;
}

2. 統一響應封裝

@Data
@AllArgsConstructor
@NoArgsConstructor
public class Result<T> {
    private Integer code;    // 200 成功，其它失敗
    private String message;
    private T data;
    
    public static <T> Result<T> success(T data) {
        return new Result<>(200, "成功", data);
    }
    public static <T> Result<T> fail(String msg) {
        return new Result<>(500, msg, null);
    }
}

3. Controller 實現

Tomcat initialized with port(s): 8080 (http)
Started MappRunApplication in 2.573 seconds