Java模块化实战：创建与验证简单模块_技术教程

本文将指导您如何在java中创建一个简单的模块。核心步骤包括定义`module-info.java`文件以导出您的包，并确保将其正确打包为一个jar文件，其中`module-info.class`位于根目录。文章还将演示如何使用`jar`工具验证您创建的模块。

引言：Java模块化系统（Jigsaw项目）

Java平台模块系统（JPMS），也被称为Jigsaw项目，自Java 9引入，旨在提高Java应用程序的可伸缩性、安全性和性能。它通过将JDK和应用程序分解为离散的模块，实现了更强的封装性和更清晰的依赖管理。创建一个简单的Java模块是掌握JPMS的基础。

一、定义模块信息：module-info.java

一个Java模块的核心是其模块描述符文件module-info.java。这个文件定义了模块的名称、它导出的包、它依赖的其他模块以及它提供的服务等信息。对于一个简单的库，如果它仅依赖于java.base（这是所有模块的隐式依赖），并且只需要对外暴露一个包，那么module-info.java的结构会非常简洁。

1. 模块声明 在项目的顶层目录（通常是源代码根目录）创建module-info.java文件。

2. 导出包 使用exports关键字声明模块要对外提供的包。只有被导出的包，其公共类型才能被其他模块访问。

示例代码： 假设您的库包含在org.foo.bar.pkgname包中，您希望将其暴露给其他模块使用。

// src/main/java/module-info.java
module org.foo.bar {
    exports org.foo.bar.pkgname;
}

在这个例子中：

org.foo.bar是您的模块名称。
exports org.foo.bar.pkgname;表示模块org.foo.bar将org.foo.bar.pkgname包中的公共类和接口暴露给任何需要它的模块。

二、构建模块化的JAR文件

定义了module-info.java文件后，下一步是编译您的源代码并将其打包成一个可部署的JAR文件。这个JAR文件将成为一个“模块化JAR”（Modular JAR）。

1. 编译源代码 首先，您需要编译您的Java类和module-info.java文件。通常，您会使用javac命令。

# 假设您的源代码在 src/main/java 目录下
# 并且输出目录是 target/classes
javac -d target/classes src/main/java/org/foo/bar/pkgname/*.java src/main/java/module-info.java

这一步会将.java文件编译成.class文件，包括module-info.class。

2. 打包为模块化JAR 使用jar命令将编译后的类文件和module-info.class打包成一个JAR文件。关键在于module-info.class必须位于JAR文件的根目录。

预期的JAR文件结构：

bar.jar
├── module-info.class
└── org/
    └── foo/
        └── bar/
            └── pkgname/
                ├── X.class
                └── Y.class

示例打包命令：

# 假设编译后的类文件在 target/classes 目录下
jar --create --file bar.jar -C target/classes .

这里的-C target/classes .命令指示jar工具将target/classes目录下的所有内容（包括module-info.class和org目录）添加到JAR的根目录。

三、验证模块

创建了模块化JAR之后，您可以使用jar工具的--describe-module选项来验证它是否被正确识别为一个模块，并查看其模块描述符信息。

示例验证命令：

jar --describe-module --file bar.jar

预期输出示例：

bar.jar
org.foo.bar@1.0.0
exports org.foo.bar.pkgname
requires java.base mandated

（注意：@1.0.0是版本信息，如果JAR清单中没有指定，可能不会显示。mandated表示java.base是隐式依赖。）

如果输出显示了模块名称、导出的包以及java.base的依赖，那么恭喜您，您已成功创建并验证了一个简单的Java模块。

四、注意事项与总结

module-info.class的位置：务必确保modul
e-info.class文件位于JAR的根目录。这是识别一个JAR为模块的关键。
隐式依赖：所有模块都隐式依赖java.base，因此您无需在module-info.java中明确声明requires java.base;。
exports与opens：exports用于在编译时和运行时暴露包给其他模块访问。如果需要通过反射深度访问（即使是私有成员），则需要使用opens关键字。对于简单模块，exports通常足够。
更复杂的模块：当您的模块需要依赖其他自定义模块或JDK的其他模块（如java.sql, java.desktop等）时，您需要在module-info.java中使用requires关键字明确声明这些依赖。
```
module my.app {
    requires java.sql; // 声明对java.sql模块的依赖
    exports my.app.api;
}
```
版本管理：虽然本教程未涉及，但在实际项目中，模块通常会包含版本信息，这可以在module-info.java中通过module org.foo.bar { version "1.0"; ... }来指定，或通过JAR清单文件。