Thymeleaf3.0.11官方文档中文版.pdf-资料库

Thymeleaf ⽤Thymeleaf ： 20181029 - 2018年10⽉29⽇： 3.0.11.RELEASE ： https ：//www.thymeleaf.org 教程：使⽂件版本项⽬版本项⽬⽹站

1介绍Thymeleaf 1.1什是Thymeleaf？ Thymeleaf是 Thymeleaf的端Java模于Web和理HTML，XML，JavaScript，CSS甚 Thymeleaf也了Web标准 - 特是HTML5 - 允 1.2 Thymeleaf过，Thymeleaf允 HTML XML JAVASCRIPT CSS （ HTML 和 XML ）（ TEXT ， JAVASCRIPT 和 CSS ）（ RAW ）该HTML模的HTML的括HTML5，HTML4和XHTML。码/结该XML模许XML输的 - 没对DTD或XML架该TEXT模 XML模该JAVASCRIPT模 JavaScript⽂理 TEXT ，，DOCTYPE，在Thymeleaf应的JavaScript⽂于JavaScript的的 TEXT 模与HTML⽂该 JAVASCRIPT 模等 - 如，HTML或该CSS模与Thymeleaf应⽤CSS⽂与 JAVASCRIPT 模， CSS 模⽤ TEXT 该RAW模 1.3⽅ Thymeleaf是，URL响，HTML格何Thymeleaf代合 - 加件 - 是，Thymeleaf的么⼀个现代服务器板引擎，适⽤独⽴环境，能够处⾄纯⽂本。主要⽬标是提供⼀种优雅且⾼度可维护的模板创建⽅式。为实现这⼀⽬标，它以⾃然模板的概念为基础，将其逻辑注⼊模板⽂件，其⽅式不会影响模板被⽤作设计原型。这改善了设计沟通，缩⼩了设计和开发团队之间的差距。从⼀开始就设计别许您创建完全验证的模板，如果您需要的话。程可以使⽤哪种模板？开箱即⽤许您处理六种模板，每种模板称为模板模式：⽂本⽣的有两种标记模板模式，三种⽂本模板模式和⼀种⽆操作模板模式。板模式将允许任何类型输⼊，包不会执⾏验证或格式良好检查，并且将在输出中尽可能地尊重模板代构。板模式将允⼊。在这种情况下，代码应该是格式良好有未封闭的标签，没有不带引号的属性等果发现格式错误，解析器将抛出异常。请注意，不会执⾏验证（针构）。板模式将允许⾮标记性质的模板使⽤特殊的语法。此类模板的⽰例可能是⽂本电⼦邮件或模板⽂档。请注意板也可以被处在这种情况下，它们不会被解析为标记，并且每个标记注释等都将被视为纯⽂本。板模式将允许⽤程序件的处理。这意味着能够以件相同的⽅式在件中使⽤模型数据，但是使⽤特定集成，例如专⻔的转义或⾃然脚本。板模式被认为是⼀种⽂本模式，因此使⽤相同的特殊语法板模式。板模式将允许参件的处理。式类似板模式也是⽂本模式，并使模板模式中的特殊处理语法。板模式将根本不处理模板。它⽤于将未经处理的资源（⽂件应等）插⼊到正在处理的模板中。例如式的外部⾮受控资源可以包含在应⽤程序模板中，安全地知道这些资源可能包含的任码都不会被执⾏。⾔：标准⽅⾔⼀个极易扩展的模板引擎（实际上它可以称为模板引擎框架），允许您定义和⾃定义模板处理的细节级别。将⼀些逻辑应⽤于标记⼯件（标签，某些⽂本，注释或仅仅是占位符，如果模板不是标记）的对象称为处理器，这些处理器的集上可能还有⼀些额外的⼯什么⼀个⽅⾔通常是由。开箱即⽤核⼼库提供了⼀种称为标准⽅⾔的⽅⾔，对⼤多数⽤⼾来说应该⾜够了。请注意，⽅⾔实际上可以没有处理器，并且完全由其他类型的⼯件组成，但处理器绝对是最常⻅的⽤例。

