思路分析：三层各干什么（PPT 第 59 页）#

照旧先画三层职责（PPT 第 59 页那张图的文字版）：

（PPT 上 Mapper 的 SQL 写成 select * from dept where id = ?；课程工程里把列名一个个写了出来，见下面”三层代码”。）

Controller 怎么接住”路径参数”（PPT 第 60 页）#

前面几个接口，参数要么在问号后面（/depts?id=8，60 篇讲的简单参数），要么在请求体里（JSON，61 篇讲的 JSON 参数）。这一个接口的参数直接长在 URL 路径里：

路径参数：通过请求 URL 直接传递参数，使用 {…} 来标识该路径参数，需要使用 @PathVariable 获取路径参数。

要接收的地址是 GET /depts/1，写法有两种，效果完全一样：

1
// 写法一：@PathVariable 里写明"取的是哪个占位符"
2
@GetMapping("/depts/{id}")
3
public Result getInfo(@PathVariable("id") Integer deptId){
4
    System.out.println("根据ID查询部门数据: " + deptId);
5
    Dept dept = deptService.getInfo(deptId);
6
    return Result.success(dept);
7
}
8

9
// 写法二：占位符名与形参名都叫 id，省略 @PathVariable 的 value
10
@GetMapping("/depts/{id}")
11
public Result getInfo(@PathVariable Integer id){
12
    System.out.println("根据ID查询部门数据: " + id);
13
    Dept dept = deptService.getInfo(id);
14
    return Result.success(dept);
15
}

对应关系拆开看：URL 里的 {id} 是占位符名，@PathVariable 是”取出路径参数”的注解，它的 value（"id"）要和占位符名对上；如果方法形参也正好叫 id，value 就能省略（写法二，也是课程最终代码的写法）。

三层代码（PPT 第 61 页）#

课程工程 tlias-web-management 里这一套的最终写法（四段代码分属四个文件）：

1
// ===== Controller：com.itheima.controller.DeptController =====
2
@GetMapping("/{id}")
3
public Result getInfo(@PathVariable Integer id){
4
    System.out.println("根据ID查询部门 : " + id);
5
    Dept dept = deptService.getById(id);
6
    return Result.success(dept);
7
}

1
// ===== Service：com.itheima.service.DeptService =====
2
/**
3
 * 根据ID查询部门
4
 */
5
Dept getById(Integer id);

1
// ===== ServiceImpl：com.itheima.service.impl.DeptServiceImpl =====
2
@Override
3
public Dept getById(Integer id) {
4
    return deptMapper.getById(id);
5
}

1
// ===== Mapper：com.itheima.mapper.DeptMapper =====
2
/**
3
 * 根据ID查询部门数据
4
 */
5
@Select("select id, name, create_time, update_time from dept where id = #{id}")
6
Dept getById(Integer id);

两处要说明的地方：

• 方法名：PPT 第 61 页里 Controller 调的是 deptService.getInfo(id)、Mapper 叫 getById；课程最终代码把 Service 层也统一叫 getById 了。名字不影响功能，看准”哪一层调哪一层的哪个方法”就行。
• 方法上的路径：课程代码在类上写了 @RequestMapping("/depts")，所以方法上只写 /{id}；PPT 第 61 页是在方法上写全路径 @GetMapping("/depts/{id}")。两种写法的最终地址完全一样，规则见下面「路径拼接」一节。
• 课程最终代码里那句 System.out.println 已经换成了 log.info("根据ID查询部门: {}", id)（类上是 Lombok 的 @Slf4j）——那是下一篇 63 篇的主题，本篇先按 PPT 的写法讲清接口本身。

本机实测：查询回显#

应用启动在 8080（启动日志 Tomcat started on port 8080 (http)），dept 表此时有 6 条课程自带数据 + 1 条刚才新增的”测试部”（id 为 7）：

1
{"code":1,"msg":"success","data":{"id":7,"name":"测试部","createTime":"2026-09-29T19:11:59","updateTime":"2026-09-29T19:11:59"}}

问答页（PPT 第 62 页）#

PPT 第 62 页问了两个问题：

多路径参数的写法（PPT 说”可以，接收方式如下”，把单个的写法复制几份即可）：

1
@GetMapping("/depts/{id}/{page}")   // 访问 /depts/1/0
2
public Result getInfo(@PathVariable Integer id, @PathVariable Integer page){
3
    System.out.println("id: " + id + " , page: " + page);
4
    return Result.success();
5
}

