Spring Boot + Thymeleaf搭建mvc项目
- 1. 创建Spring Boot项目
- 2. 配置pom.xml
- 3. 配置Thymeleaf
- 4. 创建Controller
- 5. 创建Thymeleaf页面
- 6. 创建Main启动类
- 7. 运行项目
- 8. 测试结果
- 扩展：添加静态资源
1. 创建Spring Boot项目
- 打开IntelliJ IDEA → New Project → 选择Maven → 直接点击Create
- 输入项目名称：springboot-demo
确认GroupId（如：vip.buddha）和ArtifactId（保持与项目名一致）
2. 配置pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.7.0</version> <!-- 选择一个 2.x 版本 -->
</parent>
<groupId>vip.buddha</groupId>
<artifactId>springboot-demo</artifactId>
<version>1.0-SNAPSHOT</version>
<properties>
<maven.compiler.source>8</maven.compiler.source>
<maven.compiler.target>8</maven.compiler.target>
</properties>
<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>
</project>
依赖中无需指定版本的条件：
- 当依赖项属于 Spring Boot 官方提供的 Starter（如
spring-boot-starter-*），且父 POM 已通过<dependencyManagement>管理其版本时。
需要指定版本的条件：
- 使用非 Spring Boot 官方维护的第三方库（如
com.google.guava），此时必须显式指定版本。
3. 配置Thymeleaf
Spring Boot默认已配置Thymeleaf，但你可以自定义设置。在 src/main/resources/application.yml 中添加：
server:
port: 8080
spring:
application:
name: springboot-demo
thymeleaf:
# 开发时建议开启缓存
cache: false
# 设置编码
encoding: utf-8
4. 创建Controller
在 src/main/java/vip/buddha/controller 下新建一个Java类 HelloController.java：
package vip.buddha.controller;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
@Controller
public class HelloController {
@GetMapping("/hello")
public String sayHello(Model model) {
model.addAttribute("message", "Hello, Thymeleaf!");
return "hello"; // 对应src/main/resources/templates/hello.html
}
}
5. 创建Thymeleaf页面
在 src/main/resources/templates 下新建 hello.html：
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>Spring Boot + Thymeleaf</title>
</head>
<body>
<h1 th:text="${message}">默认消息</h1>
</body>
</html>
th:text="${message}"会替换为Controller中设置的message值。
6. 创建Main启动类
在 src/main/java/vip/buddha 下新建一个Java类 Main.java：
package vip.buddha;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class Main {
public static void main(String[] args) {
SpringApplication.run(Main.class, args);
}
}
7. 运行项目
创建完毕目录结构如下：
- 找到主类
Main.java，右键运行main方法。 - 控制台输出
Started Main表示启动成功。 - 访问 http://localhost:8080/hello 查看页面。
8. 测试结果
页面会显示：
Hello, Thymeleaf!
Spring Boot 的启动类（Main Class）是整个应用程序的入口点，负责初始化 Spring 上下文并启动应用。
@SpringBootApplication组合了以下三个注解的功能：
-
@SpringBootConfiguration（标记当前类为 Spring Boot
的配置类）； -
@EnableAutoConfiguration（启用 Spring Boot 的自动配置机制）；
-
@ComponentScan（自动扫描当前包及其子包下的组件（如 @Controller, @Service, @Repository
等））
扩展：添加静态资源
- 在
src/main/resources/static下放置CSS/JS文件（如style.css）。 - 在HTML中引用：
<link th:href="@{/style.css}" rel="stylesheet">
