JFinal 项目部署环境 JFinal Undertow

Apache
Java
跨平台
2018-12-12
JFinal

jfinal-undertow 用于开发、部署由 jfinal 开发的 web 项目。独创 HotSwapClassLoader + HotSwapWatcher 以 319 行代码极简实现热加载开发与部署,前无古人,后必有模仿者

一、 极速上手

1: 添加 maven 依赖

<dependency>
	<groupId>com.jfinal</groupId>
	<artifactId>jfinal-undertow</artifactId>
	<version>1.4</version>
</dependency>

注意:以前对 jetty-server 的 maven 依赖要删掉

2: 创建 main 方法在 eclipse 或 IDEA 中启动项目

UndertowServer.start(AppConfig.class);

其中 AppConfig 是继承自 JFinalConfig 的子类,以前的 JFinal.start(...) 用法不再需要

二、极速打包与部署

1: 修改 pom.xml 头部的打包类型由 war 改成 jar

<packaging>jar</packaging>

2: 在 pom.xml 中添加 maven-jar-plugin 插件

<!--
    jar 包中的配置文件优先级高于 config 目录下的 "同名文件"
    因此,打包时需要排除掉 jar 包中来自 src/main/resources 目录的
    配置文件,否则部署时 config 目录中的同名配置文件不会生效
-->
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-jar-plugin</artifactId>
    <version>2.6</version>
    <configuration>
        <excludes>
            <exclude>*.txt</exclude>
            <exclude>*.xml</exclude>
            <exclude>*.properties</exclude>
        </excludes>
    </configuration>
</plugin>

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

3: 在 pom.xml 中添加 maven-assembly-plugin 插件

<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>

4、在项目根目录下添加打包描述文件 package.xml,内容如下:

<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 会在包在存在总目录,打 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>

5、部署在项目根目录下添加项目运行脚本文件

本项目中的根目录下面提供了 start.sh、stop.sh、restart.sh、start.bat 这四个脚本文件下载。其中前三个用于 linux、mac 系统,后一个用于 windows 系统,注意要修改一下这些脚本文件中的 MAIN_CLASS 变量指向你自己的项目入口,例如:

MAIN_CLASS=com.yourpackage.YourMainClass

当然这四个脚本文件不是必须的,大家完全可以根据个人习惯编写启动脚本

6、在命令行运行打包指令

mvn clean package

7、部署

进入项目的 target/your-project-release 目录,运行 start.sh 即可启动项目。target 目录下还会打包出一个 your-project-release.zip 该文件是上述第五步中生成的目录的一个 zip 压缩文件,上传该文件到服务器解压即部署,可以通过修改 package.xml 改变生成的文件名或者取消生成该文件

三、jfinal-undertow 优势:

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

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

3:性能比 tomcat、jetty 高出很多,可代替 tomcat、jetty 用于生产环境

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

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

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

7:支持 fatjar 与 非 fatjar 打包模式,为 jfinal 下一步的微服务功能做好准备

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

9:以上仅为 jfinal-undertow 的部分功能,更多好用的功能如 fatjar 打包模式见 jfinal 官网文档

的码云指数为
超过 的项目
加载中

评论(20)

JFinal
JFinal 软件作者

引用来自“蔡培元”的评论

能否用在非jfinal项目上当做服务器使用?

引用来自“哈库纳”的评论

spring boot 就好了。
答非所问
哈库纳
哈库纳

引用来自“蔡培元”的评论

能否用在非jfinal项目上当做服务器使用?
spring boot 就好了。
lottepie
lottepie
gradle下如何配置打包与部署?
蔡培元
蔡培元

引用来自“蔡培元”的评论

能否用在非jfinal项目上当做服务器使用?

引用来自“JFinal”的评论

最简单的办法是引入 JFinal 但不实际使用。 然后通过配置 undertow.resourcePath 就可以当成 web 服务使用了。 如果要去掉 jfinal 的依赖,可以继承 UndertowServer,然后覆盖掉 configJFinal() 方法,在这里去除 jfinal 的 JFinalFilter 或者你直接配置你自己的 Filter ,自己的 Filter 会先于 JFinalFilter 生效,所以可以接管所有请求
谢谢 学习了
JFinal
JFinal 软件作者

引用来自“蔡培元”的评论

能否用在非jfinal项目上当做服务器使用?
最简单的办法是引入 JFinal 但不实际使用。 然后通过配置 undertow.resourcePath 就可以当成 web 服务使用了。 如果要去掉 jfinal 的依赖,可以继承 UndertowServer,然后覆盖掉 configJFinal() 方法,在这里去除 jfinal 的 JFinalFilter 或者你直接配置你自己的 Filter ,自己的 Filter 会先于 JFinalFilter 生效,所以可以接管所有请求
蔡培元
蔡培元
能否用在非jfinal项目上当做服务器使用?
JFinal
JFinal 软件作者

引用来自“猝死的路上”的评论

