• 1.3 jfinal-undertow 下部署
    • 1、指定打包为类型为 jar
    • 2、添加 maven-jar-plugin 插件
    • 3、添加 maven-assembly-plugin 插件
    • 4、添加 package.xml 文件
    • 5、在项目根目录下面添加启动脚本
    • 6、打包
    • 7、部署
    • 8、fatjar 打包部署
    • 9、jfinal-undertow 的主要优势

    1.3 jfinal-undertow 下部署

    1、指定打包为类型为 jar

    修改 pom.xml 文件,其中的 packaging 标签值要改成 jar

    1. <packaging>jar</packaging>

    2、添加 maven-jar-plugin 插件

    1. <!--
    2. jar 包中的配置文件优先级高于 config 目录下的 "同名文件"
    3. 因此,打包时需要排除掉 jar 包中来自 src/main/resources 目录的
    4. 配置文件,否则部署时 config 目录中的同名配置文件不会生效
    5. -->
    6. <plugin>
    7. <groupId>org.apache.maven.plugins</groupId>
    8. <artifactId>maven-jar-plugin</artifactId>
    9. <version>2.6</version>
    10. <configuration>
    11. <excludes>
    12. <exclude>*.txt</exclude>
    13. <exclude>*.xml</exclude>
    14. <exclude>*.properties</exclude>
    15. </excludes>
    16. </configuration>
    17. </plugin>

    maven-jar-plugin 仅为了避免将配置文件打入 jar 包,如果是打成 fatjar 包则不需要添加此插件

    3、添加 maven-assembly-plugin 插件

    修改 pom.xml ,在其中的 plugins 标签下面添加如下 maven-assembly-plugin 插件

    <!-- 
        使用 mvn clean package 打包 
        更多配置可参考官司方文档:http://maven.apache.org/plugins/maven-assembly-plugin/single-mojo.html
    -->
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-assembly-plugin</artifactId>
      <version>3.1.0</version>
      <executions>
        <execution>
        <id>make-assembly</id>
        <phase>package</phase>
        <goals>
          <goal>single</goal>
        </goals>
    
        <configuration>
          <!-- 打包生成的文件名 -->
          <finalName>${project.artifactId}</finalName>
          <!-- jar 等压缩文件在被打包进入 zip、tar.gz 时是否压缩,设置为 false 可加快打包速度 -->
          <recompressZippedFiles>false</recompressZippedFiles>
          <!-- 打包生成的文件是否要追加 release.xml 中定义的 id 值 -->
          <appendAssemblyId>true</appendAssemblyId>
          <!-- 指向打包描述文件 package.xml -->
          <descriptors>
            <descriptor>package.xml</descriptor>
          </descriptors>
          <!-- 打包结果输出的基础目录 -->
          <outputDirectory>${project.build.directory}/</outputDirectory>
          </configuration>
          </execution>
        </executions>
    </plugin>

    maven-assembly-plugin 是 maven 官方提供的打包插件,功能十分完善,可以配置很多参数进行定制化构建,更详细的文件参考其官方文档:http://maven.apache.org/plugins/maven-assembly-plugin/single-mojo.html

    4、添加 package.xml 文件

    在项目根目录下面添加 package.xml,该文件是在上述 maven-assembly-plugin 在 descriptor 标签中指定的打包描述文件,内容如下:

    <assembly xmlns="http://maven.apache.org/ASSEMBLY/2.0.0"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://maven.apache.org/ASSEMBLY/2.0.0 http://maven.apache.org/xsd/assembly-2.0.0.xsd">
    
      <!-- 
        assembly 打包配置更多配置可参考官司方文档:
        http://maven.apache.org/plugins/maven-assembly-plugin/assembly.html
      -->
    
      <id>release</id>
    
      <!--
          设置打包格式,可同时设置多种格式,常用格式有:dir、zip、tar、tar.gz
          dir 格式便于在本地测试打包结果
          zip 格式便于 windows 系统下解压运行
          tar、tar.gz 格式便于 linux 系统下解压运行
      -->
      <formats>
        <format>dir</format>
        <format>zip</format>
        <!-- <format>tar.gz</format> -->
      </formats>
    
      <!-- 打 zip 设置为 true 时,会在 zip 包中生成一个根目录,打 dir 时设置为 false 少层目录 -->
      <includeBaseDirectory>true</includeBaseDirectory>
    
      <fileSets>
        <!-- src/main/resources 全部 copy 到 config 目录下 -->
        <fileSet>
          <directory>${basedir}/src/main/resources</directory>
          <outputDirectory>config</outputDirectory>
        </fileSet>
    
        <!-- src/main/webapp 全部 copy 到 webapp 目录下 -->
        <fileSet>
          <directory>${basedir}/src/main/webapp</directory>
          <outputDirectory>webapp</outputDirectory>
        </fileSet>
    
        <!-- 项目根下面的脚本文件 copy 到根目录下 -->
        <fileSet>
          <directory>${basedir}</directory>
          <outputDirectory></outputDirectory>
          <!-- 脚本文件在 linux 下的权限设为 755,无需 chmod 可直接运行 -->
          <fileMode>755</fileMode>
          <includes>
            <include>*.sh</include>
            <include>*.bat</include>
          </includes>
        </fileSet>
      </fileSets>    
    
      <!-- 依赖的 jar 包 copy 到 lib 目录下 -->
      <dependencySets>
        <dependencySet>
          <outputDirectory>lib</outputDirectory>            
        </dependencySet>
      </dependencySets>
    
    </assembly>

    打包描述文件是 maven-assembly-plugin 的一部分,描述文件可以非常方便地控制打包的各种细节动作,更详细的文档参考:http://maven.apache.org/plugins/maven-assembly-plugin/assembly.html

    5、在项目根目录下面添加启动脚本

    注意:以下脚本文件在 jfinal 官网首页右侧下载的 jfinal demo for maven 项目中已经提供,复制其中的 jfinal.sh / jfinal.bat 到自己的项目中修改 MAIN_CLASS 变量值,即可投入使用。

    Linux 下的启动脚本 jfinal.sh 内容如下:

    #!/bin/bash
    # --------------------------------------------------------------
    #
    # 使用说明:
    # 1: 该脚本使用前需要首先修改 MAIN_CLASS 值,使其指向实际的启动类
    #
    # 2:使用命令行 ./jfinal.sh start | stop | restart 可启动/关闭/重启项目  
    #
    # 3: JAVA_OPTS 可通过 -D 传入 undertow.port 与 undertow.host 这类参数覆盖
    #    配置文件中的相同值此外还有 undertow.resourcePath、undertow.ioThreads、
    #    undertow.workerThreads 共五个参数可通过 -D 进行传入,该功能尽可能减少了
    #    修改 undertow 配置文件的必要性
    #
    # 4: JAVA_OPTS 可传入标准的 java 命令行参数,例如 -Xms256m -Xmx1024m 这类常用参数
    #
    # 5: 函数 start() 给出了 4 种启动项目的命令行,根据注释中的提示自行选择合适的方式
    #
    # --------------------------------------------------------------
    
    # 启动入口类,该脚本文件用于别的项目时要改这里
    MAIN_CLASS=com.yourpackage.YourMainClass
    
    if [[ "$MAIN_CLASS" == "com.yourpackage.YourMainClass" ]]; then
        echo "请先修改 MAIN_CLASS 的值为你自己项目启动Class,然后再执行此脚本。"
        exit 0
    fi
    
    COMMAND="$1"
    
    if [[ "$COMMAND" != "start" ]] && [[ "$COMMAND" != "stop" ]] && [[ "$COMMAND" != "restart" ]]; then
        echo "Usage: $0 start | stop | restart"
        exit 0
    fi
    
    
    # Java 命令行参数,根据需要开启下面的配置,改成自己需要的,注意等号前后不能有空格
    # JAVA_OPTS="-Xms256m -Xmx1024m -Dundertow.port=80 -Dundertow.host=0.0.0.0"
    # JAVA_OPTS="-Dundertow.port=80 -Dundertow.host=0.0.0.0"
    
    # 生成 class path 值
    APP_BASE_PATH=$(cd `dirname $0`; pwd)
    CP=${APP_BASE_PATH}/config:${APP_BASE_PATH}/lib/*
    
    function start()
    {
        # 运行为后台进程,并在控制台输出信息
        java -Xverify:none ${JAVA_OPTS} -cp ${CP} ${MAIN_CLASS} &
    
        # 运行为后台进程,并且不在控制台输出信息
        # nohup java -Xverify:none ${JAVA_OPTS} -cp ${CP} ${MAIN_CLASS} >/dev/null 2>&1 &
    
        # 运行为后台进程,并且将信息输出到 output.log 文件
        # nohup java -Xverify:none ${JAVA_OPTS} -cp ${CP} ${MAIN_CLASS} > output.log &
    
        # 运行为非后台进程,多用于开发阶段,快捷键 ctrl + c 可停止服务
        # java -Xverify:none ${JAVA_OPTS} -cp ${CP} ${MAIN_CLASS}
    }
    
    function stop()
    {
        # 支持集群部署
        kill `pgrep -f ${APP_BASE_PATH}` 2>/dev/null
    
        # kill 命令不使用 -9 参数时,会回调 onStop() 方法,确定不需要此回调建议使用 -9 参数
        # kill `pgrep -f ${MAIN_CLASS}` 2>/dev/null
    
        # 以下代码与上述代码等价
        # kill $(pgrep -f ${MAIN_CLASS}) 2>/dev/null
    }
    
    if [[ "$COMMAND" == "start" ]]; then
        start
    elif [[ "$COMMAND" == "stop" ]]; then
        stop
    else
        stop
        start
    fi

    注意要首先根据项目入口类,修改一下上面内容中的 MAIN_CLASS 变量值,Windows 下的 jfinal.bat 脚本也同样如此

    启动项目命令:./jfinal.sh start

    关闭项目命令:./jfinal.sh stop

    重启项目命令:./jfinal.sh restart

    特别注意:使用以上命令行时,先要使用 mvn clean package 将项目打包,然后使用 cd 命令跳转到打好的包的目录下面执行命令。而不是 cd 跳转到项目根目录下面去执行命令,很多人犯这种错误。打包方法见紧接着的下一小节《6、打包》

    限于篇幅在此不再贴出 windows 脚本内容,可下载官网首页右侧的 jfinal demo 获取。最新版本的脚本在此可以下载到:https://gitee.com/jfinal/jfinal-undertow

    windows 脚本的使用方法如下:

    启动项目命令:jfinal.bat start

    关闭项目命令:jfinal.bat stop

    重启项目命令:jfinal.bat restart

    特别注意:linux、mac 下的脚本文件换行字符必须是 '\n',而 windows 下必须是 "\r\n",否则脚本无法执行,并会输出无法理解的错误信息,难以排错。如何查看脚本文件中的换行字符见文档:https://www.jfinal.com/doc/1-5

    6、打包

    打开命令行终端,cd 命令进入项目根目录,运行以下命令即可打包

    mvn clean package

    执行上述打包命令以后,在项目根下面的 target 目录下面会出现打好的 xxx.zip,解压该 zip 文件运行里面的 start 脚本即可

    除了 zip 文件还会在 target 下面生成一个目录,在该目录下面使用命令行 ./jfinal.sh start 可启动项目,该目录下面的内容与 zip 文件中的内容是完全一样的。

    7、部署

    将上述打包命令生成的 zip 文件上传到服务器并解压即完成了部署工作,基于 jfinal-undertow 开发项目的最大优势就是不需要下载、安装、配置 tomcat 这类 server

    8、fatjar 打包部署

    fatjar 打包是指将项目中所有 class、所有资源以及所有 jar 包依赖全部打包到一个单独的 jar 包之中,打包好的独立 jar 包可以很方便复制、部署、运行,非常适合于做微服务项目开发,也很适合没有 web 资源或者 web 资源很少的项目

    具体的用法可以在官网首页下载 jfinal-demo-for-maven,其中的 doc 目录下面有文档详细介绍了此方法,后续会在文档频道添加 fatjar 打包方法

    9、jfinal-undertow 的主要优势

    1:极速启动,启动速度比 tomcat 快 5 到 8 倍。jfinal.com 官网启动时间在 1.5 秒内

    2:Undertow 是红帽公司的开源产品,是 Wildfly 默认的 Web 服务器,Java Web 服务器市场占有率高于 Jetty,仅次于 Tomcat

    3:极简精妙的热部署设计,实现极速轻量级热部署,让开发体验再次提升一个档次

    4:性能高于 tomcat、jetty,可替代 tomcat、jetty 用于生产环境

    5:undertow 为嵌入式而生,可直接用于生产环境部署,部署时无需下载服务,无需配置服务,十分适合微服务开发、部署

    6:告别 web.xml、告别 tomcat、告别 jetty,节省大量打包与部署时间。令开发、打包、部署成为一件开心的事

    7:功能丰富,支持 classHotSwap、WebSocket、gzip 压缩、servlet、filter、sessionHotSwap 等功能

    8:支持 fatjar 与 非 fatjar 打包模式,便于支持微服务

    9:开发、打包、部署一体化,整个过程无需对项目中的任何地方进行调整或修改,真正实现从极速开发到极速部署