核心理念：封裝是管理複雜度的基石
高內聚的封裝意味著：相關類聚合於同一包，共同完成一個明確的業務領域或技術職責。Java I/O (java.io)、集合框架 (java.util) 是教科書級範例：類之間緊密協作、介面清晰、對外暴露最小必要集合。
五大封裝設計啟發式原則
原則 1：構建高內聚封裝
- 類不應孤立存在，而應作為封裝內協作單元。
- 低內聚封裝：類功能碎片化、相互依賴混亂、使用者需拼湊多個類才能完成簡單任務，維護極其困難。
- 高內聚封裝提供功能完整的模組化介面，升級維護只影響內部實現，外部調用者無感。
原則 2：考量封裝內容對復用的影響
- 設計時預判「誰會用這個封裝？如何用？還會和哪些外部類交互？」
- 成熟封裝 = 完整、可復用的組件集合。外部依賴應通過介面/抽象類隔離，而非具體實現。
原則 3：強調封裝的復用層面
- 封裝隱藏了大量實現細節，使用者只需理解做什麼（介面契約），而非怎麼做。
- 開發者必須深入理解封裝功能邊界與通訊協議（方法簽名、異常契約、線程安全承諾）。
原則 4：以簡化方式設計封裝介面
- 封裝介面應比單一類介面更簡潔、語義更豐富（門面模式）。
- 挑戰：使用者需建立正確的心智模型，文檔與範例代碼至關重要。
原則 5：提供完整且穩定的封裝介面
- 公開介面 = 公共類 + 公共方法。一旦發布，變更將波及所有調用方。
- 介面設計原則：最小暴露、語義穩定、向後相容。
- 第三方調用無猶豫，信任源於介面契約的嚴謹性。
關鍵落地檢查清單
| 維度 | 關鍵動作 |
|---|
| 發布介面 | 極簡化，僅暴露必要進入點；內部類預設 package-private |
| 設計複雜度 | 避免過度設計；提供 Quick Start、FAQ、遷移指南 |
| 部署單元 | 類 -> 封裝 -> JAR/Module (JPMS)，各層級均保持高內聚 |
| 嚴肅對待 | 胡亂封裝 = 胡亂結果 = 維護危機；投入架構評審、API 審查 |
下一步：深化封裝設計
後續將探討：封裝版本演進策略、模組化系統 (JPMS) 實踐、架構測試守護封裝邊界 (ArchUnit)，助你構建經得起時間考驗的 Java 系統架構。
