Thymeleaf 2017官方文档：现代Java模板引擎，提升设计与开发协作

1星需积分: 41 185 浏览量更新于2024-07-19 收藏 656KB PDF 举报

"Thymeleaf官方文档教程：使用Thymeleaf" Thymeleaf是一款强大的服务器端Java模板引擎，适用于web和独立环境，它支持HTML、XML、JavaScript、CSS以及纯文本的处理，旨在提供优雅且易于维护的模板开发方式。其核心理念是通过自然模板（Natural Templates）将逻辑注入到模板文件中，同时保持模板设计的原型性，从而促进设计与开发团队之间的良好沟通。 Thymeleaf的设计思想充分考虑了Web标准，特别是HTML5，这意味着你可以创建出符合规范的、可验证的模板，这对于那些对代码质量有严格要求的项目尤其重要。模板模式（Template Mode）是Thymeleaf的一大特色，它支持六种内置模板类型： 1. HTML模板：这是最常见的模板类型，用于构建网页结构和用户界面。 2. XML模板：适合数据交换和XML驱动的场景，常用于服务端与服务端之间的数据传输。 3. TEXT模板：可以直接嵌入纯文本内容，如邮件模板或简单的文本输出。 4. JAVASCRIPT模板：可以包含和处理JavaScript代码，有助于实现动态交互。 5. CSS模板：专门处理样式表，允许在模板中编写并管理CSS逻辑。 6. RAW模板：处理未转义的原始数据，通常用于安全敏感的场景，如输出用户输入前进行必要的处理。 Thymeleaf的版本信息，如文档版本20170724和项目版本3.0.7.RELEASE，表明这是一份较早时期的文档，但Thymeleaf的基本概念和功能依然适用。随着Thymeleaf的更新，可能已经增加了更多的特性、API和优化，用户应查阅最新的官方文档以获取最准确的信息。在实际应用中，开发者需要根据项目需求选择合适的模板模式，并利用Thymeleaf的模板语言（如Thymeleaf Expression Language，Thymeleaf Layout Dialect等）来嵌入Java表达式，动态生成页面内容。同时，模板的维护性和复用性也是Thymeleaf被广泛采用的关键因素，它能够帮助团队提高工作效率，减少重复劳动。 Thymeleaf文档提供了全面的指导，从入门到深入，包括如何设置环境、模板语法、指令使用、模板模式选择等方面，对于任何希望在Java web开发中使用模板引擎的开发者来说，都是不可或缺的参考资料。随着技术的发展，持续关注Thymeleaf的最新更新，确保你的知识库跟上行业潮流，是非常重要的。

We have added a String variable called today to our context, and now we can display it in our template:

<body>

Welcome to our grocery store!

Today is: 13 February 2011

</body>

As you can see, we are still using the th:text attribute for the job (and that’s correct, because we want to replace the

tag’s body), but the syntax is a little bit different this time and instead of a #{...} expression value, we are using a

${...} one. This is a variable expression, and it contains an expression in a language called OGNL (Object-Graph

Navigation Language) that will be executed on the context variables map we talked about before.

The ${today} expression simply means “get the variable called today”, but these expressions could be more complex

(like ${user.name} for “get the variable called user, and call its getName() method”).

There are quite a lot of possibilities in attribute values: messages, variable expressions… and quite a lot more. The

next chapter will show us what all these possibilities are.

Page 16 of 104

When evaluating OGNL expressions on the context variables, some objects are made available to expressions for

higher flexibility. These objects will be referenced (per OGNL standard) starting with the # symbol:

#ctx : the context object.

#vars: the context variables.

#locale : the context locale.

#request : (only in Web Contexts) the HttpServletRequest object.

#response : (only in Web Contexts) the HttpServletResponse object.

#session : (only in Web Contexts) the HttpSession object.

#servletContext : (only in Web Contexts) the ServletContext object.

So we can do this:

Established locale country: US.

You can read the full reference of these objects in Appendix A.

Expression Utility Objects

Besides these basic objects, Thymeleaf will offer us a set of utility objects that will help us perform common tasks in

our expressions.

#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).

You can check what functions are offered by each of these utility objects in the Appendix B.

Reformatting dates in our home page

Now we know about these utility objects, we could use them to change the way in which we show the date in our home

page. Instead of doing this in our HomeController :

Page 20 of 104

剩余103页未读，继续阅读

M_A_I

粉丝: 3
资源: 7

Thymeleaf 2017官方文档：现代Java模板引擎，提升设计与开发协作

Thymeleaf3.0.11官方文档中文版

Thymeleaf中文文档合集-最新版

Thymeleaf 官方参考手册

thmeleaf 引入样式没生效

thmeleaf 一般会结合vue吗

thmeleaf路径传参

thmeleaf vue冲突

thmeleaf嵌套页面

thmeleaf中th:field 对select标签不起作用

Thymeleaf中文参考手册_3.0.5版_thymeleaf_thymeleaf中文网_thymeleaf文档_thmele

最新资源