Spring Boot 常用模板引擎 Thymeleaf
Spring Boot 的模板引擎
现在市场上有很多模板引擎，比较典型的有 JSP、Velocity、Freemarker、Thymeleaf。所有模板引擎的思想都是一样的，都是通过组合 数据 和 模板 来生成 目标文本。Spring Boot 推荐的模板引擎是 Thymeleaf，语法简单，功能强大。
使用Thymeleaf
导入依赖jar包
1 | <!-- 对于springboot1.x --> |
spring-boot-autoconfigure-2.1.2.RELEASE.jar 中查看 ThymeleafProperties.java：
1 | ( |
Thymeleaf使用和语法
使用和语法参考 thymeleaf语法及下载页，下面进行大概介绍：
1）导入 thymeleaf 的名称空间（有语法提示）
1 | <html lang="en" xmlns:th="http://www.thymeleaf.org"> |
2）前端模板及后端参数值
1 |
|
1 | ("/success") |
3）语法规则
th:text: 改变当前元素里面的文本内容，并且需要注意的是，th:xxx 不仅能够改变当前html标签体里面的文本内容，而且它还可以替换html标签原生属性的值，例如上述示例的运行结果为：
1
<div id="这是后台传到前端的参数值" class="这是后台传到前端的参数值">这是后台传到前端的参数值</div>
常见thymeleaf标签及其优先级：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24Order Feature Attributes remarks
--------------------------------------------------------------------------------------
1 Fragment inclusion th:insert 片段包含，类似于jsp:include
th:replace
2 Fragment iteration th:each 遍历，类似于c:foreach
3 Conditional evaluation th:if 条件判断，类似于c:if
th:unless
th:switch
th:case
4 Local variable definition th:object 变量声明，类似于c:set
th:with
5 General attribute modification th:attr 任意属性的修改
th:attrprepend 前面追加内容
th:attrappend 后面追加内容
6 Specific attribute modification th:value 修改html标签任意指定属性的值
th:href
th:src
...
7 Text (tag body modification) th:text 修改html标签体里面的文本内容
（转义特殊字符，例如html标签）
th:utext 修改html标签体里面的文本内容
（不转义特殊字符）
8 Fragment specification th:fragment 声明片段
9 Fragment removal th:remove 移除片段thymeleaf能写哪些表达式呢？
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88Simple expressions (五种表达式):
1. VariableExpressions: ${...}
#1) 获取变量值用，底层是OGNL，支持OGNL语法，包括：
${person.father.name}、$person['father']['name']
${map['k1'].age}
${personArray[0].name}
${person.createCompleteNameWithSeparator('-')}
#2) 还可以使用内置的基本对象，包括：
上下文对象： <span th:text="${#ctx}"></span>
上下文参数： <span th:text="${#vars}">
上下文本地变量： <span th:text="${#locale.country}"></span>
HttpServletRequest请求对象： <span th:text="${#request}"></span>
HttpServletResponse响应对象： <span th:text="${#response}"></span>
HttpSession对象： <span th:text="${#session}"></span>
ServletContext对象： <span th:text="${#servletContext}"></span>
请求参数对象：<span th:text="${param.foo} + ${param.size()} +
${param.isEmpty()} + ${param.containsKey('foo')}"></span>
#3) 此外还可以使用一些工具对象，包括：
${#execInfo} : information about the template being processed.
${#messages} : methods for obtaining externalized messages inside variables expressions, in the same way as they would be obtained using #{...} syntax.
${#uris} : methods for escaping parts of URLs/URIs
${#conversions} : methods for executing the configured conversion service (if any).
${#dates} : methods for java.util.Date objects: formatting, component extraction, etc.
${#calendars} : analogous to #dates , but for java.util.Calendar objects.
${#numbers} : methods for formatting numeric objects.
${#strings} : methods for String objects: contains, startsWith, prepending/appending, etc.
${#objects} : methods for objects in general.
${#bools} : methods for boolean evaluation.
${#arrays} : methods for arrays.
${#lists} : methods for lists.
${#sets} : methods for sets.
${#maps} : methods for maps.
${#aggregates} : methods for creating aggregates on arrays or collections.
${#ids} : methods for dealing with id attributes that might be repeated (for example, as a result of an iteration).
2. SelectionVariableExpressions: *{...}
#1) 变量的选择表达式，和 ${} 在功能上是一样的，但它还有一个高级的应用：
<div th:object="${session.user}">
<!--firstName和lastName的继承自父标签中的session.user-->
<p><span th:text="*{firstName}"></span></p>
<p><span th:text="*{lastName}"></span></p>
</div>
3. MessageExpressions: #{...}
#获取国际化内容
4. LinkURLExpressions: @{...}
#用来定义URL链接
<a href="default_url" th:href="@{/xxx/details(orderId=
${o.id},orderType=${o.type})}"></a>
5. Fragment Expressions: ~{...}
#插入片段文档
<div th:insert="~{commons :: main}"> ... </div>
Literals (字面量):
Text literals: 'one text' , 'Another one!' ,...
Number literals: 0 , 34 , 3.0 , 12.3 ,...
Boolean literals: true , false
Nullliteral: null
Literal tokens: one , sometext , main ,...
Text operations (文本操作):
Stringconcatenation: +
Literal substitutions: |The name is ${name}|
Arithmetic operations (数学运算):
Binaryoperators: +, -, *, /, %
Minussign(unaryoperator): -
Boolean operations (布尔运算):
Binary operators: and , or
Boolean negation (unary operator): ! , not
Comparisons and equality (比较运算):
Comparators: >, <, >=, <= (gt, lt, ge, le)
Equality operators: == , != ( eq , ne )
Conditional operators (条件运算):
If-then: (if) ? (then)
If-then-else: (if) ? (then) : (else)
Default: (value) ?: (defaultvalue)
Special tokens (特殊操作符):
No-Operation: _
4) 示例
1 | <div id="defaut_id" th:id="${param_value_in_back}" class="default_class" th:class="${param_value_in_back}" th:utext="${param_value_in_back}">这是前端默认的文本</div> |