springboot-patterns

此技能作為開發人員使用 Java Spring Boot 建構生產級服務時的綜合架構藍圖與實作指南。它提供標準化模式以建構可擴展的後端，確保程式碼庫遵循諸如 Controller-Service-Repository 分層架構等專業慣例。該代理人擔任 Spring MVC 與 WebFlux 的技術顧問，協助開發人員將業務需求轉化為強大且易於維護的 API 端點，同時遵守嚴格的驗證與安全標準。

• 使用 @RestController、@Validated 與正確的 ResponseEntity 回應結構來設計標準化 REST API。

• Spring Data JPA 的儲存庫模式實作，包括自訂 @Query 定義與分頁/排序配置。

• 強調 @Transactional 邊界管理與 Service 到 Repository 編排的服務層設計模式。

• DTO 模式策略，包括對應邏輯、@Valid 註解用法以及使用 Java Records 進行不可變資料傳輸。

• 透過 @ControllerAdvice 進行全域例外處理，以標準化錯誤回應並提高 API 可靠性。

• 效能最佳化技術，包括用於分散式快取的 @Cacheable/@CacheEvict，以及用於非阻塞非同步任務執行的 @Async。

• 生產就緒的可觀測性，透過 SLF4J 日誌記錄、診斷請求日誌過濾器，以及用於外部整合呼叫的重試邏輯。

• 全面的輸入處理，結合資料完整性約束、@FutureOrPresent 檢查，以及針對內部服務故障的健全錯誤日誌記錄。

• 此技能適用於專注於企業級 Java 應用程式的後端工程師與架構師。

• 可用於重構單體服務、實作新微服務，或在團隊之間建立一致的程式碼庫風格。

• 在呼叫特定模式之前，請確保應用程式已具備 JPA、Validation 與 Caching 的必要依賴項目。

• 輸入通常涉及領域實體、業務邏輯需求或 API 端點規格；輸出為乾淨且可測試的 Java 程式碼片段。

• 約束包括需與使用的 Spring Boot 版本保持相容；在實作如 WebFlux 或響應式模式等進階功能前，請務必確認 Spring Framework 舊版本的相容性。