【Spring Boot】Spring Boot + Thymeleaf搭建mvc项目

Spring Boot + Thymeleaf搭建mvc项目

      • [1. 创建Spring Boot项目](#1. 创建Spring Boot项目)
      • [2. 配置pom.xml](#2. 配置pom.xml)
      • [3. 配置Thymeleaf](#3. 配置Thymeleaf)
      • [4. 创建Controller](#4. 创建Controller)
      • [5. 创建Thymeleaf页面](#5. 创建Thymeleaf页面)
      • [6. 创建Main启动类](#6. 创建Main启动类)
      • [7. 运行项目](#7. 运行项目)
      • [8. 测试结果](#8. 测试结果)
      • 扩展:添加静态资源

1. 创建Spring Boot项目

  1. 打开IntelliJ IDEA → New Project → 选择Maven → 直接点击Create
  2. 输入项目名称:springboot-demo
    确认GroupId(如:vip.buddha)和ArtifactId(保持与项目名一致)

2. 配置pom.xml

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 中添加:

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

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

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

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. 运行项目

创建完毕目录结构如下:

  1. 找到主类 Main.java,右键运行 main 方法。
  2. 控制台输出 Started Main 表示启动成功。
  3. 访问 http://localhost:8080/hello 查看页面。

8. 测试结果

页面会显示:

复制代码
Hello, Thymeleaf!

Spring Boot 的启动类(Main Class)是整个应用程序的入口点,负责初始化 Spring 上下文并启动应用。

@SpringBootApplication组合了以下三个注解的功能:

  • @SpringBootConfiguration(标记当前类为 Spring Boot

    的配置类);

  • @EnableAutoConfiguration(启用 Spring Boot 的自动配置机制);

  • @ComponentScan(自动扫描当前包及其子包下的组件(如 @Controller, @Service, @Repository

    等))


扩展:添加静态资源

  1. src/main/resources/static 下放置CSS/JS文件(如 style.css)。
  2. 在HTML中引用:
html 复制代码
<link th:href="@{/style.css}" rel="stylesheet">

相关推荐
程序员爱钓鱼1 分钟前
Go语言实战案例-简易计算器(加减乘除)
后端
学不会就看6 分钟前
Django--01基本请求与响应流程
后端·python·django
Nejosi_念旧6 小时前
解读 Go 中的 constraints包
后端·golang·go
风无雨6 小时前
GO 启动 简单服务
开发语言·后端·golang
小明的小名叫小明6 小时前
Go从入门到精通(19)-协程(goroutine)与通道(channel)
后端·golang
斯普信专业组6 小时前
Go语言包管理完全指南:从基础到最佳实践
开发语言·后端·golang
ladymorgana7 小时前
【spring boot】三种日志系统对比:ELK、Loki+Grafana、Docker API
spring boot·elk·grafana
一只叫煤球的猫7 小时前
【🤣离谱整活】我写了一篇程序员掉进 Java 异世界的短篇小说
java·后端·程序员
程序员秘密基地8 小时前
基于html,css,vue,vscode,idea,,java,springboot,mysql数据库,在线旅游,景点管理系统
java·spring boot·mysql·spring·web3
你的人类朋友8 小时前
🫏光速入门cURL
前端·后端·程序员