迁移到模块
自动模块与未命名模块
迁移到模块 是 CoddyKit 上的免费 Java Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Java Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Java Academy 课程共包含 4 节课。
模块化现有代码
很少有项目从第一天起就采用模块。JPMS 的设计支持渐进式迁移，允许类路径和模块路径共存。
其中的关键是自动模块和未命名模块。
未命名模块
从类路径加载的所有内容都位于唯一的未命名模块中。它可以读取其他所有模块，并导出其中的所有包。
这是让旧版类路径代码继续运行的桥梁。
命名模块无法读取未命名模块
有一条关键规则：显式命名模块不能依赖未命名模块。您无法为类路径代码编写 requires。
因此，您需要自底向上进行迁移：先转换依赖项的表示形式。
自动模块
将普通的（非模块化）JAR 放到模块路径上，它就会成为一个自动模块。系统会为它自动派生名称，它可以读取其他所有模块，并导出其中的所有包。
这样，命名模块就可以对尚未包含 module-info 的 JAR 使用 requires。
名称的来源
自动模块的名称按以下优先顺序派生：
- 如果存在，则使用 JAR 清单中的
Automatic-Module-Name条目 - 否则使用 JAR 文件名（去掉版本号，并将连字符替换为点）
稳定名称很重要
库作者应在完全模块化之前，将 Automatic-Module-Name 添加到清单中。这样可以保证模块名称稳定，使下游的 requires 子句在最终加入真正的 module-info 后仍然有效。
Automatic-Module-Name: com.example.json自顶向下的策略
对于您自己的应用程序，建议采用以下方法：
- 将依赖项作为自动模块保留在模块路径上
- 首先将
module-info.java添加到您自己的顶层模块中 - 对这些自动模块的名称声明
requires
迁移步骤示例
假设 guava-32.jar 作为自动模块 com.google.common 位于模块路径上。您的应用程序模块已经可以依赖它。
module com.example.app {
requires com.google.common;
exports com.example.app.api;
}拆分包问题
模块系统禁止两个模块包含同一个包。旧版库将一个包拆分到多个 JAR 中时，就会产生错误。
您可以合并这些 JAR、使用 --patch-module，或升级到能够解决拆分问题的版本。
反射访问问题
执行深层反射的框架在您完成模块化后可能会因 InaccessibleObjectException 而失败。请添加 opens 指令，或者暂时使用 --add-opens 启动选项作为过渡方案。
实用的 jdeps 工具
jdeps 工具会分析您的 JAR，报告依赖关系，标记对 JDK 内部应用程序接口的使用，甚至可以使用 jdeps --generate-module-info 生成候选的 module-info.java。
请先运行它，以便规划迁移。
快速检查
请回忆普通 JAR 如何获得模块标识。
回顾
您已经学习了迁移技术：
- 类路径代码位于未命名模块中；命名模块无法依赖它
- 模块路径上的普通 JAR 会成为自动模块
- 设置
Automatic-Module-Name以获得稳定名称 - 留意拆分包和反射访问问题；使用
jdeps进行规划
JPMS 课程到此结束。
常见问题解答
「迁移到模块」课时是免费的吗？
是的 — 「迁移到模块」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Java Academy 课程的其余内容，请升级到 CoddyKit PRO。 Java Academy 课程共包含 4 节课。
「迁移到模块」这节课中我会学到什么？
自动模块与未命名模块 你通过在浏览器中直接运行的动手代码来练习 Java Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Java Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Java Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。
「迁移到模块」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Java Academy 课中编写并运行代码吗？
能。每节 Java Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。