Thymeleaf:面向 Java 的 XML/HTML 模板引擎

  • Bienvenido David
  • 张龙

2011 年 8 月 15 日

话题:JavaWeb框架语言 & 开发

Thymeleaf的首个稳定版(1.0.0 版)已经于上月 17 日发布了。Thymeleaf 是个 XML/XHTML/HTML5 模板引擎,可以用于 Web 与非 Web 应用。它是个开源的 Java 库,基于 Apache License 2.0 许可,由 Daniel Fernández 创建,Daniel Fernández 还是 Java 加密库Jasypt的作者。Thymeleaf 旨在替换掉 JSP 及其他的模板引擎,如 Velocity 与 FreeMarker。它提供了两个版本,分别是 Standard 方言与 SpringStandard(Spring MVC 3)方言,并且可以通过创建自定义方言进行扩展。

Thymeleaf 的主要目标在于提供一种可被浏览器正确显示的、格式良好的模板创建方式,因此也可以用作静态建模。你可以使用它创建经过验证的 XML 与 HTML 模板。相对于编写逻辑或代码,开发者只需将标签属性添加到模板中即可。接下来,这些标签属性就会在 DOM(文档对象模型)上执行预先制定好的逻辑。Thymeleaf 的可扩展性也非常棒。你可以使用它定义自己的模板属性集合,这样就可以计算自定义表达式并使用自定义逻辑。这意味着 Thymeleaf 还可以作为模板引擎框架。

那么 Thymeleaf 与其他流行的模板引擎如 Velocity 和 FreeMarker 相比如何呢?Thymeleaf 是与众不同的,因为它使用了自然的模板技术。这意味着 Thymeleaf 的模板语法并不会破坏文档的结构,模板依旧是有效的 XML 文档。模板还可以用作工作原型,Thymeleaf 会在运行期替换掉静态值。Velocity 与 FreeMarker 则是连续的文本处理器,这样他们就可以处理任何基于文本的模板了。另一方面,Thymeleaf 是个 XML 处理器,它使用了 DOM。只能处理基于 XML 格式的这种限制使得 Thymeleaf 能够充分利用 XML 和 Web 环境所独有的特性。注意,由于 Thymeleaf 使用了 XML DOM 解析器,因此它并不适合于处理大规模的 XML 文件。

下面的代码示例分别使用 Velocity、FreeMarker 与 Thymeleaf 打印出一条消息:

Velocity: <p>$message</p>

FreeMarker: <p>${message}</p>

Thymeleaf: <p th:text="${message}">Hello World!</p>

注意到 Thymeleaf 去掉了图形化标签,并支持硬编码的文本,在运行期可以将这些文本替换掉。

你可以使用表达式的形式编写 Thymeleaf 属性,一共有 4 种类型的属性,分别是变量表达式、选择表达式、文本具化表达式以及 URL 表达式。变量表达式是 Object-Graph Navigation Language(OGNL)表达式,如果使用了 SpringStandard,那么还可以使用 Spring EL,表达式在上下文图中执行。选择表达式类似于变量表达式,只不过他们是在父对象上执行。你可以通过文本具化表达式从外部资源如.properties 文件中检索内容。URL 表达式会将上下文与 Session 信息添加到 URL 中。感兴趣的读者可以阅读“Getting started with the Standard dialects”这篇文章详细了解 Thymeleaf 的使用示例。

你可以从 SourceForge 上下载 Thymeleaf并阅读Using Thymeleaf 指南来快速上手。如果使用 Maven,那么你可以使用 org.thymeleaf groupid 和 thymeleaf artifactId。Thymeleaf 最小的依赖是 Java SE 5、ognl 3.0、javassist 3.14.0-GA 及 slf4j 1.6.1。感兴趣的读者可以通过 Thymeleaf官方文档论坛了解更多信息。

查看英文原文:Thymeleaf: XML/HTML Template Engine for Java

JavaWeb框架语言 & 开发