PPT 第 62 页还把两种写法并排贴了出来，正好拿来对照：

思路分析（PPT 第 65 页）#

参照接口文档梳理三层架构每一层的职责。

“补全基础属性”这件事上一节（新增）也做过，但补的东西不一样，这是个容易记混的点：

三层代码（PPT 第 66 页）#

1
// ===== Controller：com.itheima.controller.DeptController =====
2
@PutMapping
3
public Result update(@RequestBody Dept dept){
4
    System.out.println("修改部门: " + dept);
5
    deptService.update(dept);
6
    return Result.success();
7
}

1
// ===== Service：com.itheima.service.DeptService =====
2
/**
3
 * 修改部门
4
 */
5
void update(Dept dept);

1
// ===== ServiceImpl：com.itheima.service.impl.DeptServiceImpl =====
2
@Override
3
public void update(Dept dept) {
4
    // 1. 补全基础属性 - updateTime
5
    dept.setUpdateTime(LocalDateTime.now());
6

7
    // 2. 调用Mapper接口方法更新部门
8
    deptMapper.update(dept);
9
}

1
// ===== Mapper：com.itheima.mapper.DeptMapper =====
2
/**
3
 * 更新部门
4
 */
5
@Update("update dept set name = #{name} , update_time = #{updateTime} where id = #{id}")
6
void update(Dept dept);

三个要点：

• @PutMapping：REST 风格里”修改”用 PUT（57 篇的四种请求方式表：GET 查、POST 增、PUT 改、DELETE 删）。
• @RequestBody：请求体是 JSON，用一个实体对象接住（和 61 篇新增接口一模一样）；要求 JSON 的键名与对象的属性名一致——这里的 JSON 是 {"id":1,"name":"教研部"}，id/name 正好对上 Dept 的两个属性，于是 dept.getId()、dept.getName() 就有值了。
• SQL 只改两列：set name = #{name}, update_time = #{updateTime}，where id = #{id} 用对象里的 id 定位。id 来自请求体（前端知道用户点的是哪一行），updateTime 来自 Service。

本机实测：修改数据#

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

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

1. 修改部门要做两个接口：① 查询回显——按 id 把这条部门查出来填进”编辑部门”弹窗；② 修改数据——用户改完点”确定”，把 id + 新名字提交回去。回显的意义是”显示此刻数据库里的真实值”，而不是列表页上那份可能已经过期的数据
2. 回显接口的地址与方式：GET /depts/{id}，接口文档里标明的参数格式是路径参数，id 必须传递（示例 /depts/1）
3. 路径参数是什么：参数直接拼在 URL 路径里（不是 ?id=1 那种问号参数），用 {...} 在路径中占位
4. 取路径参数用 @PathVariable：它的 value 要和占位符名对上（@PathVariable("id")）；如果方法形参名与占位符名相同，value 可以省略（@PathVariable Integer id），课程最终代码用的是省略写法
5. 多个路径参数也可以：/depts/{id}/{page} 这样的地址能带多个路径参数，写法就是”有几个占位符就写几个 @PathVariable”
6. 回显的响应结构：Result 的 data 里装的是一个 Dept 对象（不是数组）；本机实测 GET /depts/7 得到 {"code":1,"msg":"success","data":{"id":7,"name":"测试部","createTime":"2026-09-29T19:11:59","updateTime":"2026-09-29T19:11:59"}}
7. 修改接口的地址与参数：PUT /depts，参数在请求体里、是 JSON 格式（{"id":1,"name":"教研部"}），用一个实体对象接收并要求 JSON 键名与属性名一致，必须加 @RequestBody
8. Service 层补什么：修改只补 updateTime（dept.setUpdateTime(LocalDateTime.now())）；createTime 不补也不改——新增时才两个时间都补
9. 修改的 SQL：update dept set name = #{name}, update_time = #{updateTime} where id = #{id}，只改 name 和 update_time 两列，用对象里的 id 定位
10. @RequestMapping 的拼接规则：注解可以加在类上（可选）和方法上，一个完整路径 = 类上的 value + 方法上的 value；实测 PUT /depts 返回 {"code":1,"msg":"success","data":null}，再查 id 为 7 的那条，name 已经变成”改名部”

二、裸写题#

