第 1 步：创建 SpringBoot 工程并引入四个依赖#

创建过程跟 30 篇一样，用 IDEA 的 Spring Initializr：填好工程名、包名、JDK，再在依赖页勾选需要的依赖。

这正是 PPT 说的四个依赖，课程工程 pom.xml 里对应的坐标如下：

1
<!-- Web 开发起步依赖（内嵌 Tomcat、SpringMVC、JSON 转换） -->
2
<dependency>
3
    <groupId>org.springframework.boot</groupId>
4
    <artifactId>spring-boot-starter-web</artifactId>
5
</dependency>
6
<!-- MyBatis（含 spring-jdbc、mybatis、连接池等） -->
7
<dependency>
8
    <groupId>org.mybatis.spring.boot</groupId>
9
    <artifactId>mybatis-spring-boot-starter</artifactId>
10
    <version>3.0.3</version>
11
</dependency>
12
<!-- MySQL 驱动 -->
13
<dependency>
14
    <groupId>com.mysql</groupId>
15
    <artifactId>mysql-connector-j</artifactId>
16
    <scope>runtime</scope>
17
</dependency>
18
<!-- Lombok（实体类上 @Data 之类的注解靠它） -->
19
<dependency>
20
    <groupId>org.projectlombok</groupId>
21
    <artifactId>lombok</artifactId>
22
    <optional>true</optional>
23
</dependency>

（截图里创建向导选的是 Spring Boot 3.2.6，课程工程 pom.xml 里是 3.2.10，同一代 3.2.x，不影响任何写法；Java 版本都是 17。）

第 2 步：建 dept 表和配 application.yml#

数据库还是用 41 篇起的那套 MySQL，新建一个库 tlias，然后建表（课程资料 05. 数据库表/dept.sql 原文）：

1
create table dept (
2
  id int unsigned primary key auto_increment comment 'ID, 主键',
3
  name varchar(10) not null unique comment '部门名称',
4
  create_time datetime default null comment '创建时间',
5
  update_time datetime default null comment '修改时间'
6
) comment '部门表';
7

8
insert into dept values (1,'学工部','2024-09-25 09:47:40','2024-09-25 09:47:40'),
9
                        (2,'教研部','2024-09-25 09:47:40','2024-09-09 15:17:04'),
10
                        (3,'咨询部','2024-09-25 09:47:40','2024-09-30 21:26:24'),
11
                        (4,'就业部','2024-09-25 09:47:40','2024-09-25 09:47:40'),
12
                        (5,'人事部','2024-09-25 09:47:40','2024-09-25 09:47:40'),
13
                        (6,'行政部','2024-11-30 20:56:37','2024-09-30 20:56:37');

这张表有几个点后面会用到：

• id 是无符号整数 + 主键 + 自增（新增部门时不用给 id）；
• name 非空且唯一（所以不能重复添加同名部门）；
• create_time、update_time 两条时间字段——这就是 58 篇”数据封装”问题的源头（create_time 和 Java 属性 createTime 名字对不上）；
• 先插了 6 条数据，且 update_time 各不相同（咨询部的 2024-09-30 最新），正好用来验证查询是按修改时间倒序排的。

然后在 application.yml 里配数据源（写法就是 56 篇整理的 yml 格式）：

1
spring:
2
  application:
3
    name: tlias-web-management
4
  #配置数据库的连接信息
5
  datasource:
6
    url: jdbc:mysql://localhost:3306/tlias
7
    driver-class-name: com.mysql.cj.jdbc.Driver
8
    username: root
9
    password: 1234
10

11
#Mybatis的相关配置
12
mybatis:
13
  configuration:
14
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
15
    #开启驼峰命名映射开关
16
    map-underscore-to-camel-case: true

（password 换成你自己 MySQL 的密码。log-impl 那行是把 MyBatis 的 SQL 日志打到控制台，方便调试；map-underscore-to-camel-case 是驼峰映射开关——它为什么出现在这里、不打开会怎样，是 58 篇的重点，这里先原样写上。）

第 3 步：准备代码结构 + 两个基础类#

工程按三层架构分包，每一层一个包，实体类单独放 pojo：

