以下是一個基礎 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
添加對應依賴即可。