**2019新春支付寶紅包技術大揭秘線上峰會將於03-07日開始，點選[這裡](https://tech.antfin.com/activities/216?info=zh)報名屆時即可參與大牛互動。**

## 概述
Java 11 自 2018.9.25 釋出以來，已經好幾個月了，在還沒正式 GA 之前都習慣性的去 [java-countdown.xyz](http://www.java-countdown.xyz/) check 釋出倒數計時。Java 11 有比較多的新功能，而其中最吸引我的

* Java 11 是 LTS 版本
  * 這意味著體驗 Java9 帶來的模組特性變得更有意義
* JavaFX 從 JDK 中移除，作為獨立模組

在 11 釋出時，JavaFX 也釋出了 11 的 GA 版本。JavaFX 本身並不新奇，但自 Java9 模組化後，JavaFX 得益於 jlink 的能力，能夠將 JavaFX 封裝為獨立的 GUI 應用，**不要求安裝JDK** 。這使得在桌面應用開發的場景，除了 Electron、Mono、QT 等跨平臺開發框架，Java 也能作為其中的一項選擇了。在 Swing 時代，Java的桌面應用開發體驗也不差（曾經做過的小遊戲 [wenerme/GTetris](https://github.com/wenerme/GTetris)），但由於累贅的 JDK （大約 150m）使得開發一個小應用變得不切實際。

JLink 可以將專案依賴的模組加上基礎VM來生成一個新的 JDK，應用的體積能夠大大減小，如果還能再配合 progard，那體積還能再縮小一圈。

## Motivation

基於體驗 Java11 和 JavaFX 的前提（每個Java程式設計師都會寫介面是常識？），將生成 [奧格人群服務化介面文件](https://yuque.antfin-inc.com/ikkuy/user-guide/api) 的生成器做成了一個 GUI 工具，原始碼在 [wener.cyw/tools](http://gitlab.alibaba-inc.com/wener.cyw/tools)。

工具下載地址見附件 - 只打包了 Mac 版應用，因為沒有 Windows。

## 安裝

從 Java 11 開始，Oracle 的 JDK 便不再建議使用了，因此首選 OpenJDK，而 OpenJDK 的二進位制提供方也有不少，在這裡推薦使用 [adoptopenjdk](https://adoptopenjdk.net/)，與 Oracle 不同的是，在這裡下載的 JDK 都是壓縮包，無須安裝，解壓就能使用，當然也不會有自動更新的能力。

**[點選前往下載](https://adoptopenjdk.net/archive.html?variant=openjdk11&jvmVariant=hotspot)**

下載後我解壓到了 `~/jdk` 目錄，然後建立軟連線 `~/jdk/11` 指向到了該版本。

## 開發
總結一下在整個過程中遇到的問題

1. 專案搭建 - 10%
2. 應用開發 - 20%
3. 生成 JDK - 非模組依賴轉模組依賴 - 50%
4. 應用打包 - 20%

### 專案搭建
搭建一個 Java 11 的 Maven 專案與搭建一個普通的專案區別並不大，只是會多一些配置，並且所有的依賴都需要使用最新的。

父 POM 的 build/plugins 配置說明

```xml

<plugin>
    <groupid>org.apache.maven.plugins</groupid>
    <artifactid>maven-compiler-plugin</artifactid>
    <version>3.8.0</version>
    <configuration>
        <release>11</release>
        <source>11<source>
        <target>11</target>
    </configuration>
</plugin>

<plugin>
    <groupid>org.apache.maven.plugins</groupid>
    <artifactid>maven-jar-plugin</artifactid>
    <version>3.1.0</version>
    <configuration>
        <outputdirectory>
            ${project.build.directory}/modules
        </outputdirectory>
    </configuration>
</plugin>

<plugin>
    <groupid>org.apache.maven.plugins</groupid>
    <artifactid>maven-dependency-plugin</artifactid>
    <version>3.1.1</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>copy-dependencies</goal>
            </goals>
            <configuration>
                <outputdirectory>
                    ${project.build.directory}/modules
                </outputdirectory>
                <includescope>runtime</includescope>
            </configuration>
        </execution>
    </executions>
</plugin>

<plugin>
    <groupid>org.apache.maven.plugins</groupid>
    <artifactid>maven-surefire-plugin</artifactid>
    <version>2.22.0</version>
    <configuration>
        <argline>
            --illegal-access=permit
        </argline>
        <forkcount>0</forkcount>
    </configuration>
</plugin>
<plugin>
    <groupid>org.apache.maven.plugins</groupid>
    <artifactid>maven-failsafe-plugin</artifactid>
    <version>2.22.0</version>
    <configuration>
        <argline>
            --illegal-access=permit
        </argline>
    </configuration>
</plugin>
```

應用專案的 build 配置

```xml
<build>
    
    <resources>
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.fxml</include>
            </includes>
        </resource>
        <resource>
            <directory>src/main/resources</directory>
        </resource>
    </resources>
    <plugins>
        
        <plugin>
            <groupid>org.codehaus.mojo</groupid>
            <artifactid>exec-maven-plugin</artifactid>
            <version>1.6.0</version>
            <executions>
                <execution>
                    <id>module-main-class</id>
                    <phase>package</phase>
                    <goals>
                        <goal>exec</goal>
                    </goals>
                    <configuration>
                        
                        <executable>/Users/wener/jdk/11/Contents/Home/bin/jar</executable>
                        <arguments>
                            <argument>
                                --update
                            </argument>
                            <argument> --file=${project.build.directory}/modules/${project.build.finalName}.jar
                            </argument>
                            
                            <argument> --main-class=me.wener.tools.app.AppMain
                            </argument>
                            <argument> --module-version=${project.version}
                            </argument>
                        </arguments>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>
```

最終的配置在 `mvn package`  後，會在 `target/modules` 目錄下看到所有的 jar 包。這裡的 jar 在生成 JDK 時會用到。

在專案搭建好後，建立出對應的子模組，且在子模組中 `src/main/java` 設定好 `module-info.java`

### 應用開發

JavaFX 的開發非常有意思，因為可以使用 FXML，開發的過程體驗與 React/Vue/Angular 這樣的前端開發體驗非常相似，只需要在 FXML 做好佈局，在 css 中定義好樣式，然後繫結好互動處理方法即可。

應用的啟動類

```java
public class AppMain extends Application {
    public static void main(String[] args) {
        launch(args);
    }

@Override
    public void start(Stage stage) throws Exception {
        Parent root = FXMLLoader.load(getClass().getResource("scene/Main.fxml"));

Scene scene = new Scene(root, 640, 480);
        stage.setTitle("@文邇 的小工具");
        stage.setScene(scene);
        stage.show();
    }
}
```
因為是基於 fxml，啟動類只需要將該場景初始化展示即可。

一個 fxml 的基本框架

```xml
<?xml version="1.0" encoding="UTF-8"?>

<?import javafx.scene.control.*?="">
<?import javafx.scene.layout.*?="">
<?import javafx.stage.Screen?="">
<anchorpane fx:id="masterPane" xmlns="http://javafx.com/javafx/8.0.121" xmlns:fx="http://javafx.com/fxml/1" fx:controller="me.wener.tools.app.scene.MainScene">
</anchorpane>
```

其中比較關鍵的是 `fx:controller` 繫結了控制類 `me.wener.tools.app.scene.MainScene`。

因此在後續的 `action` 定義中可直接引用控制類上的方法，或者將頁面元素直接關聯到控制類。

繫結元素
![image.png](http://ata2-img.cn-hangzhou.img-pub.aliyun-inc.com/befbf896cc4a79cac2af89418a07e8f8.png)

元素關聯
![image.png](http://ata2-img.cn-hangzhou.img-pub.aliyun-inc.com/77efd6ea6662ec333b4a758a8a428310.png)

Intellij 比較智慧，可直接在這兩個地方互相跳轉。

```xml

<button mnemonicparsing="false" onaction="#doConvert" text="生成文件"></button>
```

### 生成 JDK

在 APP 開發完成後，即可為該 APP 生成一個定製的 JDK，該 JDK 只需要包含 APP 所需依賴，生成的 JDK 可重複使用，除非 APP 的依賴變更。

```bash
# 確保下面的 Java 命令是 Java 11 的
export PATH=$JAVA_11_HOME/bin:$PATH

# 檢視打包複製的模組
# 其中會發現很多 automatic 的模組
java --list-modules -p target/modules/

# 檢視主應用 jar 的依賴請求
jdeps  --module-path target/modules/ target/modules/tools-app-1.0-SNAPSHOT.jar

# 生成 JDK 到該目錄 jdk/Contents/Home/jre
# add-modules 的列表來自於 module-info 的定義
jlink --strip-debug --compress 2 \
    --no-header-files --no-man-pages \
    --output jdk/Contents/Home/jre \
    -p $PWD/target/modules \
    --add-modules javafx.controls,javafx.fxml,com.google.common,com.github.javaparser.core,com.github.javaparser.symbolsolver.logic,com.github.javaparser.symbolsolver.model,me.wener.tools.core
```

但在生成 JDK 時會發現異常

```
Error: automatic module cannot be used with jlink: com.github.javaparser.symbolsolver.logic from xxx.jar
```

異常的原因是 jlink 不支援 automatic 的模組，所謂 automatic 模組，指的是沒有 module-info 的模組，但在 jar 的 `META-INF/MANIFEST.MF` 中定義了 `Automatic-Module-Name` 資訊。

針對這類 jar，唯一能比較好的處理方式

1. 生成 module-info.java
2. 解包
3. 編譯 module-info.java
4. 更新 jar

一下以 javax.inject 為案例

```bash
wget http://central.maven.org/maven2/javax/inject/javax.inject/1/javax.inject-1.jar

# 檢視依賴情況，非模組化的 jar 依賴和模組化 jar 的依賴現實不同
# 輸出: javax.inject-1.jar -> java.base
# 模組化的 jar 輸出: javax.inject -> java.base
jdeps javax.inject-1.jar

# 生成 module-info.java
jdeps --generate-open-module info javax.inject-1.jar
# 解壓 jar
unzip javax.inject-1.jar -d classes/
# 編譯 module-info.java
javac -p javax.inject -d classes/ info/javax.inject/module-info.java
# 更新 jar
jar uf javax.inject-1.jar -C classes/ module-info.class
# 再次檢視依賴
jdeps javax.inject-1.jar
```

其中 `info/javax.inject/module-info.java` 的內容為

```
open module javax.inject {
}
```

接下來的一段時間便是將所有用到的依賴進行這樣的轉換，其中需要注意的是 **間接依賴也需要模組處理**。其中最難處理的是 guava，因為需要將 guava 模組化，也需要它依賴的所有模組都存在。

```
open module com.google.common {
    requires j2objc.annotations;
    requires java.logging;
    requires jdk.unsupported;
    requires jsr305;

requires transitive error.prone.annotations;

}
```

因此為了將 guava 模組化，需要從 maven 上下載所有的這些 jar 並進行模組化。

完成所有的模組化後，再次透過 jlink 生成 jdk 到 `jdk/Contents/Home/jre`，之所以生成到這樣的一個目錄，是因為在應用打包時能符合預設的 Java 目錄結構。

```bash
# 使用生成的 JDK 來執行應用
./jdk/Contents/Home/jre/bin/java -Xmx64m --upgrade-module-path target/modules -m me.wener.tools.app

# 生成的 JDK 大約 50m - 對此已經非常滿意了，Electron 一般都是 100m 左右
du -s jdk/
```

### 應用打包

應用打包主要是將現在已經能執行的 jdk 環境打包為一個 macOs 的 app。打包器有不同的選擇，但用下來還是 jar2app 比較好用。如果需要打包其它平臺應用，需要選擇其它平臺的打包器。

```bash
git clone https://github.com/Jorl17/jar2app
# jar2app 是 Python 指令碼，因此需要 Python 環境
# 打包，使用自定義 jdk target/jdk
./jar2app/jar2app ./target/modules/tools-app-1.0-SNAPSHOT.jar -r target/jdk/ -b me.wener.tools -n WenerTools -j "-Xmx64M --upgrade-module-path $APP_ROOT/Contents/PlugIns/jdk/modules"

# 最終打包後的應用約 50m
# 50M     WenerTools.app
du -s WenerTools.app

# 雙擊啟動或命令列啟動
open WenerTools.app
```

一切大功告成，一個 APP 就此誕生了！如果還想要提交到 AppStore，這個過程還會需要其他的不少步驟，在這就不詳細說明啦。

## 總結

應用開發過程，打包過程都還是比較愉快的，最困難的是模組化 jar 的處理，因為很多模組都還沒有 module-info.java，導致大部分的 jar 都得先處理一遍，不過這個過程是可以累計的，被處理過的 jar 可以被重複利用。如果不需要配合 jlink，那麼是不需要處理的。

Java 11 意味著 Java 9、10、11 的所有新特性，JavaFX 開發也異常的簡單，整個過程還是很爽的！
點選[閱讀更多](https://tech.antfin.com/articles?chInfo=zh)，檢視更多詳情</?import></?import></?import>

Java11 & JavaFX 初體驗 - Java 程式碼生成 Markdown 的小工具

相關文章