1
src/main/java/com/itheima
2
├── TliasWebManagementApplication.java   # 启动类（创建工程时自动生成）
3
├── controller/                          # 控制层：接收请求、处理响应
4
│   └── DeptController.java
5
├── service/                             # 业务层接口
6
│   ├── DeptService.java
7
│   └── impl/                            # 业务层实现
8
│       └── DeptServiceImpl.java
9
├── mapper/                              # 数据访问层（MyBatis 接口）
10
│   └── DeptMapper.java
11
└── pojo/                                # 实体类与统一响应结果
12
    ├── Dept.java
13
    └── Result.java

实体类 Dept（跟 dept 表一一对应）：

1
package com.itheima.pojo;
2

3
import lombok.AllArgsConstructor;
4
import lombok.Data;
5
import lombok.NoArgsConstructor;
6

7
import java.time.LocalDateTime;
8

9
@Data                   // 生成 getter/setter/toString 等
10
@NoArgsConstructor      // 无参构造
11
@AllArgsConstructor     // 全参构造
12
public class Dept {
13
    private Integer id;
14
    private String name;
15
    private LocalDateTime createTime;
16
    private LocalDateTime updateTime;
17
}

四个属性对应表里四个字段，时间类型用 LocalDateTime（MySQL 的 datetime 正好对上）。

统一响应结果 Result：这是 PPT 第 23 页的重点。为什么要有它？看 PPT 上举的反例——如果接口直接返回业务数据，有的接口返回一个对象、有的返回一个数组，前端拿到响应还得先猜”这次到底是什么形状的数据”，代码里到处是 if：

1
{ "id": 1, "name": "教研部", "updateTime": "2024-10-20 00:00:00" }        ← 直接返回一个对象
2
[{ "id": 1, "name": "教研部", "updateTime": "2024-10-20 00:00:00" }]      ← 另一个接口返回数组

PPT 的规范是：所有接口都返回同一个外壳，业务数据放在 data 里——

1
{ "code": 1, "msg": "操作成功", "data": … }    ← 成功
2
{ "code": 0, "msg": "密码错误", "data": … }    ← 失败

前端只认三个字段：code 是不是 1（成功还是失败）、msg 里是提示信息、data 里是真正的数据。课程工程的 Result 类就是照着这个结构写的（课程代码 pojo/Result.java）：

1
package com.itheima.pojo;
2

3
import lombok.Data;
4

5
/**
6
 * 后端统一返回结果
7
 */
8
@Data
9
public class Result {
10

11
    private Integer code; //编码：1成功，0为失败
12
    private String msg; //错误信息
13
    private Object data; //数据
14

15
    public static Result success() {          // 成功、无数据（新增/修改/删除用）
16
        Result result = new Result();
17
        result.code = 1;
18
        result.msg = "success";
19
        return result;
20
    }
21

22
    public static Result success(Object object) {  // 成功、带数据（查询用）
23
        Result result = new Result();
24
        result.data = object;
25
        result.code = 1;
26
        result.msg = "success";
27
        return result;
28
    }
29

30
    public static Result error(String msg) {  // 失败，把失败原因传进来
31
        Result result = new Result();
32
        result.msg = msg;
33
        result.code = 0;
34
        return result;
35
    }
36
}

三个方法刚好覆盖三种场景：只表示成功（success()，响应里 data 为 null）、成功并带回数据（success(data)）、失败并带回原因（error("部门不存在")）。控制器里统一 return Result.success(...)，前端就永远只需要处理一种外壳。

1
{"code":1,"msg":"success","data":null}

回头再看工程搭建这三步，其实正好对应前后端分离流程里的两个环节：第 1、2 步是环境准备，第 3 步的 Dept 和 Result 就是”接口设计”的落地——实体类决定了接口能返回哪些字段，Result 决定了响应的外壳格式。

一、知识回顾（读完直接做下面的实践题）#

