Spring Boot 3.x 项目搭建 （一）

以下是一个基础 Spring Boot 项目的创建指南，整合了官方推荐方式和实用配置，帮助您快速搭建可运行的项目骨架。

---

一、项目创建方式

1. 在线工具 Spring Initializr（推荐）

• 步骤：
  1. 访问 Spring Initializr 。
  2. 配置参数：
     • Project: Maven/Gradle（选Maven更通用）
     • Language: Java
     • Spring Boot: 最新稳定版（如3.x）
     • Group: com.example（组织标识）
     • Artifact: demo（项目名）
     • Dependencies: 添加 Spring Web（基础Web支持）。
  3. 点击 Generate 下载ZIP包，解压后导入IDE（如IntelliJ IDEA）。

2. IDE 直接创建（IntelliJ IDEA）

• 步骤：
  1. File → New → Project → Spring Initializr。
  2. 填写 Group、Artifact，勾选依赖（如 Spring Web）。
  3. 完成创建，IDE 自动生成项目结构和配置文件。

---

二、项目结构解析

生成的项目包含以下核心文件：

src/
├── main/
│   ├── java/
│   │   └── com/example/demo/
│   │       ├── DemoApplication.java   # 主启动类
│   │       ├── controller/            # 控制器层（示例：HelloWorldController）
│   ├── resources/
│       ├── application.properties      # 配置文件
│       ├── static/                     # 静态资源（CSS/JS）
│       └── templates/                  # 模板文件（HTML）
└── test/                               # 单元测试目录
pom.xml                                 # Maven依赖管理

---

⚙️ 三、添加基础代码

1. 示例控制器

在 controller 包下创建 HelloWorldController.java：

package com.example.demo.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloWorldController {

    @GetMapping("/hello")
    public String hello() {
        return "Hello, Spring Boot!";
    }
}

2. 单元测试

在 test 目录下添加控制器测试：

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.web.servlet.MockMvc;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;

@SpringBootTest
@AutoConfigureMockMvc
public class HelloWorldControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @Test
    public void testHello() throws Exception {
        mockMvc.perform(get("/hello"))
               .andExpect(content().string("Hello, Spring Boot!"));
    }
}

---

四、运行与验证

1. 启动项目：

   • 运行 DemoApplication.java 中的 main() 方法。
   • 控制台输出 Tomcat started on port 8080 表示成功。

2. 访问接口：

   • 浏览器打开 http://localhost:8080/hello，显示 Hello, Spring Boot! 。

3. 打包部署：

   • 命令行执行 mvn clean package 生成 target/demo-0.0.1-SNAPSHOT.jar。
   • 通过 java -jar demo-0.0.1-SNAPSHOT.jar 独立运行。

---

五、可选增强配置

• 日志配置：
  在 resources 下创建 logback-spring.xml，定制日志格式和输出路径。
• 数据库支持：
  添加依赖 spring-boot-starter-data-jpa + mysql-connector-java，配置 application.properties：

  spring.datasource.url=jdbc:mysql://localhost:3306/demo
  spring.datasource.username=root
  spring.datasource.password=root
  

提示：以上项目已包含基础Web功能，如需扩展（如数据库、安全等），在 pom.xml 添加对应依赖即可。