在 Spring Boot 中配置多个 Thymeleaf 模板解析器

在 Spring Boot 应用中使用 Thymeleaf 作为模板引擎时，有时我们需要配置多个模板解析器来处理不同目录下的模板文件。例如，我们可能希望将 HTML 模板放在一个目录下，而将 SVG 模板放在另一个目录下。本文将介绍如何配置多个 SpringResourceTemplateResolver 来实现这一目标。

Spring Boot 默认会配置一个 Thymeleaf 模板解析器。如果我们想要添加额外的解析器，需要在配置类中定义相应的 Bean。

首先，我们需要在 application.properties 文件中配置默认 Thymeleaf 模板解析器的优先级。这可以确保我们自定义的解析器不会覆盖默认的解析器。

# 确保默认的 HTML 模板解析器优先级高于自定义的 SVG 解析器 spring.thymeleaf.template-resolver-order=0

接下来，创建一个配置类，并在其中定义额外的模板解析器 Bean。以下示例展示了如何配置一个用于解析 SVG 模板的 SpringResourceTemplateResolver：

import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.thymeleaf.templateresolver.ITemplateResolver; import org.thymeleaf.spring5.templateresolver.SpringResourceTemplateResolver;  @Configuration public class MyApplicationConfiguration {      @Bean     public ITemplateResolver svgTemplateResolver() {         SpringResourceTemplateResolver resolver = new SpringResourceTemplateResolver();         resolver.setPrefix("classpath:/templates/svg/");         resolver.setSuffix(".svg");         resolver.setTemplateMode("XML");         resolver.setCharacterEncoding("UTF-8"); // 推荐设置字符编码          return resolver;     } }

在这个示例中，我们创建了一个名为 svgTemplateResolver 的 Bean，并将它的 prefix 设置为 classpath:/templates/svg/，suffix 设置为 .svg，templateMode 设置为 XML。这意味着 Thymeleaf 将使用这个解析器来查找位于 classpath:/templates/svg/ 目录下的所有以 .svg 结尾的模板文件，并将它们解析为 XML 格式。

注意事项：

• 字符编码: 建议为每个 SpringResourceTemplateResolver 设置字符编码，例如 resolver.setCharacterEncoding(“UTF-8”);，以确保模板文件能够被正确解析。
• 优先级: 确保正确配置模板解析器的优先级，以避免冲突。 spring.thymeleaf.template-resolver-order 用于控制默认解析器的优先级，而 resolver.setOrder() 方法可以设置自定义解析器的优先级。Order值越小，优先级越高。
• 模板模式: 根据模板文件的类型设置正确的 templateMode。常用的模板模式包括 HTML、XML、TEXT 等。
• 缓存: 在开发过程中，为了方便调试，可以禁用 Thymeleaf 的缓存。可以通过在 application.properties 文件中设置 spring.thymeleaf.cache=false 来实现。

总结：

通过配置多个 SpringResourceTemplateResolver，我们可以灵活地管理不同类型的 Thymeleaf 模板。只需要正确配置模板解析器的优先级、前缀、后缀和模板模式，就可以确保 Thymeleaf 能够正确地解析和渲染模板。记住在开发过程中禁用缓存以方便调试。Spring Boot 会自动配置 SpringTemplateEngine 和 ViewResolver，无需手动定义。