@JFinal 请问波哥,为什么我的项目用jfinal-undertow这种方式来运行,运行首页上的demo没有问题,但是用我自己配置的route访问就变成了下载,找了好久都没法解决这个问题,麻烦波哥出出主意,用的1.4的版本,
按文档来就可以了:https://www.jfinal.com/doc/1-2
阿老表
阿老表
太牛逼了!!!
猝死的路上
@JFinal 请问波哥,为什么我的项目用jfinal-undertow这种方式来运行,运行首页上的demo没有问题,但是用我自己配置的route访问就变成了下载,找了好久都没法解决这个问题,麻烦波哥出出主意,用的1.4的版本,
坐拥花丛
坐拥花丛

引用来自“坐拥花丛”的评论

jfinal-undertow支持class文件热加载,但是不支持页面文件热加载?服务启动状态,页面文件都修改了,但是访问服务还是返回的修改之前的页面文件?css、js文件等等 都有这种情况

引用来自“JFinal”的评论

为了达到性能极致,模板文件默认是不会热加载的,要在 configEngine 中配置一下: engine.setDevMode(true); css、js 文件修改后立即会生效,这个不属于热加载的范畴,浏览器对 js、css 有缓存,修改以后需要强制刷新才能看到效果,windows 下的 Chrome 强制刷新需要按 Ctrl + F5,mac 下需要按 Shift + Cmd + R
好的,感谢波总,我去试下。

JFinal Undertow 1.4 发布,小版本迭代

JFinal Undertow 项目在公司内部试用两个月,在俱乐部内测一个月,在 2018-12-12 号才放出 jfinal undertow 1.3 版本,这个版本已经十分完善好用 jfinal underow 1.4 针对自 1.3 发布以来的一...

2018/12/25 15:32

JFinal Undertow 1.3 发布,从极速开发到极速上线

从 JFinal 3.0 重新定义模板引擎实现了 MVC + ORM 各层的极速开发(3.0 发布盛况传送门),到 JFinal 3.4 将极速贯彻到 UI 层,实现了 UI 层的极速开发 (3.4 发布盛况传送门),“开发过程” 的...

2018/12/12 17:06

没有更多内容

加载失败,请刷新页面

没有更多内容

1
回答
JFinal Undertow有没有像jfinal3.5_all那用带所有jar的环境供下载呢,maven老是出问题...

@jfinal 波总好,JFinal Undertow有没有像jfinal3.5_all那用带所有jar包的环境供下载呢,本地maven老是出各种问题.....

2018/12/18 16:48

没有更多内容

加载失败,请刷新页面

没有更多内容

Jboot v2.0_rc1

jboot 更新了2.0了,使用了jfinal-undertow,实现了热更新,所以赶紧尝试了一下,有一些小问题解决之后就完美的运行起来了。 1.jboot2.0使用了jfinal的AOP功能,但是还没有完全替换,所以还是要...

2018/12/27 15:27
4
0
jfinal-lesscss使用java实现lesscss的动态编译

jfinal-coffeescript使用java实现coffeescript的动态编译,带有jfinal plugin

2014/09/12 12:21
49
0
jfinal-coffeescript使用java实现coffeescript的动态编译

jfinal-coffeescript使用java实现coffeescript的动态编译,带有jfinal plugin

2014/09/12 12:16
68
0
jfinal-shiro-freemarker实现shiro在freemarker页面的标签过滤

jfinal-shiro-freemarker实现shiro在freemarker页面的标签过滤,用于动态屏蔽页面的部分内容

2014/09/12 11:59
596
1
jfinal-sqlinxml 类似ibatis的sql语句存在xml文件里

jfinal-sqlinxml 类似ibatis的sql语句存在xml文件里

2014/09/12 13:47
222
0
jfinal-quartz 使用jfinal启动quartz执行定时任务

jfinal-quartz 使用jfinal启动quartz执行定时任务,大家尽可能关注(Follow)我的github(https://github.com/Dreampie),好及时得到插件的更新信息...

2014/09/12 13:26
1K
2
JFinal常见问题汇总

整理社区回答中jfinal常见的入门和热点问题的帖子,加速新手入门速度,欢迎大家在评论中补充,我会不定期更新这个帖子。 JFinal 为啥不像 Rails 一样提供脚手架 http://www.oschina.net/que...

2013/03/31 14:58
2.9K
14
jfinal-slf4j 让jfinal使用slf4j的log api

jfinal-slf4j 让jfinal使用slf4j的log api

2014/09/12 14:14
496
1
jfinal-flyway 数据脚本升级插件,伴随应用的升级自动升级或回滚数据库

jfinal-flyway 数据脚本升级插件,伴随应用的升级自动升级或回滚数据库

2014/09/12 12:54
337
2
使用flyway-maven-plugin,执行数据库初始化sql文件,和sql数据库升级

使用flyway-maven-plugin,执行数据库初始化sql文件,和sql数据库升级

2014/11/18 13:36
490
1

没有更多内容

加载失败,请刷新页面

返回顶部
顶部