JavaFx系列教程之一:JavaFx+Springboot+Maven 开发打包教程

最近在用 JavaFx 开发窗体程序,并且以后打算把所有的窗体软件切换到 JavaFx 上面,并且还想用 springboot 的__各种好处,集成了 springboot 就可以愉快的用各种服务了。所以就有了这个博客。。。
我本来想自己写一个 javafx-spring-boot-starter 的,其原理也是很简单地,利用 springbootaware 就可以了。但是发现德国这哥们已经写了一个,就变懒了。哎,没办法,我真的是太懒了。
本次的代码Github 地址:https://github.com/spartajet/...

1. 介绍

javafxspringboot支持的库,官方是没有的,开源有一大堆。我采用的是springboot-javafx-support 地址是:springboot-javafx-support .这个库文档比较全,比较详细,文档地址:Spring Boot and JavaFx8 .

springboot必须用maven,否则那简直是灾难。最重要的是打包工具。我用的是JavaFX Maven Plugin 地址:JavaFX Maven Plugin

2. Maven 配置

maven 主要配置依赖库和插件,具体如下:

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-actuator</artifactId>
        <version>${spring.boot.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter</artifactId>
        <version>${spring.boot.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-log4j2</artifactId>
        <version>${spring.boot.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <version>${spring.boot.version}</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>de.roskenet</groupId>
        <artifactId>springboot-javafx-support</artifactId>
        <version>${springboot-javafx-support.version}</version>
    </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>
            <configuration>
                <mainClass>com.spartajet.fxboot.demo.MainController</mainClass>
                <vendor>Spartajet</vendor>
            </configuration>
        </plugin>
    </plugins>
</build>

其中,比较重要的是:<mainClass>com.spartajet.fxboot.demo.MainController</mainClass> 这个是打包的时候的 main 类。<vendor>Spartajet</vendor>是组织名称。

3. Javafx 集成springboot

3.1 创建 FXML 布局文件

可以用 SceneBuilder 工具创建 FXML 文件,我还是建议自己写 FXML,刚开始可能不习惯,慢慢习惯就好了。但是,我墙裂建议布局和样式分开,fxml 只管布局,css 只管样式。

<BorderPane id="mainBorderPane" xmlns="http://javafx.com/javafx/8.0.111" xmlns:fx="http://javafx.com/fxml/1" fx:controller="com.spartajet.fxboot.demo.controller.MainStageController" stylesheets="/css/MainStage.css">
</BorderPane>

3.2 MainStageController

每一个 fxml 布局文件对应一个 controller,要在 fx:controller 里面设置。

/**
 * @description
 * @create 2017-05-20 下午1:55
 * @email spartajet.guo@gmail.com
 */
@FXMLController
public class MainStageController implements Initializable {

    /**
     * Called to initialize a controller after its root element has been
     * completely processed.
     *
     * @param location  The location used to resolve relative paths for the root object, or
     *                  <tt>null</tt> if the location is not known.
     * @param resources The resources used to localize the root object, or <tt>null</tt> if
     */
    public void initialize(URL location, ResourceBundle resources) {
        
    }
}

实现Initializable接口,加上@FXMLController注解,其实很简单的。看看@FXMLController的源码:

@Component
@Retention(RetentionPolicy.RUNTIME)
public @interface FXMLController {

}

3.3 MainStageView

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

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

添加的是注解@FXMLView,源码如下:

@Component
@Retention(RetentionPolicy.RUNTIME)
public @interface FXMLView {
    String value() default "";
    String[] css() default {}; 
    String bundle() default "";
}

从这里也能看到,可以在这里注入 css 样式文件以及 bundle 文件。还是比较方便的,我是在 fxml 里面注入的 css 文件,都是可以的。
其中还继承了 AbstractFxmlView 的抽象类,方法比较少,最重要的是getView方法,返回的是Node对象。然后就可以随意的用这个视图了。

3.3 MainController

@SpringBootApplication
public class MainController extends AbstractJavaFxApplicationSupport {

    /**
     * The entry point of application.
     *
     * @param args the input arguments
     */
    public static void main(String[] args) {
        launchApp(MainController.class, MainStageView.class, args);
    }

    /**
     * Start.
     *
     * @param stage the stage
     *
     * @exception Exception the exception
     */
    @Override
    public void start(Stage stage) throws Exception {
        super.start(stage);
    }
}

继承自AbstractJavaFxApplicationSupport 可以看到源码,典型的Aware。然后就可以运行了。

可以看到

这个是启动动画。可以自定义启动动画,个人认为,启动动画还是很有必要的,因为 springboot 启动费时还是比较多的,来个启动动画,逼格满满的。

3.4 启动动画

/**
 * @description
 * @create 2017-05-20 下午2:54
 * @email spartajet.guo@gmail.com
 */
public class CustomSplash extends SplashScreen {
    /**
     * Use your own splash image instead of the default one
     *
     * @return "/splash/javafx.png"
     */
    @Override
    public String getImagePath() {
        return super.getImagePath();
    }

    /**
     * Customize if the splash screen should be visible at all
     *
     * @return true by default
     */
    @Override
    public boolean visible() {
        return super.visible();
    }
}

最常用的就是这两个方法了,一个是更换照片,另一个是是否显示启动动画。

4.0 打包

JavaFX-Maven-Plugin可以打包 jar、native、webbundle、key-store这些。
由于我是 mac,一般用 jar和 native,执行命令mvn jfx:native 会看到打包成了pkg 和 dmg 两种类型的安装包。并且都是180M 左右。由于没有 windows 计算机,所以还不知道打包成 exe 的状态。这么大的包,主要是因为 java 的 jdk 问题,模块化以后就好了。

阅读 21.4k

推荐阅读
郭晓忠的专栏
用户专栏

我的积累

26 人关注
22 篇文章
专栏主页