Spring Boot 入门的关键步骤
1 创建 Maven 工程
-
操作目的: 通过 Maven 工程来管理项目依赖,Spring Boot 本身就依赖 Maven 或 Gradle 来简化依赖管理。
-
操作方法:
- 打开 IDEA(IntelliJ IDEA)。
- 点击
New Project
,选择Spring Initializr
。 - 填写基本项目信息:
- Group:项目组名称(类似包名,例如
com.example
)。 - Artifact:项目名称(例如
springboot-start
)。
- Group:项目组名称(类似包名,例如
- 选择 Maven 构建工具,填写其他参数。
- 点击下一步后,进入依赖选择页面。
2 导入 spring-boot-starter-web
起步依赖
-
操作目的: 添加 Spring Boot Web 相关的功能依赖,以便快速开发 Web 应用。
-
依赖作用: Spring Boot Starter Web 提供了一整套 Web 开发需要的依赖,包括:
- Spring MVC:处理 HTTP 请求和响应。
- 嵌入式 Tomcat:直接启动项目,无需单独安装服务器。
- JSON 支持:集成 Jackson 进行数据序列化/反序列化。
-
操作方法:
-
在依赖选择页面,勾选
Spring Web
模块。 -
IDEA 会自动生成一个包含
spring-boot-starter-web
依赖的pom.xml
文件,示例如下:<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>
-
3 编写 Controller
-
操作目的: 实现一个简单的 HTTP 接口,返回
Hello World
,验证项目能否正常运行。 -
示例代码: 在
src/main/java/com/example/controller
下创建一个类HelloController
:import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RestController; @RestController public class HelloController { @GetMapping("/hello") public String hello() { return "Hello World ~"; } }
@RestController
: 表示这是一个控制器类,返回的数据直接是 JSON 格式。@GetMapping("/hello")
: 映射 HTTP GET 请求到/hello
路径上。
4 提供启动类
-
操作目的: 通过 Spring Boot 的启动类来启动整个项目,运行 Spring 应用。
-
示例代码: 在
src/main/java/com/example
下创建主程序入口SpringbootStartApplication
:import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; @SpringBootApplication public class SpringbootStartApplication { public static void main(String[] args) { SpringApplication.run(SpringbootStartApplication.class, args); } }
@SpringBootApplication
: 这是 Spring Boot 项目的核心注解,表示这是一个 Spring Boot 应用,包含以下功能:- 启动自动配置。
- 启用组件扫描。
- 提供入口配置。
SpringApplication.run(...)
: 启动整个 Spring Boot 项目。
启动项目并测试
1 启动项目
-
在 IDEA 中运行
SpringbootStartApplication
的main
方法。 -
如果项目启动成功,控制台会显示类似以下内容:
Tomcat started on port(s): 8080 (http) Started SpringbootStartApplication in 2.345 seconds
2 测试接口
-
打开浏览器,访问
http://localhost:8080/hello
。 -
如果页面显示:
Hello World ~
恭喜!你的第一个 Spring Boot 应用已经成功运行了!??
总结
-
Spring Boot 项目从创建到运行,只需要几步:
- 使用 Spring Initializr 创建 Maven 工程。
- 引入 Web 起步依赖。
- 编写简单的 Controller。
- 提供启动类并运行项目。
-
核心注解与模块:
@SpringBootApplication
:负责整个项目的启动。@RestController
和@GetMapping
:定义 HTTP 接口。spring-boot-starter-web
:提供所有 Web 应用开发需要的基础功能。
-
开发效率极高:
- 自动化配置,无需手动部署 Tomcat。
- 起步依赖,让开发者专注于业务逻辑。
1 创建 Spring Boot 项目
选择 Spring Initializr
- 在 IntelliJ IDEA 中创建新模块(New Module)。
- 在弹出的窗口中,选择左侧的
Spring Initializr
,这是一个专门为 Spring Boot 提供的创建工具。
2 填写基本信息
在 Spring Initializr 的界面中,需要填写以下信息:
-
Server URL:
- 默认使用
start.spring.io
,这是官方推荐的 Spring Boot 项目生成服务,能够快速初始化项目。
- 默认使用
-
Name:
- 项目名称,如
springboot-quickstart
。这是你项目的名称,决定了生成的主文件夹名字。
- 项目名称,如
-
Location:
- 项目的存储路径,选择你想保存的位置。
-
Group:
- 组织 ID,通常以域名的反向命名规则填写,例如
com.itheima
。 - 这个值会影响生成的包结构。
- 组织 ID,通常以域名的反向命名规则填写,例如
-
Artifact:
- 项目构件名称,例如
springboot-quickstart
。 - 这个值会影响生成的最终构件文件名,如
springboot-quickstart.jar
。
- 项目构件名称,例如
-
Package name:
- 自动生成的包名,例如
com.itheima.springbootquickstart
。
- 自动生成的包名,例如
-
JDK 和 Java 版本:
- JDK:选择你项目使用的 JDK 版本,通常使用 IDEA 的 Project SDK,推荐 17 或以上版本。
- Java:这里填写的是语言的版本,也选 17。
-
Packaging:
- Jar:用于生成一个可独立运行的 Java 应用程序(常用)。
- War:用于部署到外部的 Tomcat、JBoss 等应用服务器中。
推荐选择 Jar:因为 Spring Boot 自带嵌入式的 Tomcat 服务器,无需外部服务器支持。
3 选择依赖
在下一步中,需要选择 Spring Boot 的版本和项目依赖:
-
Spring Boot 版本:
- 通常选择最新的稳定版本,例如
3.1.2
。 - 注意,Spring Boot 3.x 需要 Java 17 及以上版本支持。
- 通常选择最新的稳定版本,例如
-
Dependencies(依赖):
- 勾选
Spring Web
:- 提供 Web 开发相关的支持。
- 包括 Spring MVC 和嵌入式 Tomcat。
- 勾选
4 生成项目
-
填写好信息后,点击
Create
按钮,Spring Initializr 会自动生成项目结构。 -
项目生成后,可以在 IDEA 中看到以下典型结构:
springboot-quickstart/ ├── src/ │ ├── main/ │ │ ├── java/ │ │ │ └── com/itheima/springbootquickstart/ │ │ │ └── SpringbootQuickstartApplication.java │ │ └── resources/ │ │ ├── application.properties │ │ └── static/ │ └── test/ └── pom.xml
5 运行项目
启动主类
在 src/main/java/com/itheima/springbootquickstart/SpringbootQuickstartApplication.java
中,会自动生成以下代码:
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class SpringbootQuickstartApplication {
public static void main(String[] args) {
SpringApplication.run(SpringbootQuickstartApplication.class, args);
}
}
-
点击
Run
按钮,运行main
方法,启动项目。 -
控制台会输出类似以下信息:
Tomcat started on port(s): 8080 (http) Started SpringbootQuickstartApplication in 2.456 seconds
测试接口
- 打开浏览器,访问
http://localhost:8080
。 - 如果看到 Spring Boot 的默认页面,说明项目成功运行。