• 2-1 开发”按 ID 查一个部门”的回显接口 需求：前端点”编辑”时要按 id 把这条部门的最新数据查回来，所以后端要提供一个接口——访问 /depts/1 就能拿到 id 为 1 的那个部门（用 Result 包起来，data 里是一个部门对象，不是数组）。请把 Controller / Service / Mapper 三层都写出来（Mapper 里写 SQL）。 （练习文件 test_62_修改部门接口.java 的题目2-1 里给了写作区。）

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

  一级 · 思路：这个接口的参数不是问号后面那种，而是长在 URL 路径里——先把路径里 id 的位置留成占位符，再想办法把那个位置的值取进方法形参 二级 · 方法：@GetMapping("/{id}")（或写全 @GetMapping("/depts/{id}")）+ 形参前面加 @PathVariable；Service 转发、Mapper 用 @Select 写 select ... from dept where id = #{id} 三级 · 骨架：@GetMapping("____") public Result getInfo(@____("id") Integer id){ Dept dept = deptService.____(id); return Result.____(dept); } → Service Dept ____(Integer id); → ServiceImpl return deptMapper.____(id); → Mapper @Select("select id, name, create_time, update_time from dept where id = ____") Dept ____(Integer id);

  参考答案（做完再点开）

  1
  // ===== DeptController =====
  2
  @GetMapping("/{id}")                       // 类上已有 @RequestMapping("/depts")，所以这里是 /depts/{id}
  3
  public Result getInfo(@PathVariable Integer id){
  4
      System.out.println("根据ID查询部门 : " + id);
  5
      Dept dept = deptService.getById(id);
  6
      return Result.success(dept);
  7
  }
  8
  
  9
  // ===== DeptService =====
  10
  Dept getById(Integer id);
  11
  
  12
  // ===== DeptServiceImpl =====
  13
  @Override
  14
  public Dept getById(Integer id) {
  15
      return deptMapper.getById(id);
  16
  }
  17
  
  18
  // ===== DeptMapper =====
  19
  @Select("select id, name, create_time, update_time from dept where id = #{id}")
  20
  Dept getById(Integer id);

  显示更多显示更少

  检查点：① URL 里的 {id} 是占位符名，@PathVariable 的 value 与它一致（形参也叫 id 时 value 可省）；② 返回的是单个 Dept，所以 MySQL 层方法返回值写 Dept 而不是 List<Dept>；③ 本机实测访问 GET /depts/7 得到 {"code":1,"msg":"success","data":{"id":7,"name":"测试部",...}}。

• 2-2 写”修改部门”的 Service 与 Mapper 需求：修改接口的 Controller 已经写好（收下一个 JSON 请求体，里面是 {"id":1,"name":"教研部"} 这样的数据），现在要把 Service 层和 Mapper 层补齐。要求：数据库里这条记录的”最后操作时间”要变成这次修改的时间，而”创建时间”保持原样不能动；SQL 只更新需要变的列。 （练习文件 test_62_修改部门接口.java 的题目2-2 里给了写作区。）

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

  一级 · 思路：请求体只带回了 id 和 name，update_time 得由服务端在业务层现场补上；create_time 这一次完全不用管 二级 · 方法：ServiceImpl 里 dept.setUpdateTime(LocalDateTime.now())，然后调 Mapper；Mapper 用 @Update("update dept set ____, ____ where id = ____")，#{} 里写的是实体类的属性名 三级 · 骨架：@Override public void update(Dept dept) { dept.set____(LocalDateTime.now()); deptMapper.update(dept); } + @Update("update dept set name = ____, update_time = ____ where id = ____") void update(Dept dept);

  参考答案（做完再点开）

  1
  // ===== DeptServiceImpl =====
  2
  @Override
  3
  public void update(Dept dept) {
  4
      // 1. 补全基础属性 - updateTime
  5
      dept.setUpdateTime(LocalDateTime.now());
  6
  
  7
      // 2. 调用Mapper接口方法更新部门
  8
      deptMapper.update(dept);
  9
  }
  10
  
  11
  // ===== DeptMapper =====
  12
  @Update("update dept set name = #{name} , update_time = #{updateTime} where id = #{id}")
  13
  void update(Dept dept);

  说明：① 只补 updateTime——createTime 表示”这条记录什么时候建的”，改名字不该动它，所以 SQL 的 set 里也没有它；② SQL 里三个 #{} 分别对应 Dept 的 name、updateTime、id 三个属性（id 从请求体来，用来定位那一行）；③ 本机实测：PUT /depts 传 {"id":7,"name":"改名部"} 返回 success，再查该条记录 name 已变。

