本文旨在提供一个简洁明了的java模块创建指南。通过介绍`module-info.java`文件的编写、模块jar文件的正确组织结构，以及使用`jar`工具进行模块验证的方法，帮助开发者快速理解并实践java平台模块系统（jpms）中的基础模块化概念。
Java模块系统（JPMS），自Java 9引入，旨在提高Java应用的可靠性、安全性、性能和可维护性。它通过将代码组织成独立的模块，明确声明其依赖和导出的API，从而实现更强的封装性和更清晰的结构。创建一个简单的Java模块是掌握JPMS的第一步。
核心组件：module-info.java
创建Java模块的核心在于module-info.java文件。这个文件定义了模块的名称、它导出的包（即对其他模块可见的API），以及它所依赖的其他模块。对于一个只包含一个包的简单库，并且只依赖于java.base（所有Java模块隐式依赖的基础模块），module-info.java的内容会非常直接。
示例：module-info.java
假设你的库包含一个包org.foo.bar.pkgname，你希望将它暴露给其他模块使用。你的module-info.java文件将如下所示：
立即学习“Java免费学习笔记（深入）”；
module org.foo.bar {
exports org.foo.bar.pkgname;
}- module org.foo.bar：定义了模块的唯一名称。遵循反向域名约定是一个好的实践。
- exports org.foo.bar.pkgname：声明org.foo.bar.pkgname包中的所有公共类型（public classes and interfaces）都将对其他模块可见。
构建模块JAR文件
在编写完module-info.java文件和你的Java类之后，你需要将它们编译并打包成一个模块化的JAR文件。关键在于module-info.class文件必须位于JAR的根目录。
假设你的项目结构如下：
my-module-project/
├── module-info.java
└── org
└── foo
└── bar
└── pkgname
├── X.java
└── Y.java编译步骤：
-
编译Java源文件： 首先，你需要将module-info.java和你的所有Java类编译成.class文件。你可以创建一个输出目录（例如out）来存放这些编译后的文件。
# 假设当前工作目录是 my-module-project javac -d out module-info.java org/foo/bar/pkgname/*.java
这条命令会将module-info.class以及X.class、Y.class等编译后的类文件输出到out目录中，并保持原有的包结构。
-
创建模块JAR文件： 接下来，使用jar工具将out目录中的所有内容打包成一个模块化的JAR文件。
# 假设当前工作目录是 my-module-project jar --create --file bar.jar -C out .
这条命令会创建一个名为bar.jar的模块化JAR文件。-C out .表示将out目录下的所有内容（包括module-info.class和编译后的类文件）打包到JAR的根目录。
模块JAR文件结构
一个有效的模块化JAR文件必须将module-info.class文件放置在其根目录。典型的内部结构应如下所示：
bar.jar (内部结构)
├── module-info.class
└── org
└── foo
└── bar
└── pkgname
├── X.class
└── Y.class这种结构确保了JVM能够识别该JAR为一个模块。
验证模块
创建JAR文件后，你可以使用jar --describe-module命令来验证它是否被正确识别为一个Java模块，并查看其模块描述信息。
jar --describe-module --file bar.jar
如果一切设置正确，你将看到类似以下的输出：
bar.jar
module org.foo.bar@<版本号>
exports org.foo.bar.pkgname（注意：如果创建JAR时没有指定--module-version，版本号可能不会显示或显示为unnamed）
这表明bar.jar已被成功识别为名为org.foo.bar的模块，并导出了org.foo.bar.pkgname包。
注意事项与最佳实践
- 模块名称唯一性： 模块名称应是唯一的，并且通常建议使用反向域名约定，以避免命名冲突。
- 依赖声明： 简单模块可能只依赖于java.base。如果你的模块需要其他JDK模块（如java.sql, java.xml）或第三方库，你需要在module-info.java中使用requires指令明确声明这些依赖。
- 工具链： 虽然上述示例使用了javac和jar命令行工具，但在实际项目中，通常会使用Maven或Gradle等构建工具来自动化模块的编译、打包和依赖管理。这些工具提供了更便捷的方式来配置和构建模块。
- 强封装性： 模块系统强制执行强封装。只有通过exports导出的包才对其他模块可见。未导出的包中的类型在模块外部是无法访问的，即使它们是公共类型。
总结
创建一个简单的Java模块涉及定义module-info.java文件来声明模块的名称和导出的包，然后将编译后的module-info.class与你的类文件一起打包成一个特定结构的JAR。最后，使用jar --describe-module命令可以方便地验证模块的正确性。掌握这些基础知识是深入理解和利用Java模块系统强大功能的第一步。
