前言

本教材的目標

這是一份「做中學」的 Spring Boot 後端開發教材。全書以一個完整、可直接執行的 線上書店 REST API 專案貫穿，學完後你將能夠：

• 使用 Spring Boot 建立分層架構的後端專案（Controller / Service / Repository）。

• 實作符合 REST 規範的 API，正確運用 、、、、 五種 HTTP 方法與狀態碼。

• 透過 Hibernate / JPA 操作 MySQL 資料庫，理解 Entity 對映、衍生查詢與交易管理，並學會設定資料庫連線。

• 使用 Spring Security 搭配 JWT 實作註冊、登入、認證與角色授權。

• 將專案打包成 Docker 映像檔，並使用 Docker Compose 一鍵啟動「MySQL + API」整組服務。

• 使用 Postman 匯入測試集合、管理環境變數、撰寫自動化測試腳本並匯出分享。

適用對象與先備知識

本教材適合已具備 Java 基礎語法（類別、介面、集合、例外處理）， 想要系統性學習後端 API 開發的讀者。 不需要有 Spring、SQL 或 Docker 的經驗——所有觀念都會從零開始說明。

開發環境與版本

隨附檔案結構

教材資料夾的內容如下，建議搭配原始碼一邊閱讀一邊操作：

Springboot/
|-- bookstore-api/                 # Spring Boot 專案（本書主角）
|   |-- src/main/java/...          # Java 原始碼（所有檔案皆有中文註解）
|   |-- src/main/resources/        # application.yml 設定檔
|   |-- pom.xml                    # Maven 設定
|   |-- Dockerfile                 # Docker 映像檔建置腳本
|   `-- docker-compose.yml         # 一鍵啟動 MySQL + API
|-- postman/
|   |-- Bookstore-API.postman_collection.json    # Postman 測試集合
|   `-- Bookstore-Local.postman_environment.json # Postman 環境檔
|-- latex/                         # 本教材的 LaTeX 原始檔
`-- springboot-tutorial.pdf        # 本教材 PDF

學習路線圖