Spring Boot内置的tomcat容器,打包成jar包后就可直接运行,配合docker容器化部署,使得项目部署更加简单。但是如果想要Springboot打包成war包,使用外置的web容器部署,应该怎么配置呢。本文将详细介绍,如何将SpringBoot项目打包成war包。
1. 修改web模块的pom.xml配置
在笔者的项目中,一个项目被分成多个模块,包括web,biz,common,dao,model等,通过划分模块,使代码结构更加清晰明了。因为主启动类在web模块,所以修改web模块的pom配置。
项目结构- 首先指定打包类型为war包类型
<artifactId>cms-label-web</artifactId>
<packaging>war</packaging>
- 移除SpringBoot Starter web中的tomcat依赖
<!--spring-boot-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
</exclusion>
</exclusions>
</dependency>
- 由于项目还会在tomcat中启动,所以要单独引入tomcat依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
<!--打包的时候可以不用包进去-->
<scope>provided</scope>
</dependency>
- 指定打包成war包的名字,然后使用插件maven-war-plugin可以不用创建完成的web目录。
<build>
<finalName>ROOT</finalName>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
<!--可以不用添加web.xml-->
<plugin>
<artifactId>maven-war-plugin</artifactId>
<version>3.0.0</version>
</plugin>
<plugin>
<!-- https://mvnrepository.com/artifact/org.apache.maven.plugins/maven-deploy-plugin -->
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-deploy-plugin</artifactId>
<!--deploy 时忽略 model-->
<configuration>
<skip>true</skip>
</configuration>
</plugin>
</plugins>
</build>
2. 修改非web模块的pom.xml配置
- 指定除web模块外的biz, common, dao, model, web的类型为jar包类型
<packaging>jar</packaging>
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。
- package后,会出现以下内容,说明打包成功
- web模块中编译后的target模块中,出现了ROOT.war包说明打包成功,然后放在tomcat下的webapps目录下,启动tomcat即可。
- IDEA配置tomcat启动,
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)
image.png
image.png
image.png
解决办法,加上maven-war-plugin插件,这个插件
<!--可以不用添加web.xml-->
<plugin>
<artifactId>maven-war-plugin</artifactId>
<version>3.0.0</version>
</plugin>
- SpringBootServletInitializer的作用
SpringBootServletInitializer的执行过程,简单来说就是通过SpringApplicationBuilder构建并封装SpringApplication对象,并最终调用SpringApplication的run方法的过程
spring boot就是为了简化开发的,也就是用注解的方式取代了传统的xml配置。
SpringBootServletInitializer就是原有的web.xml文件的替代。
使用了嵌入式Servlet,默认是不支持jsp。
网友评论