Intellij IDEA + JDK11 + OpenJFX (JavaFX) 简单样例

Oracle JDK11 把 JavaFX 剥离出来，形成了单独的 OpenJFX 库。

本文的目的是通过简单的例子解释这一变化对使用 JavaFX 所造成的影响，并找到一种在 IDEA 2018.2 上使用它的办法。

首先，OpenJFX 官网的入门文档指示我们手动下载 SDK，但在 maven 的帮助下这不是必须的。虽然同样得下载，但这被自动化了。

我们的 pom.xml 如下：

<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>sample</groupId> <artifactId>javafx</artifactId> <version>1.0-SNAPSHOT</version> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <mainClass>sample.JFXMain</mainClass> <javafx.version>11</javafx.version> </properties> <dependencies> <dependency> <groupId>org.openjfx</groupId> <artifactId>javafx-controls</artifactId> <version>${javafx.version}</version> </dependency> <dependency> <groupId>org.openjfx</groupId> <artifactId>javafx-fxml</artifactId> <version>${javafx.version}</version> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.8.0</version> <configuration> <source>11</source> <target>11</target> </configuration> </plugin> </plugins> </build> </project> 

这里引入了 OpenJFX 的依赖包，并设置了项目的 JDK 版本为 JDK 11。

根据提示 Import Changes（或者手动右键 pom.xml – Maven – Reimport）。

注意：这里没有用 maven.compiler.source 和 maven.compiler.target 这两个 property。因为 IDEA 目前对这两项的支持似乎不够好，不能同步到项目设置里。

注意：需要手动检查 Preferences – Build, Execution, Deployment – Compiler – Java Compiler 中 Project bytecode version 及 Per-module bytecode version 的值是否同为 11。理由同上。

我们的 Java 代码如下：

package sample; import javafx.application.Application; import javafx.fxml.FXMLLoader; import javafx.scene.Parent; import javafx.scene.Scene; import javafx.stage.Stage; public class JFXMain extends Application { @Override public void start(Stage primaryStage) throws Exception{ Parent root = FXMLLoader.load(getClass().getResource("/sample.fxml")); primaryStage.setTitle("Hello World"); primaryStage.setScene(new Scene(root, 300, 275)); primaryStage.show(); } public static void main(String[] args) { launch(args); } } package sample; public class Controller { } 

OpenJFX 布局描述文件 /src/main/resources/sample.fxml 如下：

<?import javafx.scene.layout.GridPane?> <GridPane fx:controller="sample.Controller" xmlns:fx="http://javafx.com/fxml" alignment="center" hgap="10" vgap="10"> </GridPane> 

Java 模块描述文件 /src/main/java/module-info.java 如下：

module sample { requires javafx.controls; requires javafx.fxml; // 暴露包 sample 给 javafx 的模块们，使其可以在运行时使用反射访问 opens sample to javafx.graphics, javafx.fxml; } 

以上便是在 JDK 11 中使用 OpenJFX 所需的全部铺垫了。

运行时提示 缺少 JavaFX 运行时组件, 需要使用该组件来运行此应用程序

如果忘了提供 module-info.java 的话，IDEA 启动 Java 程序的命令是：

java [options] mainclass [args...] java ${OPTIONS} -classpath ${CLASS_PATH} sample.JFXMain 

而 Java 11 的 sun.launcher.LauncherHelper 发现 JFXMain 继承自 javafx.application.Application，同时程序从 JFXMain.main() 启动，会检查是否存在模块 javafx.graphics 的声明：

package sun.launcher; public final class LauncherHelper { static final class FXHelper { private static void setFXLaunchParameters(String what, int mode) { ... Optional<Module> om = ModuleLayer.boot().findModule(JAVAFX_GRAPHICS_MODULE_NAME); if (!om.isPresent()) { abort(null, "java.launcher.cls.error5"); } ... } } } 

显然没有，因为连 module-info.java 都没有。

错误码 java.launcher.cls.error5 即为 “错误: 缺少 JavaFX 运行时组件, 需要使用该组件来运行此应用程序。”

相对地，IDEA 启动模块化 Java 程序的命令是：

java [options] [--module-path modulepath] --module module[/mainclass] [args...] java ${OPTIONS} -m ${METHOD_PATH} -m sample/sample.JFXMain 

其他方案：使用 Maven 绕过检查

使用 Maven 来运行程序，因为 Maven 的 main() 不继承自 javafx.application.Application，这自然地绕开了 LauncherHelper 的检查。

修改 pom.xml：

<properties> ... <exec.mainClass>sample.JFXMain</exec.mainClass> ... </properties> 

运行命令如下：

mvn compile exec:java 

其他方案：使用额外的启动类

我们也可以单独创建一个启动类：

package sample; import javafx.application.Application; public class AppMain { public static void main(String[] args) { Application.launch(JFXMain.class, args); } } 

从这个类启动 Java 程序，效果相同。

其他问题

Error: (4, 1) java: -source 8 中不支持 模块

根据上文所述，检查并修改 Project bytecode version。