一、背景
Thymeleaf模板是Java的一种动态页面模板框架。
作用：类似JSP页面。
二、项目使用Thymeleaf框架需要的依赖
需要attoparser、javassist、ognl、thymeleaf、unbescape、slf4j等依赖。
适合Maven引入：
<dependency> <groupId>org.thymeleaf</groupId> <artifactId>thymeleaf</artifactId> <version>3.1.3.RELEASE</version> </dependency>普通的依赖下载链接：
https://github.com/thymeleaf/thymeleaf/releases/download/thymeleaf-3.1.0.RELEASE/thymeleaf-3.1.0.RELEASE-dist.zip
三、项目代码案例
(一)模板案例
在类路径下的 templates目录下有index.html文件模板，内容如下：
<!DOCTYPE html> <html lang="en" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>主页</title> </head> <body> 名字：<p th:text="${name}"></p> 消息：<p th:text="${message}"></p> </body> </html>如图：
(二)测试代码
需要创建模板发现器、模板引擎、上下文对象。
代码如下：
import org.thymeleaf.TemplateEngine; import org.thymeleaf.context.Context; import org.thymeleaf.templateresolver.ClassLoaderTemplateResolver; /** * @author * @version 1.0.0 * <p> * date: 2025/12/25 **/ public class Test { public static void main(String[] args) { // 1、定义类路径模版发现器 ClassLoaderTemplateResolver resolver = new ClassLoaderTemplateResolver(); // 设置模板文件的前缀路径 resolver.setPrefix("templates/"); // 设置模板文件的后缀名 resolver.setSuffix(".html"); // 设置模板模式为HTML resolver.setTemplateMode("HTML"); // 设置字符编码 resolver.setCharacterEncoding("UTF-8"); // 禁用模版缓冲 resolver.setCacheable(false); // 2、定义模版引擎 TemplateEngine engine = new TemplateEngine(); // 设置模板发现器 engine.setTemplateResolver(resolver); // 3、定义上下文路径 Context context = new Context(); context.setVariable("name", "小明"); context.setVariable("message", "执行成功"); // 4、处理模板，返回填充后的结果 String str = engine.process("index", context); // 5、打印结果 System.out.println("结果如下："); System.out.println(str); } }说明：前缀是"templates/"，后缀是".html"，模版名是"index"，最终拼接的结果："templates/index.html"。
执行结果如下：
四、其他说明
1、其他的模板发现器
ServletContextTemplateResolver 适合Servlet的模版发现
UrlTemplateResolver 适合网络URL的模板发现
FileTemplateResolver 适合文件路径的模板发现
2、其他的处理方法
输出处理结果到某个Writer对象，例如："OutputStreamWriter类型对象"、"HttpServletResponse对象的getWriter()返回PrintWriter对象"。
void process(String template, IContext context, Writer writer)
3、其他的上下文对象
适合JavaWeb的上下文对象类：
WebContext(HttpServletRequest request, HttpServletResponse response, ServletContext servletContext)
