建立 Java 模組範例 - Gradle 繁體中文

您可以使用 IntelliJ 的 Gradle 匯入或 Eclipse Buildship 在 IDE 中開啟此範例。

此範例說明如何建立包含 Java 模組的多專案。Java 模組是 Java 本身的一項功能，自 Java 9 起提供，可提供更好的封裝。

在 Gradle 中，每個包含 Java 來源的來源組都可以透過新增 module-info.java 檔案轉換為模組。通常，在像這樣的具有 Java 模組的專案中，子專案的主要來源組會代表一個模組。

src
└── main
    └── java
        └── module-info.java

在 module-info.java 檔案中，您可以使用 requires 或 requires transitive 等關鍵字定義對其他模組的依賴關係。這些關鍵字對應於 Gradle 建置檔案中定義的 implementation 和 api 依賴關係。此外，模組會exports應對消費者可見的套件。其他套件在模組外不可見。

module org.gradle.sample.utilities {
    requires transitive org.gradle.sample.list;
    exports org.gradle.sample.utilities;
}

需要存取模組內部的單元 (白盒) 測試可以透過不將 module-info.java 新增到測試來源組以傳統方式撰寫。在測試執行期間，模組會被視為封裝已停用的標準 Java 函式庫。

Blackbox（例如整合）測試，在測試執行期間也應遵循封裝規則，可透過將對應的測試來源設定本身轉換為模組，藉由新增 module-info.java 來撰寫。這在這個延伸範例中有說明。