Spring Boot 入门：初学者指南
Source: Dev.to – Getting Started with Spring Boot: A Beginner’s Guide
介绍
Spring Boot 是一个强大的 Java 框架，简化了现代后端应用的创建。在本指南中，你将学习：
- Spring Boot 的基础
- 如何创建新项目
- 典型的项目结构
- 使用 Maven/Gradle 管理依赖
- 构建一个简单的 REST API
🧠 前置条件
在开始之前，您应该具备以下基础知识：
- 核心 Java 概念
- 面向对象编程（OOP）
- 类、方法和接口
- 基本的数据库概念（表、主键、外键）
- 编写简单的 SQL 查询
这些基础将帮助您更轻松地跟随学习进度。
🎯 你将学到
在本文中，你将学习：
- 什么是 Spring Boot
- 为什么引入 Spring Boot
- 创建一个 Spring Boot 项目
- 理解项目结构
- 使用 Maven 管理依赖
- 构建并运行 Spring Boot 应用
- 创建一个简单的 REST API
源代码
您可以在 GitHub 仓库中查看完整代码：
📦 Spring Boot 简介
Spring Boot 是一个基于 Spring Framework 的 Java 框架。它通过减少手动配置和设置来简化开发。
Spring Boot 提供了以下功能，取代了编写大量 XML 或 Java 配置以及搭建外部服务器的需求：
- Auto‑configuration
- Embedded servers
- Opinionated defaults
- Easy REST API support
这些特性使其非常适合构建 standalone, production‑ready 应用程序。
🧩 为什么引入 Spring Boot
Spring Boot 之前
- 项目需要大量配置。
- 开发者编写重复的样板代码。
- 依赖管理需要手动完成。
- 需要外部应用服务器。
Spring Boot 解决了什么
Spring Boot 对大量设置进行标准化和自动化，消除了上述痛点。
⭐ Spring Boot 的关键特性
- ✔ 自动配置 – 根据依赖自动配置应用程序。
- ✔ 嵌入式服务器 – 包含 Tomcat、Jetty 或 Undertow，无需外部服务器。
- ✔ 简易 REST API – 用最少的代码构建 Web API。
- ✔ 数据库集成 – 与 JDBC、JPA 以及流行数据库无缝协作。
- ✔ Spring Security 支持 – 内置认证和授权功能。
🚀 创建 Spring Boot 项目
最简单的方式是使用 Spring Initializr —— 只需访问
https://start.spring.io。
步骤
- 打开 Spring Initializr
- 配置项目
- Project: Maven
- Language: Java
- Spring Boot version: (默认)
- Group:
com.codewithtejas - Artifact:
store - Java version: 17
- 添加依赖:
Spring Web - 点击 Generate
- 将下载的 .zip 文件解压到你的工作区。
📁 理解项目结构
store
├── .mvn
├── src
│ ├── main
│ │ ├── java
│ │ └── resources
│ └── test
│ └── java
├── pom.xml
└── target/ ← generated build output关键要素
pom.xml– 管理依赖和构建生命周期的 Maven 描述符。mvnw/mvnw.cmd– 确保在不同环境中使用一致 Maven 版本的包装脚本。src/main/java– 应用程序源代码。src/main/resources– 配置文件（例如application.properties）。src/test/java– 单元测试和集成测试（通常使用 JUnit）。target/– Maven 创建的目录，包含已编译的类、打包的构件以及其他构建产物。
Source: …
🛠 使用 Maven 管理依赖
Maven 依赖在项目的 pom.xml 文件中声明。一个典型的 Spring Boot Web 依赖如下所示：
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<!-- version 通常省略，因为 Spring Boot 的依赖管理会提供它 -->
</dependency>
</dependencies>| 元素 | 含义 |
|---|---|
| groupId | 组织或项目组（例如 org.springframework.boot）。 |
| artifactId | 库/模块的名称（例如 spring-boot-starter-web）。 |
| version | 库的具体版本。使用 Spring Boot 的 BOM 时通常省略，BOM 会自动提供合适的版本。 |
spring-boot-starter-web 包含的内容
- Spring MVC – 核心 Web 框架
- Embedded Tomcat – 默认的 Servlet 容器（可替换为 Jetty/Undertow）
- Jackson – JSON 序列化/反序列化
- Validation – Bean Validation（JSR‑380）支持
更新依赖
编辑 pom.xml 后，Maven（或你的 IDE）通常会检测到更改并自动重新加载项目。
如果需要手动刷新，可运行：
# 清理项目并重新下载任何已更新的依赖
mvn clean install其他常用命令：
mvn dependency:tree– 可视化完整的依赖图。mvn versions:display-dependency-updates– 列出依赖的可用新版本。
构建和运行 Spring Boot 应用程序
创建一个简单的 REST 控制器
步骤 1：创建控制器包
com.codewithtejas.store.controller
步骤 2：创建控制器类
@RestController
@RequestMapping("/api")
public class HelloController {
@GetMapping("/hello")
public String hello() {
return "Hello from Spring Boot!";
}
}注解说明
@RestController– 将类标记为 REST 控制器。@RequestMapping("/api")– 类中所有端点的基础 URL 路径。@GetMapping("/hello")– 处理对/api/hello的 HTTP GET 请求。
运行应用程序
使用 Maven Wrapper（推荐）：
./mvnw spring-boot:run或者，如果全局已安装 Maven：
mvn spring-boot:run应用程序默认在端口 8080 启动。访问 http://localhost:8080/api/hello 可查看响应。
🚀 接下来是什么？
现在您已经了解了 Spring Boot 的基础，接下来重要的一步是学习 依赖注入（DI） 和 控制反转（IoC）容器。这些概念是 Spring 框架的基石，并且在 Spring Boot 应用程序的各个地方都会用到。
让我们联系！
如果您有任何推荐的资源、对我的挑战的更好方法或见解，我很乐意听取！请在评论中留下您的想法。
编码愉快！ 🎉
祝您有美好的一天！