Java 模块化（JPMS）解析

Java 模块化（JPMS）深度解析

一、核心概念

Java Platform Module System（JPMS）是Java 9引入的模块系统，旨在解决以下问题：

强封装：明确控制包的可见性
可靠配置：显式声明模块依赖
可扩展性：支持更灵活的运行时组合
依赖管理：解决JAR地狱（JAR Hell）

核心元素：

module-info.java：模块声明文件
模块路径（--module-path）
关键字：module, requires, exports, opens, provides, uses

二、完整Demo示例

项目结构：

sql 复制代码

TEXT
demo/
├── service-api/
│   ├── src/
│   │   └── com.example.service/
│   │       ├── GreetingService.java
│   │       └── module-info.java
│   └── out/
├── service-impl/
│   ├── src/
│   │   └── com.example.impl/
│   │       ├── EnglishGreeting.java
│   │       └── module-info.java
│   └── out/
└── app/
    ├── src/
    │   └── com.example.app/
    │       ├── Main.java
    │       └── module-info.java
    └── out/

1. 服务接口模块（service-api/module-info.java）

java 复制代码

JAVA
module com.example.service.api {
    exports com.example.service;
}

2. 服务实现模块（service-impl/module-info.java）

arduino 复制代码

JAVA
module com.example.service.impl {
    requires com.example.service.api;
    provides com.example.service.GreetingService 
        with com.example.impl.EnglishGreeting;
}

3. 主应用模块（app/module-info.java）

arduino 复制代码

JAVA
module com.example.app {
    requires com.example.service.api;
    uses com.example.service.GreetingService;
}

服务发现示例（Main.java） ：

ini 复制代码

JAVA
ServiceLoader<GreetingService> loader = 
    ServiceLoader.load(GreetingService.class);
loader.findFirst().ifPresent(service -> 
    System.out.println(service.greet("World")));

编译命令：

sql 复制代码

BASH
javac -d out --module-source-path . -m com.example.service.api,com.example.service.impl,com.example.app

运行命令：

arduino 复制代码

BASH
java --module-path out -m com.example.app/com.example.app.Main

三、常见问题与解决方案

1. 模块路径问题

现象：module not found 错误

解决：

ruby 复制代码

BASH
# 显式指定模块路径
java --module-path out -m your.module/com.example.Main

2. 反射访问限制

现象：IllegalAccessError

解决：在模块声明中添加opens

arduino 复制代码

JAVA
module your.module {
    opens com.example.internal; // 开放反射访问
}

3. 传统JAR兼容性

现象：自动模块名称冲突

解决：

css 复制代码

BASH
# 将普通JAR转为自动模块
jar --update --file legacy.jar --manifest=MANIFEST.MF

在MANIFEST.MF中添加：

makefile 复制代码

PROPERTIES
Automatic-Module-Name: com.legacy.library

4. 循环依赖

现象：编译时cyclic dependence错误
解决方案架构：
1. 创建公共接口模块
2. 使用服务加载机制（ServiceLoader）
3. 重构依赖关系

5. 资源访问问题

现象：FileNotFoundException使用模块资源时

正确访问方式：

ini 复制代码

JAVA
InputStream is = getClass().getResourceAsStream("/config.properties");
// 或使用模块资源API
Module module = getClass().getModule();
InputStream is = module.getResourceAsStream("com/example/config.properties");

6. 动态加载问题

场景：需要运行时加载模块

解决方案：

ini 复制代码

JAVA
ModuleFinder finder = ModuleFinder.of(Paths.get("modules"));
ModuleLayer parent = ModuleLayer.boot();
Configuration cf = parent.configuration().resolve(finder, ModuleFinder.of(), Set.of("dynamic.module"));
ModuleLayer layer = parent.defineModulesWithOneLoader(cf, ClassLoader.getSystemClassLoader());

四、最佳实践

渐进式迁移：
- 从未命名模块开始
- 逐步添加module-info.java
- 使用requires static处理可选依赖

模块设计原则：

java 复制代码

JAVA
module your.module {
    requires transitive api.module;  // 传递依赖
    exports public.api.pkg;          // 严格导出
    opens reflection.access.pkg;     // 最小化开放范围
}

工具链整合：
- Maven：使用maven-compiler-plugin 3.6+
- Gradle：配置module-info.java支持
- IDE：IntelliJ的模块支持最完善

五、性能考量

启动优化 ：使用jlink创建定制运行时

lua 复制代码

BASH
jlink --module-path $JAVA_HOME/jmods:out \
      --add-modules com.example.app \
      --output custom-jre

层次化模块 ：利用ModuleLayer实现插件架构

六、典型迁移路径

scss 复制代码

TEXT
传统应用 → 自动模块 → 命名模块 → 模块化JRE

JPMS虽增加了开发复杂度，但为大型应用提供了清晰的架构边界和可靠的依赖管理。建议从新项目开始实践，逐步应用到遗留系统改造中。