“原创不易，任何事都不会轻易容易”
这是泥瓦匠的第105篇原创
文章工程：
- JDK 1.8
- Maven 3.5.2
- Spring Boot 2.1.3.RELEASE
- 工程名：springboot-webflux-4-thymeleaf
- 工程地址：见文末
前言
上一讲，我们用 MongoDB 来实现 WebFlux 对数据源的操作。那么有了数据需要渲染到前台给用户展示。这就是本文关心的 View 层。View 的表现形式有很多，比如 JSON 和 HTML。开发中常用模板语言很常见的有 Thymeleaf、Freemarker等。那
什么是模板语言？
常见的模板语言都包含以下几个概念：数据（Data）、模板（Template）、模板引擎（Template Engine）和结果文档（Result Documents）。
- 数据
数据是信息的表现形式和载体，可以是符号、文字、数字、语音、图像、视频等。数据和信息是不可分离的，数据是信息的表达，信息是数据的内涵。数据本身没有意义，数据只有对实体行为产生影响时才成为信息。
- 模板
模板，是一个蓝图，即一个与类型无关的类。编译器在使用模板时，会根据模板实参对模板进行实例化，得到一个与类型相关的类。
- 模板引擎
模板引擎（这里特指用于Web开发的模板引擎）是为了使用户界面与业务数据（内容）分离而产生的，它可以生成特定格式的文档，用于网站的模板引擎就会生成一个标准的HTML文档。
- 结果文档
一种特定格式的文档，比如用于网站的模板引擎就会生成一个标准的HTML文档。
模板语言用途广泛，常见的用途如下：
- 页面渲染
- 文档生成
- 代码生成
- 所有 “数据+模板=文本” 的应用场景
Spring Boot 推荐使用的模板语言是 Thymeleaf，那
什么是 Thymeleaf？
官方的解释如下：
Thymeleaf 是现代的模板语言引擎，可以独立运行也可以服务于 Web。主要目标是为开发提供天然的模板，并且能在 HTML 里面准确的显示。
Thymeleaf 是新一代 Java 模板引擎，在 Spring 4 后推荐使用。目前是 Spring 5 自然更加推荐。
结构
类似上面讲的工程搭建，新建一个工程编写此案例。工程如图：
目录如下
- org.spring.springboot.webflux.controller - Controller 层
- org.spring.springboot.dao - 数据操作层 DAO
- org.spring.springboot.domain - 实体类
- org.spring.springboot.handler - 业务逻辑层
- Application - 应用启动类
- application.properties - 应用配置文件
- pom.xml maven 配置
- application.properties 配置文件
模板是会用到下面两个目录
- static 目录是存放 CSS、JS 等资源文件
- templates 目录是存放视图
本文重点在 Controller 层 和 templates 视图的编写。
新增 POM 依赖与配置
在 pom.xml 配置新的依赖：
这里我们增加了 Thymeleaf 依赖，但不用在 application.properties - 应用配置文件 配置人任何配置。默认启动其默认配置，如需修改配置参考 Thymeleaf 依赖配置，如下：
包括常用的 编码、是否开启缓存等等。
WebFlux 中使用 Thymeleaf
在 CityWebFluxController 控制层，添加两个方法如下：
解释下语法：
- 返回值 Mono 或者 String 都行，但是 Mono 代表着我这个返回 View 也是回调的。
- return 字符串，该字符串对应的目录在 resources/templates 下的模板名字。
- Model 对象来进行数据绑定到视图
- 一般会集中用常量管理模板视图的路径
Tymeleaf 视图
然后编写两个视图 hello 和 cityList，代码分别如下：
hello.html:
cityList.html:
常用语法糖如下
- ${...} 变量表达式
- th:text 处理 Tymeleaf 表达式
- th:each 遍历表达式，可遍历的对象：实现java.util.Iterable、java.util.Map（遍历时取java.util.Map.Entry）、array 等
还有很多使用参考官方方文档 http://www.thymeleaf.org/documentation.html
运行工程
下面运行工程验证下。使用 IDEA 右侧工具栏，点击 Maven Project Tab ，点击使用下 Maven 插件的 install 命令。或者使用命令行的形式，在工程根目录下，执行 Maven 清理和安装工程的指令：
在控制台中看到成功的输出：
在 IDEA 中执行 Application 类启动，任意正常模式或者 Debug 模式。可以在控制台看到成功运行的输出：
打开浏览器，访问 http://localhost:8080/city/hello ，可以看到如图的响应：
继续访问 http://localhost:8080/city/page/list , 发现没有值，那么按照上一讲插入几条数据即可有值，如图：
总结
这里，探讨了 Spring WebFlux 的如何整合 Thymeleaf 。整合其他模板语言 Thymeleaf、Freemarker，就大同小异了。下面，我们能会整合 Thymeleaf 和 MongoBD，实现一个整体的简单案例。
代码示例
本文示例读者可以通过查看下面仓库的中的模块工程名: 2-x-spring-boot-webflux-handling-errors：
- Github：https://github.com/JeffLi1993/springboot-learning-example
- Gitee：https://gitee.com/jeff1993/springboot-learning-example
如果您对这些感兴趣，欢迎 star、follow、收藏、转发给予支持！
参考资料
- Spring Boot 2.x WebFlux 系列：https://www.bysocket.com/archives/2290
- spring.io 官方文档
以下专题教程也许您会有兴趣
- 《程序兵法：算法与数据结构》 https://www.bysocket.com/technique/2314.html
《Spring Boot 2.x 系列教程》
https://www.bysocket.com/springboot
《Java 核心系列教程》
https://www.bysocket.com/technique/2100.html
由于能力有限，若有错误或者不当之处，还请大家批评指正，一起学习交流！
-The End-
号外：为读者持续几份最新教程，覆盖了 Spring Boot、Spring Cloud、微服务架构等。
获取方式：回复 java 或 666 ，领取 Spring 等最新教程
获取方式：回复 webflux 或 888，领取《Spring Boot 2 WebFlux 教程》
最新整理：关注公众号，回复 [获取资源]， 领取泥瓦匠整理的必学开源视频资源系列
长按二维码，扫扫关注哦
✬关注即可得 Spring Boot Cloud、微服务等干货✬
