框架概述
AppFuse Server 是一個 Spring Boot 快速開發工具集，提供企業應用程式常用的功能模組。
設計理念
目的：提供工具集而非預設實作，保持應用程式開發的最大彈性
原則：不包含具體的 entity、service、repository、configuration，而是提供建構這些組件的工具
技術規格
- 框架: Spring Boot 3.5.x
- 語言: Java 25
- 建構: Gradle (Maven 發佈)
- 打包: JAR Library
安裝
Gradle (Kotlin DSL)
dependencies {
implementation("io.leandev.appfuse:appfuse-server:0.0.2-SNAPSHOT")
}
Gradle (Groovy)
dependencies {
implementation 'io.leandev.appfuse:appfuse-server:0.0.2-SNAPSHOT'
}
依賴傳遞
AppFuse Server 使用 api 方式聲明核心依賴，這些依賴會自動傳遞給使用者：
- Spring Boot Starters (actuator, data-jpa, hateoas, mail, quartz, security, oauth2, validation, web)
- HTTP 客戶端 (httpclient5)
- JAX-RS API (jakarta.ws.rs-api)
- JWT (jjwt-api)
使用者專案無需重複聲明這些依賴。
功能模組總覽
| 分類 | 模組 | 用途 | 文檔 |
|---|---|---|---|
| 核心工具 | HTTP | HTTP 客戶端工具 | 指南 |
| Cache | 快取管理（標準/雙層） | 指南 | |
| CSV | CSV 讀寫處理 | 指南 | |
| Content | MIME 類型檢測 | 指南 | |
| 數據存儲 | JPA | JPA 查詢建構工具 | 指南 |
| Search | 搜尋過濾查詢 | 指南 | |
| File | 文件存儲（S3、Azure、SFTP、Local） | 指南 | |
| Image | 圖像處理（縮放、轉換） | 指南 | |
| 安全認證 | Security | 登入鎖定防護 | 指南 |
| OAuth2 | OAuth2 認證整合 | 指南 | |
| Tenant | 多租戶數據隔離 | 指南 | |
| 應用服務 | 郵件發送 | 指南 | |
| NLS | 國際化翻譯 | 指南 | |
| Link | HATEOAS 連結建構 | 指南 | |
| Error | 統一錯誤處理 | 指南 |
下一步
參考實作
查看 app-server 了解如何在實際專案中使用這些工具建構完整的 RESTful 應用程式。