为何 Blah.class.getModule() 返回 Unnamed Module 而非 BlahModule?
结论
要让 Blah.class.getModule() 返回名为 BlahModule 的模块,运行时就必须将 Blah 作为该命名模块中的类加载。创建 module-info.java,甚至成功编译出 module-info.class,都不能保证运行时会这样加载。
对于常规的命令行应用,应将模块的编译产物放到 module path,并按模块方式启动:
java --module-path out -m BlahModule/com.example.Main
如果把同一份编译产物放到 class path,按下面的方式启动,应用类就会属于 unnamed module:
java -cp out com.example.Main
题目没有提供编译命令和启动配置,目前还无法定位问题。建议先检查实际启动参数。
为什么有 module-info.java 仍然不够
JLS 中关于 compilation unit 的规则描述编译器如何处理源代码;Class.getModule() 查询的则是已加载的类所属的运行时模块。根据官方 API 文档,getModule() 的结果取决于运行时的类加载环境。参见 Class 文档
当模块化 JAR 或编译输出目录作为普通 class path 条目使用时,其中的 module-info.class 不会让这些类自动成为命名模块的成员。因此,编译时的模块关联和运行时的模块归属需要分别检查。
无论在哪个类中调用,Blah.class.getModule() 返回的都是 Blah 所属的模块。所有未归入命名模块的类型,都属于其定义类加载器对应的 unnamed module。参见 Module 文档
observable 在这里是什么意思
在相关 JLS 条款中,一个编译单元是否 observable,取决于宿主系统是否在这次编译中认定它可供编译器处理。
文件存在于磁盘上,或出现在 IDE 的项目树里,并不代表它就是 observable。JLS 将源代码的存储和发现方式留给宿主系统,没有规定一套适用于所有编译器和构建工具的目录扫描算法。参见 JLS §7.2
使用 javac 时,实际行为取决于传入的源文件、源码目录和相关路径选项。例如:
- 可以在命令行中直接指定参与编译的
module-info.java和普通源文件。 - 编译多个模块时,可以通过
--module-source-path指定模块源码的位置。 - 已编译的依赖模块可以通过
--module-path提供。
具体规则见 javac 文档。
“类与模块的关联严格取决于模块声明是否 observable”这个理解还不完整。发现模块声明后,宿主系统仍需确定哪些普通编译单元属于该模块。运行时还必须建立相应的模块配置,并加载其中的类。
最小可用示例
以下示例使用 JDK 9 及以上版本支持的模块功能,只有一个模块,不需要额外依赖。
1. 准备源码
目录结构:
src/
├── module-info.java
└── com/
└── example/
├── Blah.java
└── Main.java
src/module-info.java:
module BlahModule {
}
src/com/example/Blah.java:
package com.example;
public class Blah {
}
src/com/example/Main.java:
package com.example;
public class Main {
public static void main(String[] args) {
Module module = Blah.class.getModule();
System.out.println(module);
System.out.println(module.isNamed());
System.out.println(module.getName());
}
}
这里的访问都发生在同一个模块内,因此不需要 exports com.example;。
2. 编译模块
在 src 的上一级目录执行:
javac -d out src/module-info.java src/com/example/Blah.java src/com/example/Main.java
编译成功后,输出结构应为:
out/
├── module-info.class
└── com/
└── example/
├── Blah.class
└── Main.class
这种单模块编译方式直接指定了所有源文件,无须使用 --module-source-path。
3. 按模块方式启动
java --module-path out -m BlahModule/com.example.Main
预期输出为:
module BlahModule
true
BlahModule
其中:
--module-path out指定查找模块的位置。-m BlahModule/com.example.Main指定启动模块和主类。
模块名来自 module-info.java 中的声明,主类名使用完整类名。启动器的相关参数见 java 命令文档。
4. 对比 class path 启动
保持编译产物不变,改用:
java -cp out com.example.Main
此时,module.isNamed() 的预期结果为 false,module.getName() 为 null。直接打印模块对象时,会看到类似 unnamed module @... 的字符串,其中的标识值不固定。
仍然返回 unnamed module 时,检查什么
优先检查以下几处:
- 检查实际启动命令。IDE 或构建工具可能仍通过 class path 启动,需要查看运行配置和最终 JVM 参数。项目中存在
module-info.java,并不能说明程序已按模块方式启动。 - 确认实际加载的编译产物。运行目录或 JAR 中应包含正确的
module-info.class,同时排查 class path 中是否还有旧版或重复的Blah.class。 - 检查模块是否被解析。将模块放到 module path,只是提供了查找位置。示例通过
-m将BlahModule作为启动模块;采用其他启动方式时,需要结合requires或--add-modules检查解析配置。 - 检查类加载器。如果应用通过自定义类加载器或插件框架加载
Blah,还需确认框架是否建立了相应的命名模块。
可以在启动时查看模块解析过程:
java --show-module-resolution --module-path out -m BlahModule/com.example.Main
命名模块中的普通 Java 类需要放在命名 package 中,不能省略 package 声明。exports、opens 控制访问权限,无法将已加载到 unnamed module 的类改为命名模块成员,因此添加这些声明不能修复启动方式的问题。
备注:内容仅供参考。
