module-info.java 深度解析OpenJFX Samples 展示的 JavaFX 模块化最佳实践【免费下载链接】samplesJavaFX samples to run with different options and build tools项目地址: https://gitcode.com/gh_mirrors/samples5/samplesJavaFX 模块化开发绕不开一个文件——module-info.java。它是 Java 模块系统的入口也是 JavaFX 项目能否跑起来的关键。OpenJFX Samples 官方示例仓库用 14 份真实项目从命令行到 IntelliJ、Eclipse、NetBeans、VSCode 四大 IDE再到 Maven 与 Gradle 两种主流构建工具完整演示了module-info.java在 JavaFX 模块化项目中的标准写法。这篇文章带你从零看懂这个文件掌握 JavaFX 模块化项目的最佳实践让你新建项目时少踩坑。什么是 module-info.java为什么 JavaFX 项目离不开它module-info.java是 Java 9 引入的模块系统JPMS的声明文件。它位于模块源码的根目录用module关键字声明模块名并描述这个模块的边界依赖了哪些模块requires、对外暴露哪些包exports、允许哪些模块反射访问内部包opens。JavaFX 本身就是按模块拆分的例如javafx.controls、javafx.fxml都是独立模块。在一个模块化的 JavaFX 项目里如果没有module-info.java编译器根本无法找到 JavaFX 的类运行时也会报 module not found 错误。可以说module-info.java 是 JavaFX 模块化项目的身份证和通行证。OpenJFX Samples 展示的两种核心写法在 OpenJFX Samples 仓库中所有模块化示例的module-info.java只有两种变体覆盖了绝大多数真实场景。写法一最简版——纯代码界面这是最简单的模块化声明对应不需要 FXML 的 HelloFX 示例见 CommandLine/Modular/CLI/hellofx/src/module-info.javamodule hellofx { requires javafx.controls; exports hellofx; }只需要两行requires javafx.controls声明依赖 JavaFX 控件模块界面按钮、标签都在这里exports hellofx把业务代码包暴露出去供运行时访问。写法二FXML 进阶版——引入反射与 FXML当项目使用 FXML 分离界面与逻辑时module-info.java要多出两个关键指令见 CommandLine/Modular/Maven/hellofx/src/main/java/module-info.javamodule hellofx { requires javafx.controls; requires javafx.fxml; opens org.openjfx to javafx.fxml; exports org.openjfx; }这里多出的requires javafx.fxml和opens org.openjfx to javafx.fxml是新手最容易遗漏、也是最容易报错的两行——FXML 加载器通过反射读取控制器类必须显式开放包权限否则运行时会抛出IllegalAccessError。module-info.java 在项目中的正确位置OpenJFX Samples 用不同构建工具的项目告诉你同一个文件位置随构建工具而变。这是新手最常见的困惑点。构建方式module-info.java 所在路径示例位置纯命令行src/module-info.javaCommandLine/Modular/CLIMavensrc/main/java/module-info.javaCommandLine/Modular/MavenGradlesrc/main/java/module-info.javaCommandLine/Modular/Gradle放错位置编译器会直接忽略它导致项目莫名其妙失去模块支持。记住一句话module-info.java 必须与你的源码根包在同一层级。五大指令速查requires、exports、opens 一次讲透OpenJFX Samples 各示例反复使用的指令只有五个理解它们就掌握了 90% 的写法requires声明本模块依赖的其他模块。JavaFX 用哪个功能就 requires 哪个如javafx.controls、javafx.fxmlrequires transitive传递依赖。如果你的模块被别人依赖且希望把 JavaFX 一并传递出去用它最省事exports对外开放包其他模块才能import这里的类opens仅开放反射访问不开放编译期 importFXML、序列化、Spring 这类框架必须要它uses/provides服务提供者接口SPI日常开发中用得较少遇到再学即可。记住一个口诀编译要requires对外要exports反射要opens。三种构建工具运行模块化项目的最快方法OpenJFX Samples 最大的价值是同一份模块化代码分别用命令行、Maven、Gradle 演示。下面是最快的上手路径。命令行直接跑进入模块化 CLI 示例目录先编译再运行javac --module-path $PATH_TO_FX --add-modules javafx.controls -d out src/module-info.java src/hellofx/HelloFX.java java --module-path out:$PATH_TO_FX -m hellofx/hellofx.HelloFXMaven 一键运行Maven 项目在 pom.xml 中声明了javafx-controls、javafx-fxml依赖和 javafx-maven-plugin直接执行mvn javafx:runGradle 任务面板运行Gradle 项目通过javafx扩展声明模块在 build.gradle 中指定mainModule hellofx然后在 VSCode 的 Gradle 面板点击application → run即可启动如上图所示。三大最佳实践照抄 OpenJFX Samples 就对了1. 按需 requires别贪多对照 CommandLine/Modular/CLI/hellofx/src/hellofx/HelloFX.java 会发现只用 Label 和 Scene就只 requiresjavafx.controls用 FXML 才加javafx.fxml。最小化依赖能让模块边界清晰、启动更快。2. FXML 项目务必 opens 给 javafx.fxml这是 OpenJFX Samples 所有 FXML 示例如 IDE/IntelliJ/Modular/Maven 的 module-info.java的统一写法。漏写opens是模块化 JavaFX 项目最常见的运行时崩溃原因务必牢记。3. 统一包名与模块名规范示例中模块名与包名保持同源命名如模块hellofx、包org.openjfx这样的命名约定让exports一目了然也便于后续用 jlink 打包精简运行时。小结module-info.java看似只有几行却是 JavaFX 模块化项目的灵魂。OpenJFX Samples 仓库用横跨 4 大 IDE、3 种构建工具的 14 个真实项目给出了这份文件的标准答案简单项目两行搞定FXML 项目加上 opens位置跟着构建工具走。对照仓库示例动手跑一遍你就能彻底告别 module not found 与 IllegalAccessError写出规范的 JavaFX 模块化应用。【免费下载链接】samplesJavaFX samples to run with different options and build tools项目地址: https://gitcode.com/gh_mirrors/samples5/samples创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