1. 课程全景：Web 开发分五块——Web 前端基础（HTML/CSS/JavaScript/Vue3/Ajax-Axios）、Web 后端基础（Maven/Web 基础知识/MySQL/JDBC/MyBatis）、Web 后端实战（Tlias 案例）、Web 前端实战（Tlias 案例）、Web 项目部署（Linux/Docker）
2. Tlias 需求清单：部门管理（查询/新增/修改/删除）、员工管理（查询/新增/修改/删除）、文件上传、报表统计、登录认证、日志管理，外加班级、学员管理（实战内容）
3. 本章路线：准备工作 → 查询部门 → 删除部门 → 新增部门 → 修改部门 → 日志技术
4. 前后端混合开发的三个问题：难以维护、分工不明确、不便管理（页面和后端代码在同一个工程里，一起开发一起部署）
5. 前后端分离开发是什么：前端项目、后端项目，开发和部署都是分开的；两边的唯一”合同”是接口文档
6. 前后端分离的开发流程（五步）：需求分析 → 接口设计（API 接口文档）→ 前后端并行开发（遵守规范）→ 测试（前端、后端）→ 前后端联调测试
7. REST 是什么：REST（REpresentational State Transfer，表述性状态转换）是一种软件架构风格；它是约定不是规定，可以打破；描述功能模块通常用复数（users、books、depts），表示”此类资源”而非单个资源
8. REST 的两个特点：URL 定义资源（/users/1 就是 1 号用户）、HTTP 动词描述操作；四种请求方式 GET 查询、POST 新增、PUT 修改、DELETE 删除
9. Apifox：集 API 文档、API 调试、API Mock、API 测试于一体的一体化协作平台；作用是接口文档管理、接口请求测试、Mock 服务；要它的根本原因是浏览器地址栏发起的请求都是 GET，发不出 POST/PUT/DELETE
10. 工程搭建三步与 Result：① 建 SpringBoot 工程（web 起步依赖 + mybatis + mysql 驱动 + lombok）② 建 dept 表并在 application.yml 配数据源 ③ 准备三层包结构并引入 Dept、Result（{code,msg,data}，本机实测 msg 是 "success"）

二、裸写题#

• 2-1 把这些”传统风格”的接口改写成 REST 风格 需求：下面四个接口是同一个”用户模块”的功能，请把它们全部改写成 REST 风格的 URL，并写出每个接口该用的请求方式：

  原来的 URL	原来的方式	含义
  http://localhost:8080/user/getById?id=1	GET	查询 id 为 1 的用户
  http://localhost:8080/user/saveUser	POST	新增用户
  http://localhost:8080/user/updateUser	POST	修改用户
  http://localhost:8080/user/deleteUser?id=1	GET	删除 id 为 1 的用户

  做完再回答：REST 里资源名用单数还是复数？“约定不是规定”是什么意思？ （练习文件 test_57_Result统一响应.java 的题目2-1 里给了写作区。）

  提示（先自己想，实在想不出再点开）

  一级 · 思路：把 URL 里的”动作”全去掉，只留下”资源”（用户 → 复数）；动作交给请求方式表达，id 直接挂在路径后面 二级 · 方法：资源用 /users；带 id 的资源写成 /users/{id} 这种路径；查询用 GET、新增用 POST、修改用 PUT、删除用 DELETE 三级 · 骨架：http://localhost:8080/____/1 + ____ ；http://localhost:8080/____ + ____（四个接口里有两个共用同一个 URL，靠请求方式区分）

  参考答案（做完再点开）

  REST 风格 url	请求方式	含义
  http://localhost:8080/users/1	GET	查询 id 为 1 的用户
  http://localhost:8080/users	POST	新增用户
  http://localhost:8080/users	PUT	修改用户
  http://localhost:8080/users/1	DELETE	删除 id 为 1 的用户

  回答：① 资源名通常用复数（users），表示”此类资源”而不是单个资源；② “约定不是规定”意思是 REST 只是一套团队共识的风格，不是框架强制的规则，遇到表达不了的场景可以打破它。对比一下：原来”新增”能写出 saveUser/addUser/insertUser/save/add/insert 六种 URL，现在只有 /users 一个，动作由请求方式表达——这就是”简洁、规范、优雅”。

• 2-2 判断这四条接口设计得对不对 需求：某项目里有下面四条接口，请逐条判断它是否符合 REST 风格，不符合的说明理由，并给出改法（只改 URL 与请求方式，不用写代码）：

  1. GET http://localhost:8080/dept/getAllDeptList
  2. POST http://localhost:8080/depts
  3. GET http://localhost:8080/depts/delete?id=3
  4. PUT http://localhost:8080/depts （练习文件 test_57_Result统一响应.java 的题目2-2 里给了写作区。）
  提示（先自己想，实在想不出再点开）

  一级 · 思路：一条一条问自己两件事——URL 里还有没有”动作名”？这个动作该不该用这个请求方式？ 二级 · 方法：资源的”增删改查”分别对应 POST、DELETE、PUT、GET；删除应该把要删的那个 id 放进路径里而不是拼在查询串里 三级 · 骨架：第 1 条要砍掉 ____ 这种动作名、资源名改复数；第 3 条把方式换成 ____、参数写进 ____

  参考答案（做完再点开）

  1. 不符合。URL 里带着动作名 getAllDeptList，而且资源名 dept 用了单数。改为 GET http://localhost:8080/depts（“查询全部”这个语义由”GET 资源集合”表达，不需要额外的词）。
  2. 符合。/depts 定位”部门”资源集合，POST 表示新增。
  3. 不符合。URL 里有动作名 delete，还用 GET 表达删除。改为 DELETE http://localhost:8080/depts/3。
  4. 符合。/depts 配 PUT 表示修改（修改的数据放在请求体里）——这也说明为什么”新增”和”修改”可以是同一个 URL。

  补一句：这不是”对错题”而是”风格题”，REST 是约定不是规定；但在团队里按这套来，接口就一眼能看懂，前后端也不用为”这个动作用哪个单词”扯皮。

