在《Spring Boot（一）：快速开始》中介绍了如何使用 Spring Boot 构建一个工程，并且提供 RESTful API ，本节我们继续介绍如何使用 Spring Boot 渲染 Web 页面。
- 什么是 Thymeleaf ？
虽然我们目前拥有许多十分优秀的前端框架，例如： Vue 、 React 等，非常适用于前后端分离的场景，前端可以独立部署成为服务，前后端从物理上完全进行隔离，降低程序耦合度。但是 Spring Boot 官方依然为我们提供了模版引擎用于一些无需前后端分离的场景。 Thymeleaf 是新一代的模板引擎，在 Spring Boot 中，官方推荐使用 Thymeleaf 来做前端模版引擎。打开 https://start.spring.io/ 可以看到，在当前Spring Boot 的版本中（ 2.1.8.RELEASE ）， 官方提供的模版引擎有以下几种：
Thymeleaf
FreeMarker
Mustache
Groovy
Spring Boot 建议使用这些模版引擎，而并不推荐我们继续使用 JSP 。
Thymeleaf 具体特性如下：
Thymeleaf 在有网络和无网络的环境下皆可运行，即它可以让美工在浏览器查看页面的静态效果，也可以让程序员在服务器查看带数据的动态页面效果。这是由于它支持 html 原型，然后在 html 标签里增加额外的属性来达到模板+数据的展示方式。浏览器解释 html 时会忽略未定义的标签属性，所以 Thymeleaf 的模板可以静态地运行；当有数据返回到页面时，Thymeleaf 标签会动态地替换掉静态内容，使页面动态显示。
Thymeleaf 开箱即用的特性。它提供标准和 Spring 标准两种方言，可以直接套用模板实现 JSTL、 OGNL表达式效果，避免每天套模板、改 Jstl、改标签的困扰。同时开发人员也可以扩展和创建自定义的方言。
Thymeleaf 提供 Spring 标准方言和一个与 SpringMVC 完美集成的可选模块，可以快速的实现表单绑定、属性编辑器、国际化等功能。
2. 快速入门
这里我们先正常构建一个 Spring Boot 工程： spring-boot-thymeleaf ，在 pom.xml 文件中引入 Thymeleaf 的相关依赖，如下：
server:
port: 8080
spring:
application:
name: spring-boot-thymleaf
thymeleaf:
# 关闭thymeleaf缓存 开发时使用 否则没有实时画面
cache: false
# 检查模板是否存在，然后再呈现
check-template-location: true
# Content-Type value.
servlet:
content-type: text/html
# 启用MVC Thymeleaf视图分辨率
enabled: true
# Template encoding.
encoding: UTF-8
# 关闭严格模式
mode: LEGACYHTML5
# Prefix that gets prepended to view names when building a URL.
prefix: classpath:/templates/
# Suffix that gets appended to view names when building a URL.
suffix: .html
mvc:
# 指定静态资源处理路径
static-path-pattern: /static/**
view:
suffix: .htmlCOPY
有关 thymeleaf 都写明了注释，这里需要注意的有以下几点：
spring.thymeleaf.mode ：这里是配置当前模版的解析模式的，默认值为 HTML ，这时会开启严格模式，所有的 HTML 必须有头有尾，很多地方并不符合我们平时的书写习惯，这里最好关闭严格模式。
spring.thymeleaf.cache ：这里是 thymeleaf 的缓存，在平时的练习中最好关闭，否则页面修改后刷新浏览器将会无效，而在生产环境中，视具体的业务场景而定。
spring.mvc.static-path-pattern ：这里是配置我们静态资源的路径，一般默认是配置 /static/** 路径，这里用于存放我们的 js 、 css 、图片等静态资源。
配置通用 404 和 500 页面，直接在 templates\error 创建对应页面即可，这里可以看一下 Spring Boot 错误页面转发的源码 org.springframework.boot.autoconfigure.web.servlet.error.DefaultErrorViewResolver，如下：
@Override
public ModelAndView resolveErrorView(HttpServletRequest request, HttpStatus status, Map<String, Object> model) {
ModelAndView modelAndView = resolve(String.valueOf(status.value()), model);
if (modelAndView == null && SERIES_VIEWS.containsKey(status.series())) {
modelAndView = resolve(SERIES_VIEWS.get(status.series()), model);
}
return modelAndView;
}
private ModelAndView resolve(String viewName, Map<String, Object> model) {
String errorViewName = “error/” + viewName;
TemplateAvailabilityProvider provider = this.templateAvailabilityProviders.getProvider(errorViewName,
this.applicationContext);
if (provider != null) {
return new ModelAndView(errorViewName, model);
}
return resolveResource(errorViewName, model);
}COPY
可以看到这里会根据当前的状态响应码转发到对应的页面，路由为 error/** 。笔者这里简单创建两个错误页面，如图：
创建测试 Controller ，如下：
@Controller
public class HelloController {
@GetMapping("/hello")
public String hello(HttpServletRequest request) {
// 构建测试数据
Map<String, Object> map = new HashMap<>();
UserModel userModel = new UserModel();
userModel.setId(1L);
userModel.setName("Spring Boot");
userModel.setAge(18);
map.put("user", userModel);
List<CourseModel> list = new ArrayList<>();
for (int i = 0; i < 2; i++) {
CourseModel courseMode = new CourseModel();
courseMode.setId((long) i);
courseMode.setName("Spring Boot：" + i);
courseMode.setAddress("课程地点：" + i);
list.add(courseMode);
}
map.put("list", list);
map.put("flag", true);
request.setAttribute("data", map);
return "hello";
}
}COPY
在此注册测试类中，进行数据初始化并输出至页面。
Thymeleaf 默认的模板路径 src/main/resources/templates ，只需要在这个这个路径下编写模版文件即可。
Thymeleaf 模版文件如下：
| # | 姓名 | 年龄 |
|---|---|---|
| # | 课程名称 | 课程地点 |
|---|---|---|
<div th:if="${data.flag == true}">如果 flag 为 true 你将可以看到这行字：）</div>
关键字 功能介绍 案例
th:id 替换id
th:text 文本替换
description
th:utext 支持html的文本替换
conten
th:object 替换对象
th:value 属性赋值
th:with 变量赋值运算
th:style 设置样式 th:style="‘display:’ + @{( KaTeX parse error: Expected 'EOF', got '}' at position 36: …'inline-block')}̲ + ''" th:oncli…{users}">
th:if 判断条件
th:unless 和th:if判断相反 <a th:href="@{/login}" th:unless= {session.user != null}>Login />
th:switch 多路选择 配合th:case 使用
th:case th:switch的一个分支
User is an administrator
th:fragment 布局标签，定义一个代码片段，方便其它地方引用
th:include 布局标签，替换内容到引入的文件 />
th:replace 布局标签，替换整个标签到引入的文件
th:selected selected选择框 选中 th:selected="(${xxx.id} == ${configObj.dd})"
th:src 图片类地址引入
th:inline 定义js脚本可以使用变量
