[toc]

SpringBoot整合Thymeleaf

零、本片要点

介绍Thymeleaf的概念，理解Thymeleaf的便利且强大。
介绍如何快速整合SpringBoot和Thymeleaf。
介绍自动配置原理。

一、Thymeleaf简介

Thymeleaf是适用于Web和独立环境的现代服务器端Java模板引擎，能够处理HTML，XML，JavaScript，CSS甚至纯文本。

Thymeleaf的主要目标是提供一种优雅且高度可维护的模板创建方法。拿Html为例，它支持html原型，既可以让美工在浏览器查看页面的静态效果，也可以让开发者填充后端数据。

二、快速启动

需要引入thymeleaf需要的依赖，以及必要的web依赖。


    org.springframework.boot
    spring-boot-starter-thymeleaf


    org.springframework.boot
    spring-boot-starter-web

SpringBoot针对Thymeleaf提供了一套优秀的自动配置方案，这一套配置类的属性在org.springframework.boot.autoconfigure.thymeleaf.ThymeleafProperties，部分源码如下：

// 将application.properties前缀为【spring.thymeleaf】的配置和属性绑定
@ConfigurationProperties(prefix = "spring.thymeleaf")
public class ThymeleafProperties {
    //默认的编码格式
    private static final Charset DEFAULT_ENCODING = StandardCharsets.UTF_8;
    //默认视图解析器前缀
    public static final String DEFAULT_PREFIX = "classpath:/templates/";
    //默认视图解析器后缀
    public static final String DEFAULT_SUFFIX = ".html";
    private boolean checkTemplate = true;
    private boolean checkTemplateLocation = true;
    private String prefix = DEFAULT_PREFIX;
    private String suffix = DEFAULT_SUFFIX;
    private String mode = "HTML";
    private Charset encoding = DEFAULT_ENCODING;
    private boolean cache = true;
    //...

不难发现，如果开发者不配置前缀和后缀，视图解析的默认位置会在resources/templates/目录下，且文件后缀为.html。SpringBoot的强大之处就是提供了我们许多配置上的便利，比如，我们可以很容易地关闭Thymeleaf的缓存，在application.properties：

spring.thymeleaf.cache=false

SpringBoot为Thymeleaf提供的自动化配置类是：

@Configuration(proxyBeanMethods = false)
@EnableConfigurationProperties(ThymeleafProperties.class)
@ConditionalOnClass({ TemplateMode.class, SpringTemplateEngine.class })
@AutoConfigureAfter({ WebMvcAutoConfiguration.class, WebFluxAutoConfiguration.class })
public class ThymeleafAutoConfiguration {
    
}

可以看到，这个配置类首先导入了ThymeleafProperties配置类，然后通过@ConditionalOnClass注解标识这个类只有系统中存在TemplateMode和SpringTemplateEngine的时候才会生效，其实也就是引入了Thymeleaf相关依赖就会生效。

创建测试Controller

@Controller
public class HelloController {

    @GetMapping("/")
    public String index(ModelMap map){
        map.addAttribute("url","/list");
        map.addAttribute("msg","点我点我");
        return "index";
    }
}
@GetMapping("/list")
public String list(Model model){
    List users = new ArrayList<>();
    users.add(new User(UUID.randomUUID().toString(),"summerday",20));
    users.add(new User(UUID.randomUUID().toString(),"天乔巴夏",18));
    model.addAttribute("users",users);
    return "list";
}

由于我们并没有修改过视图解析的配置，我们需要在/resources/templates/提供名为index.html和list.html的文件。

编写Thymeleaf模板

list页面渲染结果如下：

sb3.png

除此之外，Thymeleaf还支持使用js获取Model中的变量：

三、源码下载

本文主要介绍了SpringBoot整合Thymeleaf自动配置的原理，以及快速启动demo项目需要的步骤。关于Thymeleaf本身，还有其他许多强大的用法，可以参照官方文档，一一测试：https://www.thymeleaf.org/doc/tutorials/3.0/usingthymeleaf.html

另外，本文的样例代码【包括其他基础标签的使用】均已上传至Gitee：https://gitee.com/tqbx/springboot-samples-learn

四、参考阅读

江南一点雨：极简 Spring Boot 整合 Thymeleaf 页面模板
官方文档：Tutorial:Using Thymeleaf
纯洁的微笑：Thymeleaf 使用详解
yizhiwazi：SpringBoot Thymeleaf 基于HTML5的现代模板引擎

SpringBoot整合Thymeleaf模板引擎