• 2-3 按需求写一个”统一响应结果”类 需求：写一个类，作为本项目所有接口的统一返回外壳，要求：① 三个属性——编码（整数，1 表示成功、0 表示失败）、提示信息（字符串）、数据（任意类型）；② 三种构造方式——只表示成功、成功且带回一份数据、失败并带回失败原因；③ 用 lombok 注解把 getter/setter 等生成出来。 （练习文件 test_57_Result统一响应.java 的题目2-3 里给了类骨架。）

  提示（先自己想，实在想不出再点开）

  一级 · 思路：属性三个；再提供三个静态工厂方法，分别对应”成功/成功带数据/失败”三种场景，方法内部自己把 code 和 msg 填好，调用方只传它知道的东西 二级 · 方法：类名 Result，属性 code/msg/data；方法 success()、success(Object object)、error(String msg)；lombok 用 @Data 三级 · 骨架：public class ____ { private Integer ____; private String ____; private Object ____; public static ____ success() {…} public static ____ success(Object object) {…} public static ____ error(String msg) {…} }

  参考答案（做完再点开）

  1
  package com.itheima.pojo;
  2
  
  3
  import lombok.Data;
  4
  
  5
  /**
  6
   * 后端统一返回结果
  7
   */
  8
  @Data
  9
  public class Result {
  10
  
  11
      private Integer code; //编码：1成功，0为失败
  12
      private String msg; //错误信息
  13
      private Object data; //数据
  14
  
  15
      public static Result success() {
  16
          Result result = new Result();
  17
          result.code = 1;
  18
          result.msg = "success";
  19
          return result;
  20
      }
  21
  
  22
      public static Result success(Object object) {
  23
          Result result = new Result();
  24
          result.data = object;
  25
          result.code = 1;
  26
          result.msg = "success";
  27
          return result;
  28
      }
  29
  
  30
      public static Result error(String msg) {
  31
          Result result = new Result();
  32
          result.msg = msg;
  33
          result.code = 0;
  34
          return result;
  35
      }
  36
  }

  显示更多显示更少

  说明：data 的类型写成 Object 才能同时装对象（查一个部门）和集合（查部门列表）；两个 success 是方法重载（参数列表不同）。这段代码与课程工程 pojo/Result.java 完全一致——本机实测跑出来的成功响应就是 {"code":1,"msg":"success","data":null}，也就是 msg 里写的是 "success"，不是 PPT 上写的”操作成功”。

三、综合题#

