0、检查 web.xml 配置

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

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

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <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">
  3. <display-name>jfinal offical website</display-name>
  4. <filter>
  5. <filter-name>jfinal</filter-name>
  6. <filter-class>com.jfinal.core.JFinalFilter</filter-class>
  7. <init-param>
  8. <param-name>configClass</param-name>
  9. <param-value>demo.DemoConfig</param-value>
  10. </init-param>
  11. </filter>
  12. <filter-mapping>
  13. <filter-name>jfinal</filter-name>
  14. <url-pattern>/*</url-pattern>
  15. </filter-mapping>
  16. </web-app>

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

1、指定打包类型为 war

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

  1. <packaging>war</packaging>

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

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

3、添加 servlet api 依赖

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

  1. <dependency>
  2. <groupId>javax.servlet</groupId>
  3. <artifactId>javax.servlet-api</artifactId>
  4. <version>4.0.1</version>
  5. <scope>provided</scope>
  6. </dependency>

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

4、打包

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

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