当前位置：首页 > news >正文

Thymeleaf 项目创建及请求响应过程解析

news 2026/8/6 13:57:29

创建项目

1. 使用Spring Initializr创建项目

访问 https://start.spring.io/ 或使用IDE的Spring Initializr功能，选择以下依赖：

Spring Web
Thymeleaf
Spring Boot DevTools（可选，用于开发时热部署）

项目结构
src/main/java/com/example/ThymeleafWeb/
├── ThymeleafWebApplication.java // 主启动类
├── controller/
│ └── HomeController.java // 控制器类
├── entity/
│ └── User.java // 实体类（可选）
└── service/
└── UserService.java // 服务类（可选）

src/main/resources/
├── templates/
│ ├── index.html // Thymeleaf模板文件
│ └── user.html // 用户页面模板
├── static/
│ ├── css/
│ ├── js/
│ └── images/
└── application.properties // 配置文件

2. Maven依赖配置

在 [pom.xml](file://E:\MES\work\bladex-boot\pom.xml) 中添加必要的依赖：

<dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-thymeleaf</artifactId></dependency></dependencies>

3. 控制器类示例

创建一个控制器来处理请求：

@ControllerpublicclassHomeController{@GetMapping("/")publicStringhome(Modelmodel){model.addAttribute("message","Hello Thymeleaf!");return"index";}}

4. Thymeleaf模板文件

在src/main/resources/templates/目录下创建index.html：

<!DOCTYPEhtml><htmlxmlns:th="http://www.thymeleaf.org"><head><title>Thymeleaf Demo</title></head><body><h1th:text="${message}">Default Message</h1></body></html>

5. 应用配置

在application.properties中可以配置Thymeleaf相关属性：

spring.thymeleaf.cache=false spring.thymeleaf.prefix=classpath:/templates/ spring.thymeleaf.suffix=.html

6.访问 http://localhost:8080 查看效果

关键依赖说明
你的 pom.xml 已经包含了必要的依赖：
spring-boot-starter-thymeleaf: Thymeleaf 模板引擎支持
spring-boot-starter-webmvc: Web MVC 功能
spring-boot-devtools: 开发工具，支持热部署
这样就完成了一个基本的 Java Thymeleaf 项目创建。

请求处理流程

启动Spring Boot应用
- 通过mvn spring-boot:run启动应用
- 内嵌Tomcat服务器在8080端口监听
请求路由
- 浏览器发送GET请求到根路径 [/](file://E:\java\Web-API\ThymeleafWeb\pom.xml)
- Spring MVC根据@RequestMapping或@GetMapping注解匹配处理器
控制器处理
- 请求到达标记为@Controller的控制器类
- 执行相应的处理方法，准备模型数据
视图解析
- 返回视图名称（如"index"）
- Thymeleaf视图解析器查找对应的模板文件
- 默认在src/main/resources/templates/目录下查找
模板渲染
- Thymeleaf引擎处理模板文件
- 替换模板中的占位符（如th:text="${message}"）
- 生成最终HTML内容
响应返回
- 将渲染后的HTML内容作为HTTP响应体返回
- 设置适当的HTTP头信息（Content-Type等）

当前项目状态

由于你当前的 [HomeController](file://E:\java\Web-API\ThymeleafWeb\src\main\java\com\example\thymeleafweb\controller\HomeController.java#L7-L15) 类还是空的，访问http://localhost:8080会返回404错误。需要添加适当的控制器方法来处理根路径请求。