Ithome2024

這篇文章是整個系列的最後一篇，主要是想分享一下這次寫文章的過程，以及一些心得感想

這篇文章詳細介紹了如何將 Spring Boot 應用程式部署到正式環境，包括建立可執行的 JAR 檔、使用 Docker 容器化應用程式，以及透過 Zeabur 平台進行雲端部署。文章首先說明了如何使用 Gradle 或 IDE 生成 JAR 檔，接著介紹如何撰寫 Dockerfile 並建立 Docker Image，最後展示了在 Zeabur 平台上快速部署應用程式的步驟。這些方法各具優勢，開發者可以依據專案需求選擇最適合的部署方式，輕鬆將 Spring Boot 應用程式上線

Spring Boot Actuator 是 Spring Boot 框架中的一個強大工具，提供即時監控和管理應用程式的多種功能。本文介紹了 Actuator 的用途，如健康檢查、指標收集、日誌管理和環境屬性查看。加入 Actuator 只需簡單設置依賴和配置檔案，並可利用 Spring Security 設定存取權限。本文還展示了如何自定義應用資訊及測試 Actuator API。Actuator 為開發和維護帶來極大便利，但在正式環境中需注意安全設定

本文介紹了 JWT（JSON Web Token）在 API 身分驗證中的應用，並詳細說明了如何在 Spring Boot 專案中實現 JWT 認證。文章解釋了 JWT 的概念、優勢，以及在 Spring Security 中的具體實現步驟，包括添加 JWT 依賴、建立 JWT 服務、配置安全過濾器等。通過這些步驟，我們實現了一個基於 JWT 的無狀態身分驗證系統，提高了 API 的安全性和擴展性

這篇文章詳細介紹了如何在 Spring Boot 應用程式中加入 Spring Security 後，調整測試程式碼以支援認證和授權。內容涵蓋了使用 spring-security-test 模擬認證和授權、處理 CSRF 保護，以及使用 Mock 物件進行測試。此外，文章還展示了如何修改相關的測試，並提供了具體的程式碼範例，確保應用程式的安全性和測試的完整性

這篇文章深入探討了如何使用程式碼來自訂 Spring Security 的安全設定，包括記憶體中使用者資料的設定、密碼編碼、HTTP 請求授權設定，以及將使用者資料儲存到 H2 資料庫中。文章詳細介紹了如何使用 BCryptPasswordEncoder 來安全地儲存密碼，並展示了如何自訂 UserDetailsService 和配置 HttpSecurity 以實現更靈活的 API 端點存取控制。此外，還提供了在使用 Spring Security 後，如何安全地存取 H2 console 的相關設定。這些進階設定使應用程式更加安全和可擴展

本文介紹了在 Spring Boot 測試中使用 content().json()、JSONAssert 和物件比對三種方法來驗證 JSON，提高測試的可讀性、可靠性和維護性

Spring Security 是一個功能豐富的安全框架，專門用於保護基於 Spring 的應用程式。本文介紹了 Spring Security 的基礎知識，包括身份驗證、授權、防護常見 Web 攻擊等主要功能。文章詳細說明了如何在 Spring Boot 中安裝和配置 Spring Security，並展示了預設設定、測試及 API 授權的實作方法。通過簡單配置，開發者可以為應用程式添加基本的安全防護

CORS（跨來源資源共享）是現代網路開發中的重要概念，允許不同來源的網頁請求資源。本文介紹了在 Spring Boot 中應用 CORS 的方法，包括使用 @CrossOrigin 註解和全局配置。@CrossOrigin 註解適用於特定控制器或方法，而全局配置則適用於整個應用程式。文章還提供了設置和測試 CORS 的實際步驟，並強調了 CORS 在安全性和靈活性方面的重要性。通過適當配置，CORS 能夠有效防止未經授權的存取，同時允許跨網域通信

