初学Thymeleaf，笔记（防老年痴呆）

 

Thymeleaf官方学习地址：https://www.thymeleaf.org/doc/tutorials/2.1/usingthymeleaf.html#what-is-thymeleaf

以下是个人笔记(只记录了比较具有特色的方言)：

Spring Boot提供了默认配置的模板引擎主要有以下几种：

• Thymeleaf
• FreeMarker
• Velocity
• Groovy
• Mustache

 因项目需要使用SpringBoot框架，所以需了解几种默认的模版引擎。

Thymeleaf标准表达式功能的快速了解：

• 简单表达：变量表达式： ${...}
• 选择变量表达式： *{...}
• 消息表达式： #{...}
• 链接网址表达式： @{...}
• 字面文本文字：'one text'，'Another one!'，...
• 号码文字：0，34，3.0，12.3，...
• 布尔文字：true，false
• 空文字： null
• 文字标记：one，sometext，main，...
• 文字操作：字符串连接： +
• 字面替换： |The name is ${name}|
• 算术运算：二元运算符：+，-，*，/，%
• 减号（一元运算符）： -
• 布尔运算：二元运算符：and，or
• 布尔否定（一元运算符）： !，not
• 比较和平等：比较：>，<，>=，<=（gt，lt，ge，le）
• 平等运营商：==，!=（eq，ne）
• 有条件的运营商：IF-THEN： (if) ? (then)
• IF-THEN-ELSE： (if) ? (then) : (else)
• 默认： (value) ?: (defaultvalue)
• 所有这些功能都可以组合和嵌套使用：
• 例子：'User is of type ' + (${user.isAdmin()} ? 'Administrator' : (${user.type} ?: 'Unknown'))

${...}表达式实际上是在上下文中包含的变量映射上执行的OGNL（对象 - 图形导航语言）表达式。

OGNL官方了解地址：http://commons.apache.org/proper/commons-ognl/

表达式基本对象,可用于表达式以获得更高的灵活性,将以#符号开头引用这些对象（按照OGNL标准）：

• #ctx：上下文对象。
• #vars: 上下文变量。
• #locale：上下文区域设置。
• #httpServletRequest:(仅限Web Contexts）HttpServletRequest对象。
• #httpSession:(仅限Web Contexts）HttpSession对象。

          基本对象详情

除了这些基本对象，Thymeleaf还将为我们提供一组实用程序对象，帮助我们在表达式中执行常见任务。

• #dates：java.util.Date对象的实用方法：格式化，组件提取等。
• #calendars：类似于#dates，但java.util.Calendar对象。
• #numbers：用于格式化数字对象的实用方法。
• #strings：String对象的实用方法：contains，startsWith，prepending / appending等。
• #objects：一般的对象的实用方法。
• #bools：布尔评估的实用方法。
• #arrays：数组的实用方法。
• #lists：列表的实用方法。
• #sets：集合的实用方法。
• #maps：地图的实用方法。
• #aggregates：用于在数组或集合上创建聚合的实用程序方法。
• #messages：用于在变量表达式中获取外部化消息的实用程序方法，与使用＃{...}语法获取它们的方式相同。
• #ids：用于处理可能重复的id属性的实用程序方法（例如，作为迭代的结果）。

           了解Expression Utility对象详情

 

变量表达式不仅可以用${...}表达式编写，还可以用表达式编写*{...}。

官方示例：

<div th:object="${session.user}">
    <p>Name: <span th:text="*{firstName}">Sebastian</span>.</p>
    <p>Surname: <span th:text="*{lastName}">Pepper</span>.</p>
    <p>Nationality: <span th:text="*{nationality}">Saturn</span>.</p>
  </div>

对比（完全等同于上例）：

<div>
  <p>Name: <span th:text="${session.user.firstName}">Sebastian</span>.</p>
  <p>Surname: <span th:text="${session.user.lastName}">Pepper</span>.</p>
  <p>Nationality: <span th:text="${session.user.nationality}">Saturn</span>.</p>
</div>

 

Thymeleaf标准方言具有特殊的语法，@语法：@{...}

有不同类型的网址：

• 绝对的URL，比如 http://www.thymeleaf.org
• 相对URL，可以是：
  • 页面相对，像 user/login.html
  • 上下文相关，如/itemdetails?id=3（服务器中的上下文名称将自动添加）
  • 与服务器相关，~/billing/processInvoice（允许在同一服务器中调用另一个上下文（=应用程序）中的URL）。
  • 协议相对URL，如 //code.jquery.com/jquery-2.0.3.min.js

Thymeleaf可以在任何情况下处理绝对URL，但对于相对URL，它将要求您使用实现该IWebContext接口的上下文对象，该接口包含来自HTTP请求的一些信息以及创建相对链接所需的信息。

官方示例：

<!-- Will produce 'http://localhost:8080/gtvg/order/details?orderId=3' (plus rewriting) -->
<a href="details.html" 
   th:href="@{http://localhost:8080/gtvg/order/details(orderId=${o.id})}">view</a>

<!-- Will produce '/gtvg/order/details?orderId=3' (plus rewriting) -->
<a href="details.html" th:href="@{/order/details(orderId=${o.id})}">view</a>

<!-- Will produce '/gtvg/order/3/details' (plus rewriting) -->
<a href="details.html" th:href="@{/order/{orderId}/details(orderId=${o.id})}">view</a>

有些事情需要注意：

• th:href是属性修饰符属性：一旦处理，它将计算要使用的链接URL并将<a>标记的href属性设置为此URL。
• 我们可以使用表达式来指定URL参数（如您所见orderId=${o.id}）。还将自动执行所需的URL编码操作。
• 如果需要几个参数，这些参数将用逗号分隔 @{/order/process(execId=${execId},execType='FAST')}
• URL路径中也允许使用变量模板，例如 @{/order/{orderId}/details(orderId=${orderId})}
• 以/（like /order/details）开头的相对URL 将自动以应用程序上下文名称为前缀。
• 如果未启用cookie或尚未知道cookie，则";jsessionid=..."可能会在相对URL中添加后缀，以便保留会话。这称为URL重写，Thymeleaf允许您通过response.encodeURL(...)Servlet API为每个URL 插入自己的重写过滤器。
• 该th:href标记允许我们（可选）有一个静态的工作href在我们的模板属性，所以，当为原型的目的直接打开我们的模板链接仍然通航由浏览器。

 

文字替换允许轻松格式化包含变量值的字符串，而无需附加文字'...' + '...'。这些替换必须用竖线（|）包围，如：

官方示例：

<span th:text="|Welcome to our application, ${user.name}!|">

 相当于：

<span th:text="'Welcome to our application, ' + ${user.name} + '!'">

注意：${...}在|...|文字替换中只允许使用变量表达式（）。没有其他文字（'...'），布尔/数字标记，条件表达式等。