如何将spring boot项目打包成war包,并部署在tomcat上运行
- 一·修改打包方式:
- 二·移除spring boot自带的嵌入式tomcat插件:
- 三·添加servlet-api的依赖:若你整合了servlet程序,就需要导入依赖,以下三个任选一个(没有整合就可以跳过)
- 四·添加war包的名称:
- 五·若springboot项目中若有jsp页面,必须手动指定最后编译的路径:(没有整合就可以跳过)
- 六·修改启动类,并重写初始化方法:
- 七·打包部署:
- 八·测试结果,启动tomcat,再访问相关页面:
一·修改打包方式:
<packaging>war</packaging>
二·移除spring boot自带的嵌入式tomcat插件:
<!-- 配置springboot框架的起步依赖-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<!-- 移除起步依赖中嵌入的tomcat插件 -->
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
</exclusion>
</exclusions>
</dependency>
三·添加servlet-api的依赖:若你整合了servlet程序,就需要导入依赖,以下三个任选一个(没有整合就可以跳过)
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.1.0</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>org.apache.tomcat</groupId>
<artifactId>tomcat-servlet-api</artifactId>
<version>8.0.36</version>
<scope>provided</scope>
</dependency>
<!-- 引入springboot框架中内嵌的tomcat,去解析jsp依赖-->
<dependency>
<groupId>org.apache.tomcat.embed</groupId>
<artifactId>tomcat-embed-jasper</artifactId>
<scope>provided</scope>
</dependency>
注意:< scope>provided< /scope>一定不能少,否则后面就会出问题,tomcat无法解析jsp
四·添加war包的名称:
<finalName>springboot</finalName>
五·若springboot项目中若有jsp页面,必须手动指定最后编译的路径:(没有整合就可以跳过)
<resource>
<!--源文件位置-->
<directory>src/main/web</directory>
<!--指定编译到 META-INF/resources,该目录不能随便写-->
<targetPath>META-INF/resources</targetPath>
<!--指定要把哪些文件编译进去,**表示 webapp 目录及子目录,*.*表示所有文件-->
<includes>
<include>*.*</include>
</includes>
</resource>
<!-- 把src/main/resources 下的所有配置文件编译到 classes 下面去-->
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.*</include>
</includes>
</resource>
<!--src/main/java下的 mybatis 的 mapper.xml ,以及所有配置文件编译到 classes 下面去:需要才添加-->
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.xml</include>
</includes>
</resource>
原因:
1. springboot项目默认推荐使用前端引擎是thymeleaf;
要使用springboot集成jsp,需要手动指定最后编译的路径;
而且springboot集成jsp编译jsp的路径是springboot规定好的位置META-INF/resources
2. SpringBoot 要求 jsp 文件必须编译到指定的 META-INF/resources 目录下才能访问,否则访问不到。其它官方已经建议使用模版技术
六·修改启动类,并重写初始化方法:
1.一般web项目,只在idea上面运行时,启动类的写法如下:
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
2.若需要将web项目打包成war包,且部署到tomcat上面运行时,启动类必须包含如下内容,也可再添加其他正常注解,方法调用等等:
/**
* 修改启动类,继承 SpringBootServletInitializer 并重写 configure 方法
*/
public class SpringBootStartApplication extends SpringBootServletInitializer {
@Override
protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
// 注意这里要指向原先用main方法执行的Application启动类
return builder.sources(Application.class);
}
}
七·打包部署:
1.利用maven命令打包
2.将打的war包,复制粘贴到tomcat的webapps目录下(不用解压,启动tomcat自动解压)
八·测试结果,启动tomcat,再访问相关页面:
1.在tomcat安装目录下的bin目录下面找到startup.bat命令,启动tomcat
2.若出现这样的页面表示成功:
3.部署到tomcat必须加上项目工程名:具体如下
http://localhost:[端口号]/[打包项目名]/
测试成功!
注意:
springboot项目打war包,部署到tomcat中,之前在application.properties文件中设置的上下文根和端口号会失效,要以部署的tomcat为准