這是一個展示 HTTP/2 協議在 Spring Boot 微服務架構中應用的客戶端服務專案。主要功能是模擬咖啡廳的客戶端，透過 HTTP/2 協議與服務端進行安全通訊，實現菜單查詢、訂單建立和訂單查詢等核心業務功能。
- HTTP/2 協議支援 - 採用最新的 HTTP/2 協議，提升網路傳輸效能
- SSL/TLS 安全通訊 - 使用自簽憑證確保通訊安全性
- 微服務架構 - 客戶端與服務端分離，便於擴展和維護
- 非同步處理 - 使用 ApplicationRunner 實現非同步業務邏輯
- RESTful API - 標準化的 REST API 設計
💡 為什麼選擇此專案？
- 展示 HTTP/2 在 Spring Boot 中的實際應用
- 提供完整的 SSL/TLS 安全通訊範例
- 適合學習微服務架構和客戶端開發
- 程式碼結構清晰，便於理解和擴展
- Spring Boot 3.2.5 - 現代化的 Java 應用程式框架
- Java 21 - 最新的 Java 版本，支援現代化語法特性
- OkHttp 4.12.0 - 高效能的 HTTP 客戶端庫，支援 HTTP/2
- Lombok - 減少樣板程式碼，提升開發效率
- Joda Money 2.0.2 - 專業的貨幣處理庫
- Apache Commons Lang3 3.17.0 - 實用的工具類庫
http2-customer-service/
├── src/
│ ├── main/
│ │ ├── java/
│ │ │ └── tw/fengqing/spring/springbucks/customer/
│ │ │ ├── CustomerServiceApplication.java # 主應用程式類別
│ │ │ ├── CustomerRunner.java # 業務邏輯執行器
│ │ │ ├── model/ # 資料模型
│ │ │ │ ├── Coffee.java # 咖啡商品模型
│ │ │ │ ├── CoffeeOrder.java # 訂單模型
│ │ │ │ ├── NewOrderRequest.java # 新訂單請求模型
│ │ │ │ └── OrderState.java # 訂單狀態列舉
│ │ │ └── support/ # 支援類別
│ │ └── resources/
│ │ ├── application.properties # 應用程式設定檔
│ │ └── springbucks.p12 # SSL 憑證檔案
│ └── test/
├── pom.xml
└── README.md
- Java 21 - 確保已安裝 JDK 21 或更新版本
- Maven 3.6+ - 用於專案建置和依賴管理
- SSL 憑證 - 確保
springbucks.p12憑證檔案存在於 resources 目錄
- 克隆此倉庫：
git clone https://github.com/SpringMicroservicesCourse/http2-customer-service.git- 進入專案目錄：
cd http2-customer-service- 編譯專案：
mvn compile- 執行應用程式：
mvn spring-boot:run# 服務端 URL 設定
waiter.service.url=https://localhost:8443
# SSL 憑證設定
security.key-store=classpath:springbucks.p12
security.key-pass=spring# application.properties 主要設定
waiter.service.url=https://localhost:8443 # 服務端 HTTPS 端點
security.key-store=classpath:springbucks.p12 # SSL 憑證檔案路徑
security.key-pass=spring # 憑證密碼@Bean
public ClientHttpRequestFactory requestFactory() {
// 載入 SSL 憑證檔案
KeyStore keyStore = KeyStore.getInstance(KeyStore.getDefaultType());
keyStore.load(this.keyStore.getInputStream(), keyPass.toCharArray());
// 初始化信任管理器
TrustManagerFactory tmf = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm());
tmf.init(keyStore);
// 建立 SSL 上下文
SSLContext sslContext = SSLContext.getInstance("TLS");
sslContext.init(null, tmf.getTrustManagers(), null);
// 配置 OkHttp 客戶端支援 HTTP/2
okHttpClient = new OkHttpClient.Builder()
.sslSocketFactory(sslContext.getSocketFactory(), (X509TrustManager) tmf.getTrustManagers()[0])
.hostnameVerifier((hostname, session) -> true)
.build();
}@Bean
public RestTemplate restTemplate(RestTemplateBuilder builder) {
return builder
.setConnectTimeout(Duration.ofMillis(100)) // 連線超時設定
.setReadTimeout(Duration.ofMillis(500)) // 讀取超時設定
.requestFactory(this::requestFactory) // 使用自定義的 HTTP 工廠
.build();
}| 項目 | 說明 | 建議做法 |
|---|---|---|
| 安全性 | SSL 憑證管理 | 使用環境變數管理憑證密碼 |
| 效能 | HTTP/2 連線池 | 適當配置連線池大小 |
| 錯誤處理 | 網路異常處理 | 實作重試機制和錯誤回退 |
- 憑證管理 - 將敏感資訊如憑證密碼存放在環境變數中
- 連線超時設定 - 根據網路環境調整適當的超時時間
- 錯誤處理 - 實作完整的異常處理機制
- 日誌記錄 - 使用結構化日誌記錄關鍵操作
- 單元測試 - 為核心業務邏輯撰寫完整的測試案例
- 程式碼註解 - 在重要的程式碼區塊添加清楚註解，方便團隊成員理解與維護
- 命名規範 - 使用有意義的變數和方法名稱
- 模組化設計 - 將不同功能分離到不同的類別中
- 配置外部化 - 將設定值放在配置檔案中，便於環境切換
本專案採用 MIT 授權條款，詳見 LICENSE 檔案。
我們主要專注在敏捷專案管理、物聯網（IoT）應用開發和領域驅動設計（DDD）。喜歡把先進技術和實務經驗結合，打造好用又靈活的軟體解決方案。
- FB 粉絲頁：風清雲談 | Facebook
- LinkedIn：linkedin.com/in/chu-kuo-lung
- YouTube 頻道：雲談風清 - YouTube
- 風清雲談 部落格：風清雲談
- 電子郵件：fengqing.tw@gmail.com
📅 最後更新：2025年8月7日
👨💻 維護者：風清雲談團隊