REST Assured 是一個強大的 Java 函式庫，用於測試 RESTful API。本文介紹了 REST Assured 的基本用法，包括設定前置條件、發送請求和驗證回應。透過 BDD 風格的測試，使程式碼更易讀。文章還討論了 REST Assured 與 Hamcrest 和 AssertJ 的整合，進一步提升測試的靈活性和表達力。最後，文章比較了 SpringBootTest 和 REST Assured 的優缺點，強調了 REST Assured 在 API 測試中的優勢及其應用場景

SpringBootTest 是一個強大的測試工具，允許在測試環境中啟動完整的 Spring 應用程式，進行整合測試和 EndtoEnd 測試。本文介紹如何為應用程式實作 end-to-end 測試，包括設置測試 properties 文件、撰寫測試類別，並使用 TestRestTemplate 進行 HTTP 請求和驗證回應。通過這種測試方法，可以確保應用程式的各個組件正確協同工作，儘管相比單元測試更耗時和資源，但能捕捉到單元測試可能遺漏的問題，特別是在組件整合方面

使用 Spring 框架的 DataJpaTest 進行 JPA 測試，專注於測試資料庫操作而無需設置完整應用程式。本篇文章介紹如何使用 @DataJpaTest 註解、自動配置記憶體資料庫、執行 @Entity 類別掃描及啟用 SQL 日誌記錄。透過測試 TodoRepository 的自定義查詢方法和 JPQL 方法，確保每個測試方法的初始狀態一致，並驗證查詢結果的正確性。這種方法不僅高效可靠，還能提高程式碼的可靠性，並在重構或優化時提供安全保障。

使用 MockMVC 測試 Spring MVC 應用程式的控制器是有效的方法，它允許開發者模擬 HTTP 請求而無需啟動伺服器。本文介紹了如何使用 @WebMvcTest 註解來專門測試控制器，以及如何利用 @MockBean 模擬服務層行為，並通過 MockMvc 模擬 HTTP 請求。文中詳細展示了 CRUD 操作的測試案例，涵蓋了創建、查詢、更新和刪除待辦事項的各種情境，並強調了驗證回應狀態碼和內容的重要性。建議為每個控制器方法編寫全面的測試案例，以提高應用品質

探索如何為 Spring Boot 應用程式撰寫單元測試。單元測試驗證程式碼的最小單位是否按預期運作。文章介紹 Spring Boot 測試工具如 @WebMvcTest、@DataJpaTest、@MockBean 和 @SpringBootTest，並使用 JUnit 5 和 Mockito 撰寫測試。通過這些測試，確保程式碼的品質、可維護性和可靠性。學習如何模擬對象行為並驗證方法呼叫次數

本文介紹如何在 Spring Boot 專案中從 H2 資料庫轉換到 PostgreSQL，包括使用 Supabase 建立 PostgreSQL 資料庫、修改依賴和配置、調整程式碼等步驟。文章還討論了 PostgreSQL 的優勢、大小寫問題，以及使用 Spring Data JPA 實現無縫資料庫切換的便利性

本文深入探討了 Spring Data JPA 中的交易管理實現。文章首先介紹了交易管理的概念和 ACID 特性，然後詳細說明了如何使用 @Transactional 註解來實現交易控制。文章提供了具體的程式碼示例。此外，文章分析了交易管理的優缺點，包括保證資料一致性的優點，以及可能帶來的性能開銷等缺點。最後，文章提供了一些實務上的建議，如合理劃分交易邊界和避免長時間交易等。這篇文章為 Spring Boot 開發者提供了全面的交易管理實現指南，有助於提高應用程式的資料一致性和完整性

本文深入探討了如何在 Spring Data JPA 中實現分頁和動態排序功能。文章首先介紹了分頁的實現方法，包括在程式碼中添加分頁方法，以及在 Controller 中使用 Pageable 物件來處理分頁請求。接著，文章詳細說明了如何實現動態排序，通過在控制器方法中添加排序參數，並使用 Sort 物件來定義排序規則。文章還提供了具體的程式碼示例和測試結果，展示了如何同時使用分頁和排序功能。最後，文章分析了分頁和動態排序的優缺點。這篇文章為 Spring Boot 開發者提供了全面的分頁和動態排序實現指南，有助於提高應用程式處理大量資料的能力。

