海创软件组-20200531-JavaFx+Spring Boot+Maven搭建与打包部署窗体程序

资料摘抄与引用来源

１．​​JavaFx中文网站​​​ ２．​​使用SpringBoot接管javafx​​

第一部分:基础信息概览

1. JavaFx是什么

JavaFx是一个强大的图形和多媒体处理工具集合,它允许开发者来设计,创建,调试和部署富客户端程序,并且和Java一样跨平台

2. JavaFx应用程序概览

由于JavaFX库被写成了Java API，因此JavaFX应用程序代码可以调用各种Java库中的API。例如JavaFX应用程序可以使用Java API库来访问本地系统功能并且连接到基于服务器中间件的应用程序。

JavaFX可以自定义程序外观。层级样式表（CSS）将外观和样式与业务逻辑实现进行了分离，因此开发人员可以专注于编码工作。图形设计师使用CSS来方便地定制程序的外观和样式。

如果你具有Web设计背景，或者你希望分离用户界面（UI）和后端逻辑，那么你可以通过FXML脚本语言来表述图形界面并且使用Java代码来表述业务逻辑。如果你希望通过非编码的方式来设计UI，则可以使用JavaFX Scene Builder。在你进行UI设计时，Scene Builder会创建FXML标记，它可以与一个集成开发环境（IDE）对接，这样开发人员可以向其中添加业务逻辑。

3. JavaFx8及以后版本新特性(本人使用的部分)

● Java API：

JavaFX是一个Java库，包括用Java写成的类和接口。其API对基于JVM的语言也是友好的，例如JRuby和Scala。

● FXML和Scene Builder：

FXML是一种基于XML的声明式标记语言，用于描述JavaFX应用程序的用户界面。设计师可以在FXML中编码或者使用JavaFX Scene Builder来交互式地设计图形用户接口（GUI）。Scene Builder所生成的FXML标记可以与IDE对接，这样开发者可以添加业务逻辑。

● WebView：

它是一个使用了WebKitHTML技术的Web组件，可用于在JavaFX应用程序中嵌入Web页面。在WebView中运行的JavaScript可以方便地调用JavaAPI，并且JavaAPI也可以调用WebView中的JavaScript。对附加的HTML5特性的支持，包括Web Socket、Web Worker、Web Font、打印功能等都被添加到了JavaFX8中。参考《增加HTML内容到JavaFX应用程序中（Adding HTML Content to JavaFX Applications）》章节来了解更多信息。

● 与Swing互操作：

现有的Swing程序可以通过JavaFX的新特性升级，例如多媒体播放和Web 内容嵌入。在JavaFX8中加入了SwingNode类，它可以将Swing内容嵌入到JavaFX程序中。参考SwingNode API Javadoc和《在JavaFX应用程序中嵌入Swing 内容（Embedding Swing Content in JavaFX Applications）》章节来了解更多信息。

● 内置的UI控件和CSS：

JavaFX提供了开发一个全功能应用程序所需的所有主要控件。这些组件可以使用标准的Web技术如CSS来进行装饰。在JavaFX8中，DatePicker和TreeView UI控件是可用的，并且可以使用标准的Web技术如CSS来进行美化。参考《使用JavaFX UI控件（Using JavaFX UI Controls）》章节来了解更多信息。另外CSS样式控制类都变成了公开API，它们可以使用CSS来为对象增加样式。

● 自包含的应用部署模型：

自包含应用包具有应用所需的所有资源、包括一个Java和JavaFX运行时的私有拷贝。它们可作为操作系统原生安装包发布，并提供与原生应用相同的安装和运行体验。

4. JavaFX可以构建什么

使用JavaFX你可以构建各种类型的应用程序。一般来说，它们是联网应用，可以跨平台部署，并且可以在一个具有高性能现代UI中展现信息，支持音频、视频、动画等特性。

第二部分:工具环境与打包部署配置

5. Spring Boot集成JavaFx的maven配置

• Spring Boot与JavaFx8匹配使用的库:​​spring-boot-javafx-support​​
• 集成spring-boot-javafx-support的Maven配置

<dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>de.roskenet</groupId>
            <artifactId>springboot-javafx-support</artifactId>
            <version>2.1.6</version>
        </dependency>
        <dependency>
        <groupId>de.roskenet</groupId>
        <artifactId>springboot-javafx-test</artifactId>
        <version>1.3.0</version>
        <scope>test</scope>
        </dependency>

    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
            <plugin>
                <groupId>com.zenjava</groupId>
                <artifactId>javafx-maven-plugin</artifactId>
                <version>8.8.3</version>
                <configuration>
                    <!-- 启动类 -->
                    <mainClass>cn.hctech2006.product.product.ProductApplication</mainClass>
                    <!-- 公司名称 -->
                    <vendor>海创软件组</vendor>
                    <!-- 应用名称 ${project.build.finalName} = ${project.artifactId}-${project.version} -->
                    <appName>${project.build.finalName}</appName>
                    <!-- 发行版本 -->
                    <nativeReleaseVersion>${project.version}</nativeReleaseVersion>

                </configuration>
            </plugin>

        </plugins>
    </build>

