Spring Boot 从零入门：请求响应、三层架构与 IOC/DI 实践总结
文章目录
- Spring Boot 从零入门：请求响应、三层架构与 IOC/DI 实践总结
- 1. 项目搭建与第一个接口
- 2. 请求响应：参数接收全解析
- 2.1 哪些参数必须掌握？
- 2.2 不用 Postman，如何高效测试？
- 2.3 常见参数示例代码
- 4. 分层解耦：三层架构设计
- 4.1 为什么需要分层？
- 4.2 标准三层职责
- 5. IoC + DI：彻底告别 `new` 关键字
- 5.1 IoC 与 DI 概念
- 5.2 注解驱动的改造步骤
- 5.3 为什么推荐构造器注入？
- 6. 统一响应格式（Result 封装）
- 7. 总结和最后的话
1. 项目搭建与第一个接口
使用 IDEA 的 Spring Initializr 创建项目，依赖仅选择Spring Web。
启动类HttpStuApplication自动生成。在controller包下创建HelloController：
@RestControllerpublicclassHelloController{@RequestMapping("/hello")publicStringsayHello(){return"Hello, 请求响应学习开始！";}}运行后浏览器访问http://localhost:8080/hello，输出文本 —— 标志着环境验证通过。
2. 请求响应：参数接收全解析
2.1 哪些参数必须掌握？
| 优先级 | 参数类型 | 注解 | 使用频率 |
|---|---|---|---|
| 🔥 必须掌握 | 简单参数 | @RequestParam（可省略） | 每天 |
| 🔥 必须掌握 | 路径参数 | @PathVariable | 每天 |
| 🔥 必须掌握 | JSON 参数 | @RequestBody | 每天 |
| ✅ 常用 | 实体参数 | 无注解，自动封装 | 经常 |
| ⚠️ 了解即可 | 日期参数 | @DateTimeFormat | 偶尔 |
| ⚠️ 了解即可 | 数组/集合参数 | @RequestParam+List | 偶尔 |
2.2 不用 Postman，如何高效测试？
IDEA 内置 HTTP Client：在项目根目录re新建test.http文件，写入请求，点击绿色箭头即可发送。
示例（JSON 参数测试）：
POST http://localhost:8080/json Content-Type: application/json { "name": "张三", "age": 18 }这种方法零安装、可保存、支持团队共享，非常适合学习阶段。
2.3 常见参数示例代码
@RestControllerpublicclassParamController{// 简单参数@GetMapping("/simple")publicStringsimple(@RequestParamStringname,Integerage){...}// 路径参数@GetMapping("/path/{id}")publicStringpath(@PathVariableIntegerid){...}// JSON 参数@PostMapping("/json")publicUserjson(@RequestBodyUseruser){...}// 实体参数（自动封装）@GetMapping("/user")publicUseruser(Useruser){returnuser;}}注意：返回类型为
String时 Spring 输出纯文本；返回对象/集合/Map 时自动转为 JSON。
4. 分层解耦：三层架构设计
4.1 为什么需要分层？
最初将所有代码写在 Controller 中，导致：
- 重复代码（多个接口都要查用户）
- 业务逻辑和请求处理混在一起
- 更换数据源（例如从 Map 改为 MySQL）需要改动多处
4.2 标准三层职责
| 层级 | 包名示例 | 职责 | 对象类型 |
|---|---|---|---|
| 表示层 | controller | 接收请求、参数校验、返回响应 | XxxController |
| 业务层 | service | 业务逻辑、事务管理、调用 DAO | XxxService+XxxServiceImpl |
| 数据访问层 | dao/repository | 数据库 CRUD、模拟数据 | XxxDao+XxxDaoImpl |
调用链：Controller→Service→DAO→ 数据 → 原路返回。
5. IoC + DI：彻底告别new关键字
5.1 IoC 与 DI 概念
| 概念 | 含义 | 比喻 |
|---|---|---|
| IoC(控制反转) | 对象的创建控制权从程序员反转到 Spring 容器 | 你不必自己new，告诉容器“我需要什么”即可 |
| DI(依赖注入) | 容器在创建对象时，自动将依赖的对象赋值给字段 | 容器帮你“接线” |
5.2 注解驱动的改造步骤
原代码（耦合）：
publicclassUserServiceImplimplementsUserService{privateUserDaouserDao=newUserDaoImpl();// 主动 new}改造后（解耦）：
@ServicepublicclassUserServiceImplimplementsUserService{privatefinalUserDaouserDao;@Autowired// Spring 4.3+ 单构造器可省略publicUserServiceImpl(UserDaouserDao){this.userDao=userDao;}}同时为UserDaoImpl添加@Repository，为UserController中注入UserService。
5.3 为什么推荐构造器注入？
| 注入方式 | 代码量 | 不可变性 (final) | 单元测试 | 循环依赖检测 | 推荐度 |
|---|---|---|---|---|---|
| 字段注入 | 最少 | ❌ | 困难（需反射） | 容器内可能掩盖 | ❌ 不推荐 |
| Setter 注入 | 中等 | ❌ | 一般 | 无 | ⚠️ 可选 |
| 构造器注入 | 稍多 | ✅ | 简单new传参 | 启动时报错 | ✅强烈推荐 |
构造器注入让依赖显式化、对象不可变、测试更友好。
6. 统一响应格式（Result 封装）
企业级接口通常不直接返回实体对象，而是返回统一结构的 JSON，方便前端全局拦截。
标准结构：
{"code":1,"msg":"success","data":{"name":"张三","age":18}}实现：创建utils/Result类
publicclassResult{privateIntegercode;privateStringmsg;privateObjectdata;publicstaticResultsuccess(Objectdata){Resultr=newResult();r.setCode(1);r.setMsg("success");r.setData(data);returnr;}publicstaticResulterror(Stringmsg){Resultr=newResult();r.setCode(0);r.setMsg(msg);returnr;}// getter / setter 必须存在}Controller 使用：
@GetMapping("/user/{id}")publicResultgetUser(@PathVariableIntegerid){Useruser=userService.getUserById(id);if(user==null){returnResult.error("用户不存在");}returnResult.success(user);}注意：Result 类必须有 getter/setter，否则 Spring 无法将字段序列化为 JSON。
7. 总结和最后的话
| 主题 | 关键点 |
|---|---|
| 请求响应 | @RequestParam、@PathVariable、@RequestBody；测试用.http |
| 三层架构 | Controller（请求/响应）、Service（业务）、DAO（数据） |
| 面向接口编程 | 接口定义契约，实现类可替换，上层只依赖接口 |
| IoC/DI | @Service/@Repository+@Autowired；推荐构造器注入 |
| 统一响应 | Result封装 code/msg/data，提供静态工厂方法 |
