Java 套件機制深度解析：封裝設計、巢狀結構與 Package 物件

套件設計核心原則

高內聚：功能相關類別聚合

套件應只包含功能上緊密相關的類別與介面。同一套件內的類別可自由存取非 private 成員，若混入無關類別會導致耦合度過高、命名衝突風險增加。

邏輯分組：便於發現與重用

良好的套件結構如同圖書館分類系統，讓開發者快速定位所需元件。例如 com.company.project.service、com.company.project.repository 清楚表達架構分層。

巢狀套件與命名規範

點分隔命名建立層級

// 來源檔案開頭宣告
package com.myapp.adaptive.neuralnet;

// 目錄結構對應
src/
└── com/
    └── myapp/
        ├── adaptive/              // 父套件：通用自適應演算法
        │   ├── neuralnet/         // 子套件：類神經網路實作
        │   └── genetic/           // 子套件：遺傳演算法實作
        └── util/                  // 獨立工具套件

重要特性

• 巢狀僅為邏輯分組與命名空間管理，不提供額外存取權限
• adaptive.genetic 無法存取 adaptive.neuralnet 的 package-private 成員

套件文件化：package-info.java

標準做法

在套件目錄下建立 package-info.java，僅包含套件宣告與 Javadoc 註解：

/**
 * 自適應系統核心演算法套件
 * 包含類神經網路、遺傳演算法等實作
 *
 * @version 2.1.0
 * @author Architecture Team
 * @since 1.0
 */
@PackageSpec(name="Adaptive Core", version="2.1.0")
@DevelopmentModel("open-source")
package com.myapp.adaptive;

優勢

• 集中管理套件層級元資料（版本、作者、規格）
• Javadoc 產生的套件文檔自動包含此說明
• 避免分散在各類別的套件註解難以維護

Package 物件：執行期版本資訊查詢

核心方法

版本相容性檢查

Package pkg = Package.getPackage("java.lang");
String specVer = pkg.getSpecificationVersion(); // "1.8"
boolean compatible = pkg.isCompatibleWith("1.7"); // true，向後相容
// 規則：逐段數字比較，缺位視為 0，1.8 > 1.7.0 相容

取得 Package 物件三種方式

// 1. 從 Class 物件
Package pkg1 = String.class.getPackage();

// 2. 靜態方法查詢 (由當前類載入器搜尋)
Package pkg2 = Package.getPackage("java.util");

// 3. 取得所有已知套件
Package[] allPkgs = Package.getPackages();

密封套件：安全性與完整性

• 在 JAR 的 MANIFEST.MF 中宣告：Name: com/myapp/internal/ Sealed: true
• 密封後該套件所有類別必須來自同一 JAR/URL，防止惡意擴充
• 適用於核心 API、SPI 實作等敏感套件

最佳實踐總結

1. 依功能領域劃分套件，而非依技術層 (DAO/Service/Controller 混雜反模式)
2. 公開 API 套件命名穩定，內部實作套件用 .internal 後綴
3. 每個套件建立 package-info.java 記錄版本與職責
4. 善用 Package 物件實現執行期版本檢查與相容性驗證
5. 敏感套件啟用密封機制