</project>

<mainclass>cn.hctech2006.product.product.ProductApplication<mainclass>
是主启动类
<vendor>海创软件组</vemdor>是所属公司名称

6. IDEA集成JavaFx Builder Scene

6.1 JavaFx Builder Scene概述

JavaFX Scene Builder 是一个可视化布局工具，可快速设计 JavaFX 应用程序用户界面，无需编写代码。用户可以拖放UI组件到工作区，修改组件的属性，应用样式表，而且在后台自动生成所创建布局的 FXML 代码。最后得到的是一个可以稍后与 Java 项目整合到一起的 FXML 文件，从而将 UI 与应用程序逻辑绑定起来。

6.2 JavaFx Builder Scene工具下载

• ​​下载地址:​​ 因为我是Ubuntu系统,所以采用如下图下载



• 
  
• 安装之后,打开软件界面如下:

我特别要强调的是左下角,拖动控件最好拖到左下角不要拖到中间

6.3 IDEA集成JavaFx Scene Builder

打开Intellij —>点击File—>点击settings—>Languages&Frameworks—>JavaFX, 在Path to SceneBuilder 中填入SceneBuilder的deb文件

需要说明,默认安装路径是图中的目录

7. JavaFx打包需要的Maven插件-javafx-maven-plugin

7.1项目地址

7.2javaFx Maven插件介绍

JavaFX Maven插件提供了一种从Maven内部组装JavaFX应用程序（8+和9+）的分发包的方法。

这个插件本质上是JavaFX附带的打包工具的Maven包装器，它称为javapackager

7.3 特定操作系统与环境版本的要求

（Windows）EXE安装程序：Inno安装程序
（Windows）MSI安装程序：WiX（至少3.7版）
（Linux）DEB安装程序：dpkg-deb
（Linux）RPM安装程序：rpmbuild
（Mac）DMG安装程序：hdiutil
（Mac）PKG安装程序：pkgbuild

Maven 3.5（旧版本可能也可以）
Java Developer Kit 8，至少具有Update 40

7.4 JavaFx JAR快速入门与打包可执行文件方法

• 将此添加到构建插件中的pom.xml中：

<plugin>
    <groupId>com.zenjava</groupId>
    <artifactId>javafx-maven-plugin</artifactId>
    <version>8.8.3</version>
    <configuration>
        <mainClass>your.package.with.Launcher</mainClass>
    </configuration>
</plugin>

使用JavaFX-magic创建可执行文件，请在命令行调用mvn jfx:jar.jar
文件将位于target/jfx/app,可执行文件将位于target/jfx/native

第三部分:基于Spring Boot架构的JavaFx项目开发流程

8. 使用FXML进行界面设计

8.1 创建Spring Boot工程并且集成所需的javaFx依赖和插件

8.2 创建ＦＸＭＬ布局文件

• 代码手写



• 使用 SceneBuilder 工具创建 FXML 文件

8.3 创建*View.java处理界面逻辑

• 新建一个class，继承AbstractFxmlView，并且添加注解

@FXMLView( value = "你的fxml的地址，相对于resource，注意要以斜杠/这个开头，否则找不到", css = {"你的css文件的位置，可以用多个，相对于resource"} )

(value = "/CustomerDetailsView.fxml")
public class CustomerDetailsView extends AbstractFxmlView {
}

8.4 新建*ViewController.java处理数据与事件逻辑

• 需要实现Initialzable接口，加上＠FXMLController注解

@FXMLController
public class CustomerDetailsViewController implements Initializable {
;

    @Override
    public void initialize(URL location, ResourceBundle resources) {



    }

8.5 MainStageView作为主页

这个是比较特殊的，在普通的 javafx 里面没有这个东西，但是按照 MVC 的角度来讲，业务和试图分离，还是很有必要的。

@FXMLView(value = "/MainView.fxml")
public class MainView extends AbstractFxmlView {
}

8.6 修改Application启动类

主类是需要继承AbstractJavaFxApplicationSupport这个类型，添加main方法和SpringBootApplication注解。我们使用launch方法代替SpringApplication.run，具体的可以看看AbstractJavaFxApplicationSupport的launch的实现：

(final Class<? extends Application> appClass,
                              final Class<? extends AbstractFxmlView> view, final String[] args);
 
/**
     * Launch app.
     *
     * @param appClass     the app class
     * @param view         the view
     * @param splashScreen the splash screen
     * @param args         the args
     */
    public static void launch(final Class<? extends Application> appClass,
                              final Class<? extends AbstractFxmlView> view, 
final SplashScreen splashScreen, final String[] args);
 