本文深入探討了 Spring Data JPA 中 JPQL（Java Persistence Query Language）的使用。文章首先介紹了 JPQL 的基本概念、規則以及與 SQL 的區別。接著，文章展示了如何在程式碼中使用 @Query 註解實現 JPQL 查詢，並詳細解釋了每個查詢的含義。文章還簡要介紹了如何使用原生 SQL 查詢。此外，文章分析了 JPQL 的優缺點。最後，文章提供了一系列最佳實踐建議。這篇文章為 Spring Boot 開發者提供了全面的 JPQL 使用指南，有助於提高查詢的靈活性和效率

本文深入探討了 Spring Data JPA 中自定義查詢方法的使用。文章首先介紹了自定義查詢方法的基本規則和語法，包括方法命名規則和常用關鍵字。接著，文章展示了如何實現自定義查詢方法，並使用這些方法。文章還詳細分析了自定義查詢方法的優缺點。最後，文章提供了一系列最佳實踐建議

本文深入探討了 Spring Data JPA 的特點及其與 Spring Data JDBC 的比較。文章首先介紹了 Spring Data JPA 的主要特點，包括簡化開發、方法名稱查詢、分頁和排序支援等。接著，文章詳細說明了如何在 Spring Boot 項目中集成 Spring Data JPA，包括添加依賴、修改實體類別和建立 Repository。文章還對比了 Spring Data JPA 和 Spring Data JDBC 在複雜度、效能、查詢能力、關聯處理、延遲載入和事務處理等方面的差異。最後，文章提供了實務上的選擇建議，幫助開發者根據專案需求選擇合適的數據訪問框架。這篇文章為 Spring Boot 開發者提供了全面的 Spring Data JPA 使用指南，有助於理解和選擇適合項目需求的 ORM 框架

本文深入探討了 Spring Data JDBC 的使用方法及其與 JdbcClient 的比較。文章首先介紹了 Spring Data JDBC 的主要特點，包括簡單性、無狀態概念和自動化 CRUD 操作等。接著，文章詳細說明了如何在 Spring Boot 項目中集成 Spring Data JDBC，包括添加依賴、修改實體類別和創建 Repository。文章還提供了使用 Spring Data JDBC 重寫 TodoController 的完整代碼示例。最後，文章對比了 Spring Data JDBC 和 JdbcClient 在抽象層級、程式碼量、靈活性、學習曲線和性能等方面的差異，並提供了實務上的選擇建議。這篇文章為 Spring Boot 開發者提供了全面的 Spring Data JDBC 使用指南，有助於選擇適合項目需求的數據訪問方法

本文深入探討了 Spring Boot 中使用 JdbcTemplate 和 JdbcClient 來簡化資料庫操作的方法。文章首先介紹了 JDBC API 和原生 Java SQL 的關係，然後詳細說明了如何使用 JdbcTemplate 和 JdbcClient 改寫之前的 TodoController。文章提供了兩種實現方式的完整程式碼示例，並對比了它們與原生 Java SQL 在程式碼簡潔度、異常處理、資源管理、類型安全性等方面的差異。最後，文章總結了 JdbcTemplate 和 JdbcClient 的主要優勢，並提供了選擇適當工具的建議。這篇文章為 Spring Boot 開發者提供了全面的 JDBC 操作優化指南，有助於提高開發效率和程式碼質量

