SpringBoot
- [🚀 Spring Boot 入门教程(从 0 到跑起来)](#🚀 Spring Boot 入门教程(从 0 到跑起来))
-
- [一、Spring Boot 是什么?为什么要学它?](#一、Spring Boot 是什么?为什么要学它?)
- [二、Spring Boot 项目长什么样?](#二、Spring Boot 项目长什么样?)
- [三、创建第一个 Spring Boot 项目](#三、创建第一个 Spring Boot 项目)
-
- [方式一(最推荐):IDEA 直接创建](#方式一(最推荐):IDEA 直接创建)
- [四、Spring Boot 程序是怎么启动的?](#四、Spring Boot 程序是怎么启动的?)
- 五、写一个最简单的接口(核心)
-
- [1️⃣ 新建 Controller](#1️⃣ 新建 Controller)
- [2️⃣ 逐行解释(重点)](#2️⃣ 逐行解释(重点))
- [3️⃣ 运行 & 访问](#3️⃣ 运行 & 访问)
- [六、Spring Boot 的配置文件(application.yml)](#六、Spring Boot 的配置文件(application.yml))
-
- 例子:修改端口号
- [yml 写法小提示](#yml 写法小提示)
- [七、返回 JSON 数据(真实开发必用)](#七、返回 JSON 数据(真实开发必用))
-
- 示例:返回一个用户对象
- [User 类](#User 类)
- 八、常见注解速查表(新手必看)
- [九、Spring Boot 的开发思路总结](#九、Spring Boot 的开发思路总结)
- 十、写在最后(给初学者的建议)
🚀 Spring Boot 入门教程(从 0 到跑起来)
适合人群:
✔ 没学过 Spring / Spring MVC
✔ 会一点 Java
✔ 想快速写后端接口、做项目、应付课程设计/比赛
一、Spring Boot 是什么?为什么要学它?
一句话先说清楚:
Spring Boot = 帮你把 Spring 的一堆复杂配置全都自动搞定
在 Spring Boot 出现之前,你写一个 Web 项目通常要:
- 配一堆 XML
- 搞 servlet、tomcat
- 各种配置文件互相折磨
而 Spring Boot 的目标只有一个:
让你 5 分钟写出一个能跑的后端服务
它能干什么?
- 写后端接口(给前端用)
- 写管理系统
- 写微服务
- 写比赛/课程项目
二、Spring Boot 项目长什么样?
我们先不急着写代码,先看 一个最基本的 Spring Boot 项目结构 👇
springboot-demo
│
├── src
│ └── main
│ ├── java
│ │ └── com.example.demo
│ │ ├── DemoApplication.java ← 启动类
│ │ └── controller
│ │ └── HelloController.java
│ │
│ └── resources
│ └── application.yml ← 配置文件
│
└── pom.xml ← 依赖管理
你现在只需要记住三样东西:
DemoApplication.java------ 程序入口controller------ 写接口的地方application.yml------ 配置
三、创建第一个 Spring Boot 项目
方式一(最推荐):IDEA 直接创建
-
打开 IDEA
-
New Project → Spring Initializr
-
选择:
- Project:Maven
- Language:Java
- Spring Boot:默认即可
-
依赖只选一个:
- ✅ Spring Web
一路 Next,Finish。
四、Spring Boot 程序是怎么启动的?
打开 DemoApplication.java,你会看到:
java
@SpringBootApplication
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}
这段代码你现在只需要理解一件事:
main 方法一运行,Spring Boot 项目就启动了
- 不需要你自己启动 Tomcat
- 不需要写 servlet
- Spring Boot 已经帮你内嵌好了服务器
👉 直接右键运行 main 方法即可
五、写一个最简单的接口(核心)
我们来写一个真正能访问的接口。
1️⃣ 新建 Controller
在 controller 包下,新建类 HelloController:
java
@RestController
public class HelloController {
@GetMapping("/hello")
public String hello() {
return "Hello Spring Boot!";
}
}
2️⃣ 逐行解释(重点)
java
@RestController
👉 告诉 Spring:
这是一个 专门返回数据的控制器
java
@GetMapping("/hello")
👉 表示:
- 浏览器访问:
/hello - 请求方式:GET
java
public String hello() {
return "Hello Spring Boot!";
}
👉 返回什么,浏览器就看到什么。
3️⃣ 运行 & 访问
启动项目后,在浏览器输入:
http://localhost:8080/hello
你会看到:
Hello Spring Boot!
🎉 恭喜,你已经写出了第一个后端接口!
六、Spring Boot 的配置文件(application.yml)
Spring Boot 的配置一般写在:
src/main/resources/application.yml
例子:修改端口号
yml
server:
port: 8081
重启项目后,访问:
http://localhost:8081/hello
yml 写法小提示
yml
层级用缩进表示
冒号后面要有空格
❌ 错误写法:
yml
server:
port:8081
七、返回 JSON 数据(真实开发必用)
实际开发中,接口一般返回 JSON。
示例:返回一个用户对象
java
@RestController
public class UserController {
@GetMapping("/user")
public User getUser() {
return new User(1, "Tom", 18);
}
}
User 类
java
public class User {
private int id;
private String name;
private int age;
// 构造方法
public User(int id, String name, int age) {
this.id = id;
this.name = name;
this.age = age;
}
// getter / setter(可用 IDEA 自动生成)
}
访问:
http://localhost:8080/user
返回:
json
{
"id": 1,
"name": "Tom",
"age": 18
}
👉 Spring Boot 会自动把对象转成 JSON
你不需要自己写解析代码。
八、常见注解速查表(新手必看)
| 注解 | 作用 |
|---|---|
@SpringBootApplication |
项目启动入口 |
@RestController |
写接口,返回数据 |
@GetMapping |
GET 请求 |
@PostMapping |
POST 请求 |
@RequestParam |
接收参数 |
@PathVariable |
接收路径参数 |
九、Spring Boot 的开发思路总结
你以后写代码,大概就是这套流程:
- 启动类(不用动)
- 写
Controller - 写接口方法
- 浏览器 / 前端 调用接口
👉 Spring Boot 的核心思想:
你只管写业务,其他的它帮你搞定
十、写在最后(给初学者的建议)
-
别一开始就学微服务、Spring Cloud
-
先把:
- Controller
- 参数接收
- JSON 返回
- 简单数据库
-
这些练熟