1 快速上手

2 JFinalConfig

3 Controller

4 AOP

5 ActiveRecord

6 Enjoy 模板引擎

7 EhCachePlugin

8 RedisPlugin

9 Cron4jPlugin

10 Validator

11 国际化

12 Json 转换

13 JFinal架构及扩展

14 升级到 5.1.2

1.7 tomcat 下部署

0、检查 web.xml 配置

少数同学开发时用的 jfinal-undertow,部署时用的 tomcat,而 jfinal-undertow 是不需要 web.xml 文件的,造成在 tomcat 部署失败。

因此,在 tomcat 下部署需要检查 web.xml 是否存在,并且要确保配置正确,配置格式如下:

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5">
  <display-name>jfinal offical website</display-name>
  
  <filter>
    <filter-name>jfinal</filter-name>
    <filter-class>com.jfinal.core.JFinalFilter</filter-class>
    <init-param>
       <param-name>configClass</param-name>
       <param-value>demo.DemoConfig</param-value>
    </init-param>
  </filter>
  
  <filter-mapping>
    <filter-name>jfinal</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>

</web-app>

注意:其中的 para-value 配置取决于你项目的具体 XxxConfig 的包名与类名,注意修改,其它配置可原封不动进行复制。


1、指定打包类型为 war

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

<packaging>war</packaging>


2、删掉 jfinal-undertow 和 jetty-server 依赖

修改 pom.xml 文件,将 jfinal-undertow 和 jetty-server 有关依赖全部删除,否则部署到 tomcat 中会产生冲突


3、添加 servlet api 依赖

   如果你的项目代码中用到了 servlet api 那么还要添加如下依赖才能打包

<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>4.0.1</version>
    <scope>provided</scope>
</dependency>

    这个依赖可以在打包出现提示时再添加,如果打包通过可以不用理会。


4、打包

控制台 cd 进入项目根目录执行下面命令打出 war 包

mvn clean package


5、部署

jfinal 开发的项目就是标准的 java web 项目,所以部署方式没有任何特殊的地方,有一些部署方面要注意的小技巧,见这篇博文:https://my.oschina.net/jfinal/blog/353062


注意:本小节仅介绍了在 jfinal-undertow 或 jetty-server 之下开发,在 tomcat 下部署的方式,这两种方式下才需要删掉其依赖。如果采用传统的 java web 开发方式,无需关注此章节。尤其要注意特别声明:https://www.jfinal.com/doc/1-11