• 3-1 照着接口文档，把后端骨架设计出来 这一题把”接口设计”这一步亲手做一遍——不写控制器代码，只出设计稿：给定接口文档里「部门列表查询」这一节（请求 GET /depts，响应参数见下），把工程搭建里所有”固定不变”的东西定下来。

  1. 列依赖：写出这个工程 pom.xml 里必须有的四项依赖（Web 开发起步依赖、持久层框架、数据库驱动、简化实体类代码的库），并说明每一项负责什么；
  2. 建库建表：写出建 dept 表的 SQL（id 无符号整数、主键、自增；部门名称非空且唯一；两条时间字段），并插入两条示例数据；
  3. 配 yml：写出 application.yml——数据源四项（库名 tlias、root、密码）连同 MyBatis 的 SQL 日志、驼峰映射开关；
  4. 写实体类：照着接口文档响应里 data 内部的字段，写出实体类的属性名与类型（时间用什么类型？）；
  5. 写统一响应结果：写出 Result 类，并用它表示出「查询部门列表成功、data 里装着部门集合」和「删除部门失败、提示”部门不存在”」两种情况下真实的 JSON 长什么样；
  6. 自查对齐：把接口文档 1.1.3 响应参数表的每一行与 Result/Dept 的字段一一对上，回答——msg 这一栏到底该写什么字符串？为什么必须以代码/文档为准而不是以记忆为准？

  涉及知识点

  知识点	在这里的应用
  工程搭建三步	第 1、2、3 步——依赖、表、配置
  实体类与字段对应	第 4 步——Dept 四个属性对应表四个字段
  统一响应结果	第 4、5 步——Result 外壳与 Dept 数据的关系
  接口文档	第 6 步——文档参数表 ⇄ 代码字段

  提示（先自己想，实在想不出再点开）

  一级 · 思路：把”接口文档的参数表”当成设计图纸——响应最外层三行就是 Result 的三个字段，data 里 |- 开头的四行就是 Dept 的四个属性；先把图纸翻译成类，再把类拼成工程 二级 · 方法：依赖用 spring-boot-starter-web、mybatis-spring-boot-starter、mysql-connector-j、lombok；建表用 int unsigned primary key auto_increment、varchar 加 not null unique、datetime；yml 里数据源写在 spring.datasource 下、MyBatis 配置写在 mybatis.configuration 下；时间属性用 LocalDateTime 三级 · 骨架：Result（code/msg/data + success()/success(Object)/error(String)）＋ Dept（Integer id / String name / LocalDateTime createTime / LocalDateTime updateTime）；两种响应：{"code":1,"msg":"success","data":[…]}、{"code":0,"msg":"____","data":null}

  参考答案（做完再点开）

  1. 依赖（说明见本篇「工程搭建 第 1 步」）：spring-boot-starter-web（内嵌 Tomcat + SpringMVC + JSON 转换，接口能收能发全靠它）、mybatis-spring-boot-starter（MyBatis 与 SpringBoot 整合）、mysql-connector-j（MySQL 驱动）、lombok（@Data 等注解）。 2. 建表：

  1
  create table dept (
  2
    id int unsigned primary key auto_increment comment 'ID, 主键',
  3
    name varchar(10) not null unique comment '部门名称',
  4
    create_time datetime default null comment '创建时间',
  5
    update_time datetime default null comment '修改时间'
  6
  ) comment '部门表';
  7
  
  8
  insert into dept values (1,'学工部','2024-09-25 09:47:40','2024-09-25 09:47:40'),
  9
                          (2,'教研部','2024-09-25 09:47:40','2024-09-09 15:17:04');

  （课程资料 dept.sql 里插了 6 条。） 3. yml：

  1
  spring:
  2
    datasource:
  3
      url: jdbc:mysql://localhost:3306/tlias
  4
      driver-class-name: com.mysql.cj.jdbc.Driver
  5
      username: root
  6
      password: 1234
  7
  
  8
  mybatis:
  9
    configuration:
  10
      log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
  11
      map-underscore-to-camel-case: true

  （password 换成你自己 MySQL 的密码。） 4. 实体类：

  1
  @Data
  2
  @NoArgsConstructor
  3
  @AllArgsConstructor
  4
  public class Dept {
  5
      private Integer id;
  6
      private String name;
  7
      private LocalDateTime createTime;
  8
      private LocalDateTime updateTime;
  9
  }

  时间用 LocalDateTime（对应 datetime），属性名用驼峰 createTime/updateTime。 5. Result 类见 2-3 的参考答案。两种响应：

  1
  {"code":1,"msg":"success","data":[{"id":1,"name":"学工部","createTime":"2024-09-25T09:47:40","updateTime":"2024-09-25T09:47:40"}]}
  2
  {"code":0,"msg":"部门不存在","data":null}

  第二种由 Result.error("部门不存在") 生成（注意 error 方法没有给 data 赋值，所以 data 是 null）。 6. 对齐自查：接口文档 1.1.3 里 code/msg/data 三行 ⇄ Result 的三个属性；|- id/|- name/|- createTime/|- updateTime 四行 ⇄ Dept 的四个属性，类型也一一对上（number → Integer、string → String、时间 string → LocalDateTime）。msg 这一栏以代码为准写 "success"——PPT 上写的是”操作成功”，但课程代码 Result.success() 里写死的就是 "success"（本机实测响应 {"code":1,"msg":"success","data":null} 印证）。接口文档是前后端的合同，文档/代码没对齐时以跑得起来的那份为准，靠记忆写字符串迟早对不上。