springboot~手动加载thymeleaf模版

thymeleaf在spring-mvc时代很是盛行，与freemaker组成了两大模版引擎，而进行springboot之后，很多项目都采用前后分离的模式，这使得模板引擎关注度少了；而在一些场景下，使用模板引擎还是有着不可替代的优势的，比如email模板，我们会把html模版文件和后端代码放到一个项目，这样部署更方便，组件的内聚性更强。

定义自己的模块引擎

/**
 * 定义一个目录为资源根目录的引擎
 * @author lind
 * @date 2022/8/18 9:04
 * @since 1.0.0
 */
@Configuration
public class EngConfig {
    @Bean("rootEngine")
    public SpringTemplateEngine springTemplateEngine() {
        SpringTemplateEngine templateEngine = new SpringTemplateEngine();
        templateEngine.addTemplateResolver(htmlTemplateResolver());
        return templateEngine;
    }
    @Bean
    public SpringResourceTemplateResolver htmlTemplateResolver(){
        SpringResourceTemplateResolver templateResolver = new SpringResourceTemplateResolver();
        templateResolver.setPrefix("classpath:/");
        templateResolver.setSuffix(".html");
        templateResolver.setTemplateMode(TemplateMode.HTML);
        templateResolver.setCharacterEncoding(StandardCharsets.UTF_8.name());
        return templateResolver;
    }
}

在需要使用email的地方，直接通过SpringTemplateEngine的process方法来渲染html模板

@RestController
@RequiredArgsConstructor
public class MailController {
    private final SpringTemplateEngine springTemplateEngine;
    private String template = "META-INF/spring/mail.html";

    /**
     * 发送email.
     *
     * @return
     */
    @GetMapping("/mail/send")
    public String send() {
        Context ctx = new Context();
        ctx.setVariable("message", "zhangsan");
        return springTemplateEngine.process(this.template, ctx);
    }
}

mail.html很简单，里面有个message的变量，由上面的后端代码传入

<html xmlns:th="http://www.thymeleaf.org">
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>

</head>
<body>
<h2 th:text="${message}" />
</body>
</html>