本文詳細介紹了如何在 Spring Boot 項目中使用 H2 資料庫。文章首先介紹了 H2 資料庫的特點和運行模式，然後展示了如何在 Spring Boot 中配置和使用 H2。文章重點說明了如何將之前的 TodoController 從使用靜態 List 改為使用 H2，並提供了詳細的代碼示例。此外，文章還介紹了 H2 資料庫的配置選項，以及兩種自動創建資料庫表的方法：使用 schema.sql 文件和使用 @PostConstruct 註解。最後，文章總結了使用 H2 資料庫的優點，強調了它在快速原型開發和測試中的重要性。這篇文章為 Spring Boot 開發者提供了一個全面的 H2 資料庫使用指南

這篇文章介紹了如何在 Java 和 Spring Boot 中使用 Bean Validation 和 Spring Validator 進行資料驗證。文章首先簡介了 Bean Validation，並提供了在 Spring Boot 專案中添加和使用這些驗證的步驟。接著，文章展示了如何修改 Todo 類別和控制器以加入驗證，並提供了測試方法。文章還介紹了 Spring Validator 的使用方法，包括如何建立自定義驗證邏輯。最後，文章比較了 Bean Validation 和 Spring Validator 的優缺點，並建議在實際應用中結合使用兩者來實現全面的數據驗證

本文介紹了如何在 Spring Boot 項目中整合 Swagger 來自動生成 API 文件。文章首先簡要介紹了 Swagger 及其主要功能，然後詳細說明了在 Spring Boot 中整合 Swagger 的步驟，包括添加依賴、配置 Swagger、在控制器中添加 Swagger 註解等。文章還介紹了常用的 Swagger 註解及其用途，以及如何查看生成的 API 文件。此外，文章還提供了一些額外的 Swagger 配置選項。最後，文章總結了整合 Swagger 的好處，強調了它對提高開發效率、改善團隊協作和增強 API 可用性的重要性。這篇文章為 Spring Boot 開發者提供了一個全面的 API 文檔自動化指南

文章首先介紹了 SLF4J 作為日誌抽象層和 Logback 作為具體實現的角色，然後展示了如何在 Todo List API 中實現日誌記錄。文章還詳細說明了 Logback 的文件配置，包括如何實現每日日誌文件切割和大小控制。最後，文章提供了一系列日誌記錄的最佳實踐建議，包括適度記錄、使用適當的日誌級別、避免記錄敏感信息等

文章介紹了三種主要的實現方式：使用 @ExceptionHandler 註解（控制器級別）、使用 @ControllerAdvice（全域級別）和使用 ResponseEntityExceptionHandler（Spring MVC 特定異常處理），文章還討論了全域異常處理的整體優缺點，最後，文章強調了全域異常處理在構建健壯 API 中的重要性，特別是對於大型或長期維護的項目

文章首先介紹了 RFC 7807 Problem Details for HTTP APIs 標準，然後詳細說明了如何建立一個通用的 ApiResponse 類別來封裝 API 回應。此外，文章比較了自定義設計與 RFC 7807 標準的異同，並討論了使用統一 API 返回結構的優缺點。最後，文章強調了統一 API 回應格式在提高 API 可用性和一致性方面的重要性，特別是對於大型或長期維護的項目

文章詳細介紹了 @RequestParam、@PathVariable、@RequestHeader、@CookieValue 和 @RequestBody 等註解的使用，並提供了實際的程式碼。此外，文章還討論了如何設置參數的必要性和默認值，以增加 API 的靈活性和健壯性。最後，文章提供了一些實踐建議，幫助開發者設計更好的 API

文章介紹了如何使用 Spring Boot 建立一個簡單的 Todo List RESTful API，實現基本的 CRUD（創建、讀取、更新、刪除）操作。最後，文章介紹了如何使用 JetBrains HTTP Client 來測試這些 API 端點。這個實例為讀者提供了一個實用的 RESTful API 設計和實現的指南，適合初學者學習 Spring Boot API 開發