Thymeleaf也的thymeleaf-spring3和thymeleaf-spring4集为“SpringStandard⽅⾔”的 OGNL）⽤Spring框是Spring MVC⽤），⽤Spring Expression Language或SpringEL代在Spring应的JSP可⽰HTML模 ...... Thymeleaf Standard Dialect将由 ${user.name} 在为“James Carrot”）本教程涵盖标准⽅⾔。您将在以下⻚⾯中了解的每个属性和语法功能都由此⽅⾔定义，即使未明确提及。当然，如果⽤⼾希望在利⽤库的⾼级功能的同时定义⾃⼰的处理逻辑，则可以创建⾃⼰的⽅⾔（甚⾄扩展标准⽅⾔）。可以配置为⼀次使⽤多种⽅⾔。官⽅成包都定义了⼀种称⽅⾔，它与标准⽅⾔⼤致相同，但是为了更好地利架中的某些功能（例如使替。因此，如果您⼾，那么您不会浪费时间，因为您在此处学习的⼏乎所有内容都将⽤程序中使⽤。标准⽅⾔的⼤多数处理器都是属性处理器。这使得浏览器甚⾄可以在处理之前正确显板⽂件，因为它们只会忽略其他属性。例如，虽然使⽤标记库能包含不能由浏览器直接显⽰的代码⽚段，例如：允许我们实现相同的功能：这不仅可以被浏览器正确显⽰，⽽且还允许我们（可选地）在其中指定值属性（在这种情况下，当在浏览器中静态打开原型时将显⽰该属性，并且这将处理模板期间评估得到的值代替。这有助于您的设计⼈员和开发⼈员处理相同的模板⽂件，并减少将静态原型转换为⼯作模板⽂件所需的⼯作量。执⾏此操作的能⼒是称为⾃然模板的功能。

