search

15.1 模板解析器

我们为百里香虚拟杂货店选择了一个叫做ServletContextTemplateResolver的ITemplateResolver实现。它允许我们像来自Servlet上下文的资源一样获取模版。

除了让我们能够通过实现ITemplateResolver创建我们自己的模版解析器，Thymeleaf包含了四种立即可用的实现：

  • org.thymeleaf.templateresolver.ClassLoaderTemplateResolver，当作类加载器资源解析模版，就像：

    return Thread.currentThread().getContextClassLoader().getResourceAsStream(template);

  • org.thymeleaf.templateresolver.FileTemplateResolver，当作来自文件系统的文件解析模版，就像：

    return new FileInputStream(new File(template));

  • org.thymeleaf.templateresolver.UrlTemplateResolver，当作URL（甚至非本地的URL）解析模版，就像：

    return (new URL(template)).openStream();

  • org.thymeleaf.templateresolver.StringTemplateResolver，当作String （以template指定，或者是模版名）解析模版：

    return new StringReader(templateName);

ITemplateResolver的所有预绑定的实现允许相同的一组配置参数。它包括：

  • 前缀和后缀（和已经看到的一样）：

    templateResolver.setPrefix("/WEB-INF/templates/");
templateResolver.setSuffix(".html");

  • 模版别名。他允许使用不直接等于文件名的模版名字。如果前缀/后缀和别名同时存在，别名会在前缀/后缀之前被应用：

    templateResolver.addTemplateAlias("adminHome","profiles/admin/home");
templateResolver.setTemplateAliases(aliasesMap);

  • 读取模板时的编码：

    templateResolver.setEncoding("UTF-8");

  • 使用的模板模式：

    // Default is HTML
templateResolver.setTemplateMode("XML");

  • 模板缓存的默认模式，以及定义指定模板是否可缓存的模式：

    // Default is true
templateResolver.setCacheable(false);
templateResolver.getCacheablePatternSpec().addPattern("/users/*");

  • 由这个模板解析器产生的模板缓存入口的存活时间（毫秒计）。如果没有设置，从缓存里移除一个入口的唯一方式将会是超过最大缓存量（最老的入口会被移除）。

    // Default is no TTL (only cache size exceeded would remove entries)
templateResolver.setCacheTTLMs(60000L);
Previous15 更多配置Next链接模板解析器

Last updated