文章解釋了自動配置的概念、工作原理和流程，包括類別路徑掃描、條件評估、配置類別加載和 Bean 建立。通過 Redis 配置的例子，文章展示了自動配置的實際應用。此外，文章還介紹了如何自定義和覆蓋自動配置，包括使用屬性配置、自定義配置類別和排除特定自動配置的方法。最後，文章提供了自動配置除錯的技巧，幫助開發者更好地理解和控制 Spring Boot 的自動配置過程。這些知識對於充分利用 Spring Boot 的便利性和靈活性至關重要

文章介紹了 Bean 的定義方式，包括 XML 配置、Java 程式配置和注解方式。同時，詳細解釋了 Bean 的作用域，如 singleton、prototype 等。文章還闡述了依賴注入（DI）的三種主要方式：建構子注入、Setter 注入和 field 注入，並討論了它們的優缺點。最後，文章概述了 Bean 的生命週期，並提供了如何通過實現特定接口來干預 Bean 生命週期的示例。這些知識對於理解 Spring Boot 應用程式的開發和提高代碼質量至關重要

文章詳細說明了 Profile 的概念、設置方法、命名規則，以及如何啟用特定 Profile。同時，文章還解釋了 Profile 的運作原理、多個 Profile 同時啟用時的處理順序，以及 Spring Boot 配置的優先順序。最後，文章提供了 Profile 使用的最佳實踐建議，強調了 Profile 機制在提高開發效率和簡化部署維護方面的重要性

文章介紹了配置文件的格式選擇（Properties vs YAML），展示了如何定義和使用自定義屬性，並比較了 @Value 注入和 @ConfigurationProperties 綁定兩種方法的優缺點。同時，文章還討論了第三方 Starter 的配置方式，並將 Spring Boot 的 application.properties 與 .NET Core 的 appsettings.json 進行了比較，突出了它們的相似點和差異。通過實例說明，本文為讀者提供了全面掌握 Spring Boot 配置管理的指南

本文深入解析了 Spring Boot Starter 的概念和重要性。文章首先分析了 build.gradle 文件的結構，然後詳細介紹了 Starter 的作用和優勢，包括簡化依賴管理、確保版本兼容性、快速啟動項目等。文章還比較了 Spring Boot Starter 與 C# NuGet Packages 的異同，並簡要對比了 Maven 和 Gradle 這兩種常用的構建工具

本文詳細剖析了 Spring Boot 專案的結構，包括根目錄、src 目錄（main 和 test）的內容及其作用。重點解釋了關鍵檔案如 TodolistApplication.java、application.properties 和 build.gradle 的功能。文章還闡述了 Spring Boot 專案結構的設計理念，包括關注點分離、約定優於配置、模組化、測試友好和配置集中化。這種結構設計不僅使專案易於理解和維護，還為擴展和測試提供了良好的基礎，有助於提高開發效率和團隊協作。

本文介紹如何使用 Spring Initializr 或 IntelliJ IDEA 建立第一個 Spring Boot API 專案。文章詳細說明了專案設置過程，包括使用 Gradle、Java 17 和最新版 Spring Boot。通過創建一個簡單的 HelloController，展示了如何實現基本的 API 端點

本文介紹了 Spring 和 Spring Boot 兩個 Java 生態系統中重要的框架。Spring 是一個開源 Java 平台，提供依賴注入、AOP、事務管理等功能。Spring Boot 則建立在 Spring 之上，提供自動配置、獨立運行、內嵌服務器等特性，大大簡化了 Spring 應用的開發過程。文章比較了兩者在配置複雜度、依賴管理、應用服務器等方面的區別，總結 Spring Boot 讓 Spring 開發變得更加簡單和便捷。

本文介紹作者因新工作需求重新學習 Java 和 Spring Boot，並計劃通過一個 ToDo List API 項目來分享學習經驗。作者將撰寫一系列共 35 篇的文章，涵蓋從基礎到進階的 Spring Boot API 開發知識，旨在為繁體中文社群提供最新、實用的 Spring Boot 學習資源。