目录
- Thymeleaf 官网: https://www.thymeleaf.org/
一、Thymeleaf 简介
1.1 什么是 Thymeleawf?
Thymeleaf
是一种用于服务端的 Java 模板引擎,主要用于构建 Web 应用程序,尤其是与 Spring 框架紧密结合的 Java Web 项目。它以优雅、高度可维护的方式将静态 HTML 模板与动态数据中相结合,生成最终的 HTML 页面。
- 在 Spring 生态系统中,Thymeleaf 已经成为许多项目构建用户界面的首选工具之一。
1.2 Thymeleaf 的特点和功能
Thymeleaf 的主要特点和功能包括:
- 自然模板: Thymeleaf 允许模板保持原生 HTML 的结构和语义,通过添加特殊的属性(成为属性处理器)来插入动态内容和逻辑,这些属性在浏览器中被视为 标准HTML,不影响静态预览。
- 模板语法: Thymeleaf 提供了丰富的表达式语言(如 Thymeleaf Expression Language,
ThEL
)和指令,用于处理条件判断、循环、变量赋值、链接生成、国际化等常见 Web 开发任务。 - 模板片段与布局: 支持模板片段和布局(通过
<layout:fragment>
等标签),便于实现页面组件化和页面结构的复用。 - 国际化支持: 内置对消息国际化(
i18n
)的支持,可以轻松切换语言和区域设置。 - 表单处理: 无缝集成 Spring MVC 的表单绑定、校验和错误处理,简化表单开发。
- 安全特性: 提供针对 XSS(跨站脚本攻击)的安全过滤器,确保输出内容的安全性。
- 与 Spring 的深度集成: Thymeleaf 提供了 Spring 的标准方言(SpringStandardDialect),可以方便地与 Spring MVC 及其他 Spring 项目(如 Spring Boot)配合使用,包括自动配置、视图解析、Spring EL 支持等。
- 可扩展性: 支持自定义方言和属性处理器,可以根据项目需求扩展 Thymeleaf 的功能。
- 多用途: 不仅限于 HTML,Thymeleaf 还可以处理 XML、JavaScript、CSS 甚至纯文本等文件类型。
二、SpringBoot 集成
2.1 Maven依赖
<!-- Thymeleaf -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
2.2 application.yml
server:
port: 8080
servlet:
context-path: / # 项目路径
spring:
mvc:
view:
prefix: /templates/
suffix: .html
2.3 Controller
@GetMapping(value = "/")
public String index() {
return "index";
}
注意:
- Controller 类中 不要使用 @RestController、@ResponseBody 等注解,这两个注解会阻拦 thymeleaf 将 String 类型解析为页面。
2.4 index.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Test</title>
<script src="https://code.jquery.com/jquery-3.1.1.min.js"></script>
</head>
<body>
<center><h1>这是一个测试</h1></center>
</body>
</html>
2.5 测试结果
- 访问地址:http://localhost:8080
效果如下图所示:
整理完毕,完结撒花~🌻