SpringBoot:将项目打包成war包运行在外置tomcat中

时间:2021-7-4 作者:qvyue

Spring Boot内置的tomcat容器,打包成jar包后就可直接运行,配合docker容器化部署,使得项目部署更加简单。但是如果想要Springboot打包成war包,使用外置的web容器部署,应该怎么配置呢。本文将详细介绍,如何将SpringBoot项目打包成war包。

1. 修改web模块的pom.xml配置

在笔者的项目中,一个项目被分成多个模块,包括web,biz,common,dao,model等,通过划分模块,使代码结构更加清晰明了。因为主启动类在web模块,所以修改web模块的pom配置。

SpringBoot:将项目打包成war包运行在外置tomcat中
项目结构
  • 首先指定打包类型为war包类型
    cms-label-webwar
  • 移除SpringBoot Starter web中的tomcat依赖
       
        org.springframework.bootspring-boot-starter-weborg.springframework.bootspring-boot-starter-tomcat
  • 由于项目还会在tomcat中启动,所以要单独引入tomcat依赖
      org.springframework.bootspring-boot-starter-tomcatprovided
  • 指定打包成war包的名字,然后使用插件maven-war-plugin可以不用创建完成的web目录。
  ROOTorg.springframework.bootspring-boot-maven-pluginmaven-war-plugin3.0.0org.apache.maven.pluginsmaven-deploy-plugintrue

2. 修改非web模块的pom.xml配置

  • 指定除web模块外的biz, common, dao, model, web的类型为jar包类型
jar

3. 新增ServletInitializer

  • 继承SpringBootServletInitializer,实现configure方法
import org.springframework.boot.builder.SpringApplicationBuilder;
import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;

public class ServletInitializer extends SpringBootServletInitializer {
 
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(Bootstrap.class);
    }

}

4. 测试

  • 如果使用的是IDEA,右侧边栏的maven选项中,先clean,再package。
SpringBoot:将项目打包成war包运行在外置tomcat中
image.png
  • package后,会出现以下内容,说明打包成功
SpringBoot:将项目打包成war包运行在外置tomcat中
image.png
  • web模块中编译后的target模块中,出现了ROOT.war包说明打包成功,然后放在tomcat下的webapps目录下,启动tomcat即可。
SpringBoot:将项目打包成war包运行在外置tomcat中
image.png
  • IDEA配置tomcat启动,
SpringBoot:将项目打包成war包运行在外置tomcat中
image.png
SpringBoot:将项目打包成war包运行在外置tomcat中
image.png
SpringBoot:将项目打包成war包运行在外置tomcat中
image.png

5. 问题

  • 缺少web.xml
    之前没有完整的配置,导致配置过程中出现了很多问题,比如下面这个问题。报错是缺少web-inf模块,我们用的Springboot项目,已经是前后端分离了,肯定不需要在创建了,应该是有配置可以配置的。
Failed to execute goal org.apache.maven.plugins:maven-war-plugin:2.2:war (default-war) on project cms-label-web: Error assembling WAR: webxml attribute is required (or pre-existing WEB-INF/web.xml if executing in update mode)

SpringBoot:将项目打包成war包运行在外置tomcat中
image.png
SpringBoot:将项目打包成war包运行在外置tomcat中
image.png
SpringBoot:将项目打包成war包运行在外置tomcat中
image.png

解决办法,加上maven-war-plugin插件,这个插件

         
            maven-war-plugin3.0.0
  • SpringBootServletInitializer的作用

SpringBootServletInitializer的执行过程,简单来说就是通过SpringApplicationBuilder构建并封装SpringApplication对象,并最终调用SpringApplication的run方法的过程

spring boot就是为了简化开发的,也就是用注解的方式取代了传统的xml配置。

SpringBootServletInitializer就是原有的web.xml文件的替代。

使用了嵌入式Servlet,默认是不支持jsp。

声明:本文内容由互联网用户自发贡献自行上传,本网站不拥有所有权,未作人工编辑处理,也不承担相关法律责任。如果您发现有涉嫌版权的内容,欢迎发送邮件至:qvyue@qq.com 进行举报,并提供相关证据,工作人员会在5个工作日内联系你,一经查实,本站将立刻删除涉嫌侵权内容。