2 The Good Thymes虚在Good Thymes Virtual Grocery GitHub存 2.1杂⽤Thymeleaf处 Customers Orders Comments Products ⽰Thymeleaf的建 Products 销由 Service 包 public class ProductService { ... public List findAll() { return ProductRepository.getInstance().findAll(); } public Product findById(Integer id) { return ProductRepository.getInstance().findById(id); 拟杂货店可以储库中找到本指南的本章和后续章节中显⽰的⽰例的源代码。货店的⽹站为了更好地解释使理模板所涉及的概念，本教程将使⽤可从项⽬⽹站下载的演⽰应⽤程序。这个应⽤程序是⼀个假想的虚拟杂货的⽹站，并将为我们提供许多场景来展许多功能。⾸先，我们需要⼀套简单的模型实体⽤于我们的应⽤程序：通过创售。我们还将管理这些：⽰例应⽤程序模型我们的应⽤程序还有⼀个⾮常简单的服务层，含以下⽅法的对象组成：

} } 在Web层求URL将⽤Thymeleaf的 private boolean process(HttpServletRequest request, HttpServletResponse response) throws ServletException { try { // This prevents triggering engine executions for resource URLs if (request.getRequestURI().startsWith("/css") || request.getRequestURI().startsWith("/images") || request.getRequestURI().startsWith("/favicon")) { return false; } /* * Query controller/URL mapping and obtain the controller * that will process the request. If no controller is available, * return false and let other filters/servlets process the request. */ IGTVGController controller = this.application.resolveControllerForRequest(request); if (controller == null) { return false; } /* * Obtain the TemplateEngine instance. */ ITemplateEngine templateEngine = this.application.getTemplateEngine(); /* * Write the response headers */ response.setContentType("text/html;charset=UTF-8"); response.setHeader("Pragma", "no-cache"); response.setHeader("Cache-Control", "no-cache"); response.setDateHeader("Expires", 0); /* * Execute the controller and process view template, * writing the results to the response writer. */ controller.process( request, response, this.servletContext, templateEngine); return true; } catch (Exception e) { try { response.sendError(HttpServletResponse.SC_INTERNAL_SERVER_ERROR); } catch (final IOException ignored) { // Just ignore this } throw new ServletException(e); } } 的 IGTVGController 界 public interface IGTVGController { ，我们的应⽤程序将有⼀个过滤器，它将根据请执⾏委托给启命令：这是我们⾯：

public void process( HttpServletRequest request, HttpServletResponse response, ServletContext servletContext, ITemplateEngine templateEngine); } 建 IGTVGController 接⽤ ITemplateEngine 对 2.2创的process（...） ITemplateEngine templateEngine = this.application.getTemplateEngine(); 着GTVGApplication类置Thymeleaf应： TemplateEngine 实（ ITemplateEngine 接的 org.thymeleaf.TemplateEngine 对 public class GTVGApplication { ... private final TemplateEngine templateEngine; ... public GTVGApplication(final ServletContext servletContext) { super(); ServletContextTemplateResolver templateResolver = new ServletContextTemplateResolver(servletContext); // HTML is the default mode, but we set it anyway for better understanding of code templateResolver.setTemplateMode(TemplateMode.HTML); // This will convert "home" to "/WEB-INF/templates/home.html" templateResolver.setPrefix("/WEB-INF/templates/"); templateResolver.setSuffix(".html"); 我们现在要做的就是创⼝的实现，从服务中检索数据并使象处理模板。最后，它看起来像这样：⽰例应⽤程序主⻚但⾸先让我们看看该模板引擎是如何初始化的。建和配置模板引擎我们的过滤器中⽅法包含以下⾏：这意味负责创建和配⽤程序中最重要的对象之⼀例⼝的实现）。我们象初始化如下：

// Template cache TTL=1h. If not set, entries would be cached until expelled templateResolver.setCacheTTLMs(Long.valueOf(3600000L)); // Cache is set to true by default. Set to false if you want templates to // be automatically updated when modified. templateResolver.setCacheable(true); this.templateEngine = new TemplateEngine(); this.templateEngine.setTemplateResolver(templateResolver); ... } } 置 TemplateEngine 对 ServletContextTemplateResolver templateResolver = new ServletContextTemplateResolver(servletContext); 现Thymeleaf API的为 org.thymeleaf.templateresolver.ITemplateResolver ： public interface ITemplateResolver { ... /* * Templates are resolved by their name (or content) and also (optionally) their * owner template in case we are trying to resolve a fragment for another template. * Will return null if template cannot be handled by this template resolver. */ public TemplateResolution resolveTemplate( final IEngineConfiguration configuration, final String ownerTemplate, final String template, final Map templateResolutionAttributes); } org.thymeleaf.templateresolver.ServletContextTemplateResolver 我 javax.servlet.ServletContext 每个Java Web应从Servlet上从Web应个GTVG应 templateResolver.setTemplateMode(TemplateMode.HTML); HTML是式 ServletContextTemplateResolver ， templateResolver.setPrefix("/WEB-INF/templates/"); templateResolver.setSuffix(".html"); 称“product / list”将 servletContext.getResourceAsStream("/WEB-INF/templates/product/list.html") 配象有很多种⽅法，但是现在这⼏⾏代码将⾜以告诉我们所需的步骤。模板解析器让我们从模板解析器开始：模板解析器是实接⼝的对象，称这些对象负责确定如何访问模板，在这⽤程序中，们将下⽂中检索模板⽂件作为资源的⽅式：⽤程序中都存在的应⽤程序范围的对象，并⽤程序根解析资源。但这并不是我们可以说的关于模板解析器的全部内容，因为我们可以在其上设置⼀些配置参数。⼀，模板模式：默认的模板模但最好还是建⽴它，以便我们的代码清楚地记录正在发⽣的事情。该前缀和后缀修改，我们将传递到发动机获得要使⽤的真实资源名称的模板名称。使⽤此配置，模板名对应于：

过cacheTTLMs属 templateResolver.setCacheTTLMs(3600000L); 该TTL之现 ICacheManager 接改 StandardCacheManager 对看Template Engine对是 org.thymeleaf.ITemplateEngine 接由Thymeleaf核 org.thymeleaf.TemplateEngine 我 templateEngine = new TemplateEngine(); templateEngine.setTemplateResolver(templateResolver); 数 TemplateEngine ，⽤Thymeleaf开（可选）通性在模板解析器中配置解析模板可以在缓存中⽣存的时间量：如果达到最⼤⾼速缓存⼤⼩并且它是当前⾼速缓存的最旧条⽬，则在达到前，模板仍然可以从⾼速缓存中排除。⽤⼾可以通过实⼝或修象来管理默认缓存来定义缓存⾏为和⼤⼩。关于模板解析器还有很多东西需要学习，但是现在让我们来看象的创建。模板引擎模板引擎对象⼝的实现。其中⼀个实现是⼼提供的：们在这⾥创建⼀个实例：相当简单，不是吗？我们所需要的只是创建⼀个实例并将模板解析器设置为它。模板解析器是唯⼀需要的参尽管稍后将介绍许多其他参数（消息解析器，缓存⼤⼩等）。现在，这就是我们所需要的。我们的模板引擎现已准备就绪，我们可以使始创建⻚⾯。

资料库

Thymeleaf3.0.11官方文档中文版.pdf

相关推荐

开发技术

热门标签

最新资料