• 2-3 把重复写的路径前缀提到类上，并回答拼接问题 需求：现在 Controller 里五个方法的路径注解都各自带着一遍 /depts（查询列表写 /depts、根据 ID 查询写 /depts/{id}、删除/新增/修改也在各自注解里写着 /depts），重复得厉害。请改成”公共前缀在类上写一次”的写法，并回答两个问题：① 改完之后每个方法最终暴露的地址分别是什么？② 如果改完之后方法上又写了一遍 /depts，拼出来的地址会变成什么样？ （练习文件 test_62_修改部门接口.java 的题目2-3 里给了写作区。）

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

  一级 · 思路：把五个方法里共同的 /depts 抽出来，放到类上写一次；方法上只留”这条接口独有的那部分” 二级 · 方法：类上写 @RequestMapping("/depts")；方法上没有独有路径的，注解后面什么都不写（如 @GetMapping、@DeleteMapping、@PostMapping、@PutMapping），有独有路径的只写那一段（@GetMapping("/{id}")） 三级 · 骨架：@RequestMapping("____") + @RestController + public class DeptController { ... @GetMapping ____ public Result list(){...} ... @GetMapping("____") public Result getInfo(...) }

  参考答案（做完再点开）

  1
  @RequestMapping("/depts")
  2
  @RestController
  3
  public class DeptController {
  4
  
  5
      @Autowired
  6
      private DeptService deptService;
  7
  
  8
      @GetMapping
  9
      public Result list(){ ... }                 // GET  /depts
  10
  
  11
      @DeleteMapping
  12
      public Result delete(Integer id){ ... }      // DELETE /depts?id=8
  13
  
  14
      @PostMapping
  15
      public Result add(@RequestBody Dept dept){ ... }   // POST /depts
  16
  
  17
      @GetMapping("/{id}")
  18
      public Result getInfo(@PathVariable Integer id){ ... }  // GET /depts/{id}
  19
  
  20
      @PutMapping
  21
      public Result update(@RequestBody Dept dept){ ... }     // PUT /depts
  22
  }

  显示更多显示更少

  回答：① 拼出来的地址依次是 GET /depts、DELETE /depts、POST /depts、GET /depts/{id}、PUT /depts——和改之前完全一样；② 如果方法上又写一遍 /depts，规则是”类上的 + 方法上的”直接拼，会得到 /depts/depts（getInfo 那条会变成 /depts/depts/{id}），接口就访问不到了——所以类上写了公共前缀，方法上就不要再重复。这正是 PPT 第 67-68 页那两句规则。

三、综合题#