 /**
     * Launch app.
     *
     * @deprecated To be more in line with javafx.application please use launch
     * @param appClass     the app class
     * @param view         the view
     * @param splashScreen the splash screen
     * @param args         the args
     */
    @Deprecated
    public static void launchApp(final Class<? extends Application> appClass,
                              final Class<? extends AbstractFxmlView> view,
 final SplashScreen splashScreen, final String[] args);

• 继承了AbstractJavaFxApplicationSupport这个类，
• 需要一个view，作为启动的界面，
• main函数的参数args，
• 如果需要，使用SplashScreen作为闪屏，应用加载界面，

• 具体代码

@SpringBootApplication
public class ProductApplication extends AbstractJavaFxApplicationSupport  {

    public static void main(String[] args) {
        //SpringApplication.run(ProductApplication.class, args);
        //多个舞台并存
        launch(ProductApplication.class, LoginView.class,new SplashScreenCustom(),args);
    }

    @Override
    public void start(Stage stage) throws Exception {
        super.start(stage);
    }
    }

• 点击运行,可以看到一个javafx的窗口。



• 需要对窗口做出调整，应该使用GUIState类的静态方法获取Stage，当然，这个Stage就是主窗口的Stage了。

8.8 闪屏的实现

public class SplashScreenCustom extends SplashScreen {
    @Override
    public Parent getParent() { // 在这里可以设置闪屏窗口大小，默认图片大小
        return super.getParent();
    }

    @Override
    public boolean visible() { // 是否显示闪屏，默认显示
        return super.visible();
    }

    @Override
    public String getImagePath() {
        return "/heikediguo2.gif";
    }
}

重写getImagePath即可

9．JavaFx窗口的切换

9.1 切换窗口后，只保留一个窗口

主要用于登录跳转

(CustomerView.class);

9.2 切换窗口后，多个窗口并存

(CustomerView.class, Modality.NONE);

9.3 Modify概述

枚举常量和描述

• APPLICATION_MODAL 定义一个模式窗口，该窗口阻止事件传递到任何其他应用程序窗口。
• NONE 定义非模态且不阻止任何其他窗口的顶级窗口。
• WINDOW_MODAL 定义一个模式窗口，该窗口阻止事件传递到其整个所有者窗口层次结构。

9.4 第一种单个窗口显示的showView()源码

(Class<? extends AbstractFxmlView> newView) {
        try {
            AbstractFxmlView view = (AbstractFxmlView)applicationContext.getBean(newView);
            if (GUIState.getScene() == null) {
                GUIState.setScene(new Scene(view.getView()));
            } else {
                GUIState.getScene().setRoot(view.getView());
            }

            GUIState.getStage().setScene(GUIState.getScene());
            applyEnvPropsToView();
            GUIState.getStage().getIcons().addAll(icons);
            GUIState.getStage().show();
        } catch (Throwable var2) {
            LOGGER.error("Failed to load application: ", var2);
            showErrorAlert(var2);
        }

    }

9.5第二种多个窗口并存的showVIew()源码以及调用的主要方法

(Class<? extends AbstractFxmlView> window, Modality mode) {
        AbstractFxmlView view = (AbstractFxmlView)applicationContext.getBean(window);
        Stage newStage = new Stage();
        Scene newScene;
        if (view.getView().getScene() != null) {
            newScene = view.getView().getScene();
        } else {
            newScene = new Scene(view.getView());
        }

        newStage.setScene(newScene);
        newStage.initModality(mode);
        newStage.initOwner(getStage());
        newStage.setTitle(view.getDefaultTitle());
        newStage.initStyle(view.getDefaultStyle());
        newStage.showAndWait();
    }

() {
        String stageStyle = applicationContext.getEnvironment().getProperty("javafx.stage.style");
        if (stageStyle != null) {
            GUIState.getStage().initStyle(StageStyle.valueOf(stageStyle.toUpperCase()));
        } else {
            GUIState.getStage().initStyle(StageStyle.DECORATED);
        }

        this.beforeInitialView(GUIState.getStage(), applicationContext);
        showView(savedInitialView);
    }

这样看就很明显了,第一种只有一个stage舞台,第二种确实可以有多个stage舞台