Spring Boot使用Thymeleaf + Gradle构建war到Tomcat

更新时间：2018年12月08日 15:17:48 作者：执笔记忆的空白

今天小编就为大家分享一篇关于Spring Boot使用Thymeleaf + Gradle构建war到Tomcat，小编觉得内容挺不错的，现在分享给大家，具有很好的参考价值，需要的朋友一起跟随小编来看看吧

Spring Boot 以Jar的方式部署启动，这个不用介绍了，之前也介绍了关于 Spring Boot + thymeleaf 的简单使用，但是今天遇到一个问题，我先描述下问题的场景：

由于运维部门的需求，项目需要以war的形式放到tomcat运行，而不是原定的jar的方式运行

配置了一下午，也查了一下午的资料，以war的方式在Tomcat能运行，并且能访问Controller，但是在返回html视图时，找不到视图模板。最终发现问题在Thymeleaf的配置，话不多说，具体看操作步骤：

1、Spring boot 容器配置需要继承 SpringBootServletInitializer

这里我继承的是web.suport下面的SpringBootServletInitializer。

@SpringBootApplication
public class Application extends SpringBootServletInitializer {
  @Override
  protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
    return application.sources(Application.class);
  }
  public static void main(String[] args) throws Exception {
    SpringApplication.run(Application.class, args);
  }
}

2、更新你的Maven or Gradle 打包方式配置

下一步是更新你的构建配置，这样你的项目将产生一个war包而不是jar包。如果你使用Maven，并使用spring-boot-starter-parent（为了配置Maven的war插件），所有你需要做的就是更改pom.xml的packaging为war：

<packaging>war</packaging>

如果你使用Gradle，你需要修改build.gradle来将war插件应用到项目上：

apply plugin: 'war'

3、确保内嵌的servlet容器不能干扰war包将部署的servlet容器

为了达到这个目的，你需要将内嵌容器的依赖标记为provided。

如果使用Maven：

<dependencies>
  <!-- … -->
  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-tomcat</artifactId>
    <scope>provided</scope>
  </dependency>
  <!-- … -->
</dependencies>

如果使用Gradle：

dependencies {
  // …
  providedRuntime 'org.springframework.boot:spring-boot-starter-tomcat'
  // …
}

以上步骤配置好，maven or Gradle 在build的时候就会打成war包，这里可能还需要注意一个编码的问题，这个就大家自己去找了，具体详情参照：Spring 源码

配置好这些，确实能在Tomcat启动了，但是对于Controller返回页面视图，却还不够，还需要配置模板的参数，这里我使用的是Thymeleaf ，所以就介绍Thymeleaf 的配置方式

4、Thymeleaf 的配置

如果你是用的.properties方式配置的参数，那么只需要在你的application.properties配置下面加上：

# THYMELEAF (ThymeleafAutoConfiguration)
spring.thymeleaf.check-template-location=true
spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html
spring.thymeleaf.mode=HTML5
spring.thymeleaf.encoding=UTF-8
spring.thymeleaf.content-type=text/html
spring.thymeleaf.cache=false

每一个配置项的具体意思就自己去查了，这里不细说，如果你是用.yml的方式进行配置项的话，那么需要在application.yml里面配置如下参数：

spring:
 thymeleaf:
  cache: false
  check-template-location: true
  prefix: classpath:/templates/
  suffix: .html
  mode: HTML5
  encoding: UTF-8
  content-type: text/html

其实重要的就是prefix，因为放到tomcat里面之后， Thymeleaf 就找不到默认的templates 模板路径了，所以这里需要重新指明一下，这个问题也困扰了我一下午加一晚上，刚刚才调完，现在记录下，后人谨记！！

总结

以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作具有一定的参考学习价值，谢谢大家对脚本之家的支持。如果你想了解更多相关内容请查看下面相关链接

您可能感兴趣的文章:

Mybatis中collection和association的使用区别详解
这篇文章主要介绍了Mybatis中collection和association的使用区别详解，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-11-11
快速了解Hibernate中的Session
这篇文章主要介绍了快速了解Hibernate中的Session，具有一定借鉴价值，需要的朋友可以参考下。
2017-12-12
Java中synchronized关键字引出的多种锁问题
synchronized关键字是JAVA中常用的同步功能，提供了简单易用的锁功能。这篇文章主要介绍了Java中synchronized关键字引出的多种锁问题,需要的朋友可以参考下
2019-07-07
Java中ArrayList类的源码解析
本文主要介绍了Java中ArrayList类的源码解析，具有很好的参考价值。下面跟着小编一起来看下吧
2017-03-03
关于maven环境的安装及maven集成idea环境的问题
Maven 是一个基于 Java 的工具，所以要做的第一件事情就是安装 JDK。本文重点给大家介绍关于maven环境的安装及和idea环境的集成问题，感兴趣的朋友一起看看吧
2021-09-09
彻底理解Java中this 关键字
这篇文章主要介绍了彻底理解Java中this 关键字的相关资料,非常不错，具有参考价值，需要的朋友可以参考下
2016-05-05
Java读取Oracle大字段数据（CLOB）的2种方法
这篇文章主要介绍了Java读取Oracle大字段数据（CLOB）的2种方法,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-04-04
浅谈JVM之使用JFR解决内存泄露
内存泄露的主要原因就是java中的对象生命周期有长有短。如果长生命周期的对象引用了短生命周期的对象，就有可能造成事实上的内存泄露。本文将介绍JVM之使用JFR解决内存泄露。
2021-06-06
浅析Spring IOC bean为什么默认是单例
单例的意思就是说在 Spring IoC 容器中只会存在一个 bean 的实例,无论一次调用还是多次调用,始终指向的都是同一个 bean 对象,本文小编将和大家一起分析Spring IOC bean为什么默认是单例,需要的朋友可以参考下
2023-12-12
Java实现学生选课管理系统
这篇文章主要为大家详细介绍了Java实现学生选课管理系统，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-07-07