• 3-1 完成修改部门的两个接口（回显 + 保存），并跑通验证 这一题就是把本节的两个接口从头到尾做一遍，做完你就拥有一个能用的”编辑部门”后端。

  1. 回显接口：在 DeptController 里加”根据 ID 查询部门”的方法——接住路径传进来的 id，交给 Service、Service 调 Mapper 查这一条数据，最后用 Result.success(dept) 返回一个部门对象；SQL 按主键查一条（列名照 dept 表写全）；
  2. 修改接口：再加”修改部门”的方法——用一个 Dept 实体对象接住 JSON 请求体（{"id":1,"name":"教研部"}），Service 层只补 updateTime，Mapper 写”只改 name 和 update_time、按 id 定位”的 SQL；
  3. 路径整理：按 PPT 第 67-68 页的规则，把 /depts 这个公共前缀提到类上，方法上只写剩下的部分；
  4. 启动应用（入口类 TliasWebManagementApplication），先调 回显 接口：GET /depts/1，把响应的 JSON 抄到练习文件末尾，并回答”data 里装的是一个对象还是一个数组”；
  5. 再调 修改 接口：PUT /depts，请求体 {"id":1,"name":"教研部（改）"}，抄下响应；然后再调一次回显接口，确认名字真的变了、update_time 被刷新了；
  6. 回答 PPT 第 62、68 页的三个问题：路径参数怎么接收？URL 里能不能带多个路径参数？“路径”这个注解可以加在哪儿、一个完整路径怎么算？
  7. 收尾：把刚才改掉的部门名字改回原样（再调一次修改接口），或者重新导入课程 资料/05. 数据库表/dept.sql 把表恢复成 6 条。 （练习文件 test_62_修改部门接口.java 的”综合题”一段里按这 7 步给了写作区。）

  涉及知识点

  知识点	在这里的应用
  路径参数 + @PathVariable	第 1、4 步——回显接口按 id 查一条
  JSON 参数 + @RequestBody	第 2、5 步——修改接口用实体对象接请求体
  Service 补全 updateTime	第 2、5 步——改完”最后操作时间”要刷新，createTime 不动
  @RequestMapping 拼接	第 3 步——公共前缀提到类上
  两个接口的响应结构	第 4、5 步——回显返回一个对象、修改返回 data:null

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

  一级 · 思路：回显 = “按 id 查一条”（参数在路径里），保存 = “按 id 改一条”（参数在请求体里）；两条链路都是 Controller → Service → Mapper 三跳 二级 · 方法：回显用 @GetMapping("/{id}") + @PathVariable + @Select；保存用 @PutMapping + @RequestBody + @Update；路径前缀用类上的 @RequestMapping("/depts") 三级 · 骨架：类上 @RequestMapping("____")；回显 @GetMapping("____") public Result getInfo(@____ Integer id){ return Result.success(deptService.____(id)); }；保存 @PutMapping public Result update(@____ Dept dept){ deptService.____(dept); return Result.success(); }；ServiceImpl 的 update 里先 dept.set____(LocalDateTime.now()) 再调 Mapper

  参考答案（做完再点开）

  3-1 1~3. 与课程工程 tlias-web-management 一致的四段代码：

  1
  // ===== DeptController =====
  2
  @Slf4j                    // 日志那块是 63 篇的内容，这里可以先只写 @RequestMapping + @RestController
  3
  @RequestMapping("/depts")
  4
  @RestController
  5
  public class DeptController {
  6
      @Autowired
  7
      private DeptService deptService;
  8
  
  9
      @GetMapping("/{id}")
  10
      public Result getInfo(@PathVariable Integer id){
  11
          System.out.println("根据ID查询部门 : " + id);
  12
          Dept dept = deptService.getById(id);
  13
          return Result.success(dept);
  14
      }
  15
  
  16
      @PutMapping
  17
      public Result update(@RequestBody Dept dept){
  18
          System.out.println("修改部门: " + dept);
  19
          deptService.update(dept);
  20
          return Result.success();
  21
      }
  22
  }
  23
  
  24
  // ===== DeptServiceImpl =====
  25
  @Override
  26
  public Dept getById(Integer id) {
  27
      return deptMapper.getById(id);
  28
  }
  29
  
  30
  @Override
  31
  public void update(Dept dept) {
  32
      dept.setUpdateTime(LocalDateTime.now());   // 只补 updateTime
  33
      deptMapper.update(dept);
  34
  }
  35
  
  36
  // ===== DeptMapper =====
  37
  @Select("select id, name, create_time, update_time from dept where id = #{id}")
  38
  Dept getById(Integer id);
  39
  
  40
  @Update("update dept set name = #{name} , update_time = #{updateTime} where id = #{id}")
  41
  void update(Dept dept);

  显示更多显示更少

  4~5. 本机实测（应用启动在 8080）：

  1
  # 回显：GET /depts/7
  2
  {"code":1,"msg":"success","data":{"id":7,"name":"测试部","createTime":"2026-09-29T19:11:59","updateTime":"2026-09-29T19:11:59"}}
  3
  
  4
  # 修改：PUT /depts  body: {"id":7,"name":"改名部"}
  5
  {"code":1,"msg":"success","data":null}
  6
  
  7
  # 再查 GET /depts/7 → name 已变成"改名部"

  data 里装的是一个对象（{...}），不是数组（[...]）——数组那种是”查询列表”接口（GET /depts）的返回。修改接口返回的 data 是 null，因为 Result.success() 没带数据。 6. PPT 第 62、68 页问答：① 路径参数用 @PathVariable 接收（URL 里用 {...} 占位、注解 value 与占位符名对应，形参名一致时可省略）；② 可以带多个路径参数，如 /depts/{id}/{page}，有几个占位符就写几个 @PathVariable；③ @RequestMapping 可加在类上（可选）和方法上，完整路径 = 类上的 + 方法上的。 7. 收尾照做：改回原名或重新导入 dept.sql，别把课程数据留在”改名部”上。