以下是一个基础 Spring Boot 项目的创建指南,整合了官方推荐方式和实用配置,帮助您快速搭建可运行的项目骨架。
🌟 一、项目创建方式
1. 在线工具 Spring Initializr(推荐)
- 步骤:
- 访问 Spring Initializr 。
- 配置参数:
- Project: Maven/Gradle(选Maven更通用)
- Language: Java
- Spring Boot: 最新稳定版(如3.x)
- Group:
com.example
(组织标识) - Artifact:
demo
(项目名) - Dependencies: 添加
Spring Web
(基础Web支持)。
- 点击 Generate 下载ZIP包,解压后导入IDE(如IntelliJ IDEA)。
2. IDE 直接创建(IntelliJ IDEA)
- 步骤:
File → New → Project → Spring Initializr
。- 填写
Group
、Artifact
,勾选依赖(如Spring Web
)。 - 完成创建,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 {@Autowiredprivate MockMvc mockMvc;@Testpublic void testHello() throws Exception {mockMvc.perform(get("/hello")).andExpect(content().string("Hello, Spring Boot!"));}
}
🚀 四、运行与验证
-
启动项目:
- 运行
DemoApplication.java
中的main()
方法。 - 控制台输出
Tomcat started on port 8080
表示成功。
- 运行
-
访问接口:
- 浏览器打开
http://localhost:8080/hello
,显示Hello, Spring Boot!
。
- 浏览器打开
-
打包部署:
- 命令行执行
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
添加对应依赖即可。