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>