JFinal Undertow 正在参加 2021 年度 OSC 中国开源项目评选,请投票支持!
JFinal Undertow 在 2021 年度 OSC 中国开源项目评选 中已获得 {{ projectVoteCount }} 票,请投票支持!
2021 年度 OSC 中国开源项目评选 正在火热进行中,快来投票支持你喜欢的开源项目!
2021 年度 OSC 中国开源项目评选 >>> 中场回顾
JFinal Undertow 获得 2021 年度 OSC 中国开源项目评选「最佳人气项目」 !
授权协议 Apache
开发语言 Java
操作系统 跨平台
软件类型 开源软件
所属分类 Web应用开发Web框架
开源组织
地区 国产
投 递 者 JFinal
适用人群 未知
收录时间 2018-12-12

软件简介

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

一、 极速上手

1: 添加 maven 依赖

<dependency>
	<groupId>com.jfinal</groupId>
	<artifactId>jfinal-undertow</artifactId>
	<version>3.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、部署在项目根目录下添加项目运行脚本文件

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

MAIN_CLASS=com.yourpackage.YourMainClass

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

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

mvn clean package

7、部署

进入项目的 target/your-project-release 目录,运行 ./jfinal.sh start 即可启动项目。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 打包模式

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

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

展开阅读全文

代码

的 Gitee 指数为
超过 的项目

评论

点击加入讨论🔥(40)
发表了资讯
2020/10/13 16:36

JFinal Undertow 2.2 发布,爽爽这两年

JFinal Undertow 用于实现 jfinal 项目的开发、打包、部署一体化。 不仅开发体验提升了一个档次,而且生产环境也已经可靠、稳定运行超过两年,爽爽的这两年,用过的同学才明白这滋味。 实践证实,开发效率更高,部署方便更快。无需折腾 tomcat 的下载、安装、配置,消灭问题远比解决问题要高明。 爽爽的这两年,jfinal undertow 已然十分完善,没多少要添加的功能,本次新版本发布只需稍许改进: 1、关闭 http 的同时关闭其端口...

2
5
发表于大前端专区
2019/12/18 09:33

JFinal Undertow 2.0 发布,开发、打包、部署一体化

jfinal-undertow 用于开发、部署由 jfinal 开发的 web 项目。独创 HotSwapClassLoader + HotSwapWatcher 以 321 行代码极简实现热加载开发与部署,前无古人,后必有模仿者。 使用方法见官方文档:https://jfinal.com/doc/1-2 jfinal undertow 2.0 changelog: 1:undertow 由 2.0.25.Final 升级到 2.0.28.Final 2:jfinal 由 4.4 升级到 4.8 3:添加 WebBuilder.getDeploymentInfo() 方法,开放给用户更多 web 配置, 例如支持 ...

16
12
发表于大前端专区
2019/02/01 16:00

JFinal Undertow 1.5 发布,稳定、可靠服役于生产环境

jfinal-undertow 用于开发、部署由 jfinal 开发的 web 项目。独创 HotSwapClassLoader + HotSwapWatcher 以 319 行代码极简实现热加载开发与部署。 经过几个版本的迭代,jfinal undertow 已稳定、可靠服役于生产环境,所以本次 1.5 新版本可改进的地方并不多: 1、添加 classpath:mypath 风格配置 undertow 可以配置 FileResourceFactory、ClassPathResourceFactory,可分别从文件系统与 classpath 或 jar 包中读取 web 资源。j...

10
11
发表于大前端专区
2018/12/25 15:32

JFinal Undertow 1.4 发布,小版本迭代

JFinal Undertow 项目在公司内部试用两个月,在俱乐部内测一个月,在 2018-12-12 号才放出 jfinal undertow 1.3 版本,这个版本已经十分完善好用 jfinal underow 1.4 针对自 1.3 发布以来的一些重要反馈进行了升级,具体升级内容如下: 1、改进 session 热加载 jfinal 俱乐部有位同学在使用过程中发现存放在 session 中的 model 对象在读取时会碰到类型转换异常,jfinal undertow 1.4 已完美解决该问题 2、支持 URL 中携带特殊字...

24
15
发表于大前端专区
2018/12/12 17:06

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

从 JFinal 3.0 重新定义模板引擎实现了 MVC + ORM 各层的极速开发(3.0 发布盛况传送门),到 JFinal 3.4 将极速贯彻到 UI 层,实现了 UI 层的极速开发 (3.4 发布盛况传送门),“开发过程” 的极速化目标已经达成 但是,在享受着 JFinal 带来的丝滑般快感的同时,聪明的 JFinal 俱乐部小伙伴们提出了一个新的追问:能否让项目的打包、部署、上线也极速化。公司老板一天到晚催这一版什么时候上线?这一版什么时候上线? 大量小伙伴...

89
49
没有更多内容
加载失败,请刷新页面
点击加载更多
加载中
下一页
发表了博客
{{o.pubDate | formatDate}}

{{formatAllHtml(o.title)}}

{{parseInt(o.replyCount) | bigNumberTransform}}
{{parseInt(o.viewCount) | bigNumberTransform}}
没有更多内容
暂无内容
发表了问答
{{o.pubDate | formatDate}}

{{formatAllHtml(o.title)}}

{{parseInt(o.replyCount) | bigNumberTransform}}
{{parseInt(o.viewCount) | bigNumberTransform}}
没有更多内容
暂无内容
暂无内容
40 评论
73 收藏
分享
OSCHINA
登录后可查看更多优质内容
返回顶部
顶部