JDK 11 把 JavaFX 剝離了出來,形成了單獨且開源的 OpenJFX 模塊。
本文的目的是通過簡單的例子解釋這一變化對使用 JavaFX 所造成的影響,並找到一種在 IDEA 2018.2 上使用它的辦法。
首先,OpenJFX 官網的入門文檔指示我們手動下載 SDK,但在 maven 的幫助下這不是必須的。雖然同樣得下載,但這被 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。
根據 IDEA 的提示 Import Changes,或者手動:右鍵 pom.xml
- Maven - Reimport。
注意:這裏沒有使用 maven.compiler.source
和 maven.compiler.target
這兩個 property。這兩個 property 是作爲參數定義在 maven-compiler-plugin
裏的,分別對應於源代碼的 Java 版本和目標代碼的 Java 版本。因爲 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 運行時組件, 需要使用該組件來運行此應用程序
模塊化 Java 程序與非模塊化 Java 程序的啓動方式有所不同。
# 非模塊化
java [options] mainclass [args...]
# 模塊化
java [options] [--module-path modulepath] --module module[/mainclass] [args...]
提供了 module-info.java
的話,IDEA 發現這是模塊化的 Java 程序。以上例爲例,啓動命令是:
java ${OPTIONS} -m ${METHOD_PATH} -m sample/sample.JFXMain
否則,IDEA 會認爲這是非模塊化 Java 程序,啓動命令是:
java ${OPTIONS} -classpath ${CLASS_PATH} sample.JFXMain
但這報錯具體是什麼代碼引起的呢?我們在 JDK 11 的 sun.launcher.LauncherHelper
發現:如果 JFXMain
繼承自 javafx.application.Application
,同時程序從 JFXMain.main()
啓動,LauncherHelper
會檢查是否存在模塊 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");
}
...
}
}
}
顯然,如果不以模塊化 Java 程序的方式啓動,沒有模塊信息。錯誤碼 java.launcher.cls.error5
即爲 “錯誤: 缺少 JavaFX 運行時組件, 需要使用該組件來運行此應用程序。”
不過我們還有其他辦法來繞開 LauncherHelper
的檢查,能夠以非模塊化 Java 程序的方式運行程序。思路是:使程序的入口 main()
不繼承自 javafx.application.Application
。
因此,我們可以使用 maven 來運行程序,因爲 maven 的 main()
顯然滿足該要求。這用到了 exec-maven-plugin
,這個插件是默認包含的,我們可以直接使用它的 property exec.mainClass
。
修改 pom.xml
:
<properties>
...
<exec.mainClass>sample.JFXMain</exec.mainClass>
...
</properties>
運行命令如下:
mvn clean 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。
原文鏈接 https://blog.xupu.name/p/using-openjfx-in-intellij-idea/