Controller：接收 JSON 请求体#

1
@PostMapping
2
public Result save(@RequestBody Emp emp){
3
    log.info("请求参数emp: {}", emp);
4
    empService.save(emp);
5
    return Result.success();
6
}

两个要点：

• @PostMapping：新增用 POST，和接口文档对得上（类上已经有 @RequestMapping("/emps")，所以方法上不用再写路径，完整路径 = 类上 + 方法上的）；
• @RequestBody：请求体是 application/json，要让 SpringMVC 把 JSON 反序列化成 Emp 对象必须加它（61 篇讲新增部门时用的是简单参数，那种不用加）。exprList 因为 Emp 里有这个字段，也会一起被装进去。

Service：先补全基础属性，再插库#

1
@Override
2
public void save(Emp emp) {
3
    //1. 补全基础属性
4
    emp.setCreateTime(LocalDateTime.now());
5
    emp.setUpdateTime(LocalDateTime.now());
6
    //2. 保存员工基本信息
7
    empMapper.insert(emp);
8
}

为什么要在这里补 create_time/update_time？因为前端表单里没有这两个字段（用户不填、也填不了），它们是”记录这件事发生了”的服务端数据，由业务层在保存前补上。LocalDateTime.now() 取当前时间——66 篇里”最后操作时间”那一列显示的就是 update_time。

Mapper：一句 insert#

1
@Options(useGeneratedKeys = true, keyProperty = "id") //获取到生成的主键 -- 主键返回
2
@Insert("insert into emp(username, name, gender, phone, job, salary, image, entry_date, dept_id, create_time, update_time)" +
3
        " values (#{username}, #{name}, #{gender},#{phone},#{job},#{salary},#{image},#{entryDate},#{deptId},#{createTime},#{updateTime})")
4
void insert(Emp emp);

• @Insert 里是完整的插入 SQL，#{} 里写的是 Emp 对象的属性名（不是表字段名）：#{entryDate} 对应 entry_date 列、#{deptId} 对应 dept_id 列——驼峰转下划线这件事 55 篇讲过（map-underscore-to-camel-case）；
• 没有 password：新增员工的表单里压根没有密码这一项，所以 insert 的字段里也没有它；
• id 也没写：它是数据库自增的主键，由 MySQL 自己生成。

为什么不能一条一条插#

PPT 第 8 页把三种情况摆在一起：

1
insert into emp_expr(...) values (?,?,?,?,?)                      -- 一条经历，一条 SQL
2
insert into emp_expr(...) values (?,?,?,?,?),(?,?,?,?,?)           -- 两条经历，一条 SQL
3
insert into emp_expr(...) values (?,?,?,?,?),(?,?,?,?,?),(?,?,?,?,?)  -- 三条经历，一条 SQL

工作经历是 List<EmpExpr>，有几条不确定：用户可能一段都没填，也可能填五段。一条 SQL 插一条的做法要循环发 N 次请求，效率低；而且 SQL 长什么样也不固定。所以要用动态 SQL 里的 <foreach> 标签——让 MyBatis 根据集合的条数，把 values 后面那串括号按需拼出来。

Mapper 接口 + XML 映射#

接口方法只有一个形参：一个 List<EmpExpr>（55 篇的规则：SQL 复杂就写 XML；同包同名、namespace 是接口全限定名、id 是方法名）：

1
@Mapper
2
public interface EmpExprMapper {
3
    /**
4
     * 批量保存员工的工作经历信息
5
     */
6
    void insertBatch(List<EmpExpr> exprList);
7
}

src/main/resources/com/itheima/mapper/EmpExprMapper.xml：

1
<?xml version="1.0" encoding="UTF-8" ?>
2
<!DOCTYPE mapper
3
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
4
        "https://mybatis.org/dtd/mybatis-3-mapper.dtd">
5
<mapper namespace="com.itheima.mapper.EmpExprMapper">
6

7
    <!--批量保存员工工作经历信息
8
    foreach 标签:
9
        collection: 遍历的集合
10
        item: 遍历出来的元素
11
        separator: 每次循环之间的分隔符
12
    -->
13
    <insert id="insertBatch">
14
        insert into emp_expr(emp_id, begin, end, company, job) values
15
        <foreach collection="exprList" item="expr" separator=",">
16
            (#{expr.empId},#{expr.begin},#{expr.end},#{expr.company},#{expr.job})
17
        </foreach>
18
    </insert>
19

20
</mapper>

读这段 XML 的顺序是：insert into emp_expr(emp_id, begin, end, company, job) values 是固定前缀，<foreach> 里那段括号是循环体——集合里有几条 empExpr，它就重复贴几遍，中间用 separator 的逗号隔开。

<foreach> 五个属性（PPT 第 9 页属性说明 + 第 10 页问答）#

Service 里的组装过程（PPT 第 8 页 + 课程代码）#

1
@Override
2
public void save(Emp emp) {
3
    //1. 保存员工基本信息
4
    emp.setCreateTime(LocalDateTime.now());
5
    emp.setUpdateTime(LocalDateTime.now());
6
    empMapper.insert(emp);
7

8
    //2. 保存员工工作经历信息
9
    List<EmpExpr> exprList = emp.getExprList();
10
    if(!CollectionUtils.isEmpty(exprList)){
11
        //遍历集合, 为empId赋值
12
        exprList.forEach(empExpr -> {
13
            empExpr.setEmpId(emp.getId());      // ← 主键返回拿到的 id
14
        });
15
        empExprMapper.insertBatch(exprList);
16
    }
17
}

三个细节：

• CollectionUtils.isEmpty(exprList)（org.springframework.util.CollectionUtils）：用户可能一段工作经历都没填，那 exprList 就是 null 或者空集合——这时候不能去调 insertBatch（会拼出 values 后面什么都没有的非法 SQL），所以先判空；
• forEach 里 setEmpId(emp.getId())：把主键返回拿到的 id 一条条填进工作经历。PPT 上的写法是先 Integer empId = emp.getId(); 存一个局部变量再在 forEach 里用，效果一样；
• 插完基本信息才插经历：顺序不能反——经历要用员工 id，而 id 是第一步插完才有的。

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

1. 需求：一次”新增员工”要写两张表——emp（员工基本信息）和 emp_expr（工作经历，多条），两张表靠 emp_expr.emp_id = emp.id 关联
2. 接口：请求路径 /emps、请求方式 POST、参数格式 application/json；必填 username/name/gender，非必须 image/deptId/entryDate/job/salary/exprList
3. 三层分工：Controller 用 @RequestBody 把 JSON 装成 Emp、调 Service、响应 Result；Service 先保存基本信息（补 createTime/updateTime）再批量保存经历；Mapper 两句 insert
4. 为什么要补时间：前端表单里没有 create_time/update_time，这两个”记录操作发生”的字段由 Service 在保存前用 LocalDateTime.now() 补全
5. Controller 的两个注解：@PostMapping（新增用 POST，类上已有 /emps 所以方法上不写路径）；@RequestBody（JSON 请求体转 Java 对象，exprList 也在其中）
6. 主键返回：@Options(useGeneratedKeys = true, keyProperty = "id")——用数据库生成的自增主键，并回填到实体对象的 id 属性；没有它 emp.getId() 就是 null，工作经历没法关联员工
7. 批量插入：多条经历用”一条 SQL 多个 values”（insert into emp_expr(...) values (...),(...)），靠动态 SQL <foreach> 按集合条数拼出来
8. <foreach> 属性：collection 集合名称、item 遍历出来的元素、separator 每次遍历之间的分隔符（可选）、open 遍历开始前拼接的片段（可选）、close 遍历结束后拼接的片段（可选）
9. 判空：CollectionUtils.isEmpty(exprList)——用户可能一段经历都不填，null/空集合时不能调用批量插入（SQL 会变成 values 后面啥也没有）
10. 本机实测：POST /emps → {"code":1,"msg":"success","data":null}；emp 生成 id=38、emp_expr 2 条且 emp_id 都是 38；日志 SQL 为 insert into emp_expr (emp_id, begin, end, company, job) values (?,?,?,?,?) , (?,?,?,?,?)
11. 遗留问题（PPT 第 11 页）：保存基本信息成功、保存经历失败不可以——属于一个业务操作，会造成数据的不完整、不一致，需要事务管理

二、裸写题#

• 2-1 开发”新增员工”的接口（基本信息部分） 需求：前端把一张新增员工表单以 JSON 提交到 /emps（POST）。三层都要写：控制层接收这个 JSON 参数、打一行日志、调用业务层、返回统一响应结果；业务层保存前先把”创建时间”和”修改时间”补上当前时间，再交给数据访问层；数据访问层用一条 insert 把用户名、姓名、性别、手机号、职位、薪资、头像、入职日期、所属部门 id、创建时间、修改时间写进 emp 表（密码和主键不由这里写，主键是自增的）。 （练习文件 test_69_新增员工.java 的题目2-1 里给了写作区。）

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

  一级 · 思路：控制层要一个”把 JSON 变成实体对象”的注解；业务层先 LocalDateTime.now() 补两个时间字段再调数据访问层；数据访问层一句 insert，占位符里写实体类的属性名（不是表字段名） 二级 · 方法：Controller 用 @PostMapping + @RequestBody Emp emp，返回 Result.success()；Service 用 emp.setCreateTime(...)/setUpdateTime(...) 后调 empMapper.insert(emp)；Mapper 用 @Insert("insert into emp(...) values (#{...})") void insert(Emp emp); 三级 · 骨架：

  • Controller：@PostMapping public Result save(@____ Emp emp){ log.info(…); empService.____(emp); return Result.____(); }
  • Service：emp.setCreateTime(LocalDateTime.____()); emp.setUpdateTime(…); empMapper.____(emp);
  • Mapper：@Insert("insert into emp(username, name, …, dept_id, create_time, update_time) values (#{username}, #{name}, …)") void ____(Emp emp);
  参考答案（做完再点开）

  与课程 代码/tlias-web-management 一致（PPT 第 7 页同）：

  1
  // ===== Controller：接收 JSON 请求体 + 响应结果 =====
  2
  @PostMapping
  3
  public Result save(@RequestBody Emp emp){
  4
      log.info("请求参数emp: {}", emp);
  5
      empService.save(emp);
  6
      return Result.success();
  7
  }

  1
  // ===== Service：补全基础属性 + 调用 Mapper =====
  2
  @Override
  3
  public void save(Emp emp) {
  4
      //1. 补全基础属性
  5
      emp.setCreateTime(LocalDateTime.now());
  6
      emp.setUpdateTime(LocalDateTime.now());
  7
      //2. 保存员工基本信息
  8
      empMapper.insert(emp);
  9
  }

  1
  // ===== Mapper：一句 insert =====
  2
  @Options(useGeneratedKeys = true, keyProperty = "id") //获取到生成的主键 -- 主键返回
  3
  @Insert("insert into emp(username, name, gender, phone, job, salary, image, entry_date, dept_id, create_time, update_time)" +
  4
          " values (#{username}, #{name}, #{gender},#{phone},#{job},#{salary},#{image},#{entryDate},#{deptId},#{createTime},#{updateTime})")
  5
  void insert(Emp emp);

  自查：① #{} 里是 Emp 的属性名（entryDate/deptId），列名是 entry_date/dept_id，靠着驼峰映射对上；② 没有 password（表单里没有这一项）；③ @Options 那行下一题马上要用到——本机实测没有它就拿不到新员工的 id。

• 2-2 插完基本信息，把数据库生成的主键拿回来 需求：员工的主键是数据库自增出来的，Java 里插入前是 null。业务层在保存完基本信息之后，要立刻拿到这个新员工的 id，用它给每一条工作经历填上”属于哪个员工”，然后再去保存经历。请改成能让业务层拿到新 id 的写法，并说明”没有它会发生什么”。 （练习文件 test_69_新增员工.java 的题目2-2 里给了写作区。）

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

  一级 · 思路：这是”主键返回”——在插入方法上加一个注解，让 MyBatis 把数据库生成的主键回填到实体对象的 id 属性上；业务层插完直接 getId() 就行 二级 · 方法：@Options(useGeneratedKeys = true, keyProperty = "id") 加在 Mapper 的插入方法上（和 @Insert 一起） 三级 · 骨架：@____(useGeneratedKeys = ____, keyProperty = "____") ＋ void insert(Emp emp);；业务层里 empMapper.insert(emp); Integer id = emp.____();

  参考答案（做完再点开）

  1
  @Options(useGeneratedKeys = true, keyProperty = "id") //获取到生成的主键 -- 主键返回
  2
  @Insert("insert into emp(...) values (...)")
  3
  void insert(Emp emp);

  说明：

  • useGeneratedKeys = true 表示用数据库生成的主键（emp.id 是 auto_increment）；
  • keyProperty = "id" 表示把生成的值回填到 Emp 对象的 id 属性上，所以 insert 执行完 emp.getId() 就是新 id；
  • 没有它：emp.getId() 仍是 null，业务层给工作经历 setEmpId(null)，emp_expr.emp_id 存进去是 NULL——工作经历和员工对不上号，等于白存（外键关联断了）。
  • 本机实测：这次插入生成的是 id = 38，两段工作经历的 emp_id 都是 38——正是主键返回生效的证明。

• 2-3 一条 SQL 批量保存多条工作经历 需求：用户一次可能填 0 段、1 段或多段工作经历，代码里拿到的是一个”工作经历对象的列表”。要求用一条插入语句把列表里的每一条都写进工作经历表（每条对应一组 values，用逗号相连），列是 emp_id、开始时间、结束时间、公司、职位。SQL 写在 XML 里。 （练习文件 test_69_批量插入XML.xml 的题目2-3 里给了写作区。）

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

  一级 · 思路：SQL 的固定部分是 insert into emp_expr(列...) values，后面”每组值的括号”有多少个取决于列表长度——用动态 SQL 的标签把集合”遍历+拼串”就能做到 二级 · 方法：<foreach> 标签，collection 写 Mapper 方法的形参名、item 起个循环变量名、separator=","；括号写在 foreach 内部，取值用 #{item.属性名}；XML 里用 <insert id="方法名"> 三级 · 骨架：

  1
  <insert id="____">
  2
      insert into emp_expr(emp_id, begin, end, company, job) values
  3
      <foreach collection="____" item="____" separator="____">
  4
          (#{____.empId}, #{____.begin}, #{____.end}, #{____.company}, #{____.job})
  5
      </foreach>
  6
  </insert>

  参考答案（做完再点开）

  EmpExprMapper.java（一个形参：工作经历列表）：

  1
  @Mapper
  2
  public interface EmpExprMapper {
  3
      void insertBatch(List<EmpExpr> exprList);   // 批量保存员工的工作经历信息
  4
  }

  EmpExprMapper.xml（课程代码 / PPT 第 9 页）：

  1
  <mapper namespace="com.itheima.mapper.EmpExprMapper">
  2
  
  3
      <insert id="insertBatch">
  4
          insert into emp_expr(emp_id, begin, end, company, job) values
  5
          <foreach collection="exprList" item="expr" separator=",">
  6
              (#{expr.empId},#{expr.begin},#{expr.end},#{expr.company},#{expr.job})
  7
          </foreach>
  8
      </insert>
  9
  
  10
  </mapper>

  自查：① collection 写的是 Mapper 方法的形参名 exprList（Spring Boot 编译时带 -parameters，参数名才能被 MyBatis 认出来）；② item 是循环变量 expr，取值必须写成 #{expr.属性}；③ 括号放在 foreach 内部、逗号由 separator 负责——千万不要自己在括号后面再写逗号，那样最后一条会多出一个逗号；④ <insert> 的 id 必须等于接口方法名 insertBatch，namespace 必须等于接口全限定名（55 篇）。 本机实测：两段经历时服务端日志里的 SQL 是 insert into emp_expr (emp_id, begin, end, company, job) values (?,?,?,?,?) , (?,?,?,?,?)——一条 SQL、两组括号。而业务层在调用它之前，要用 CollectionUtils.isEmpty(exprList) 判空，一段经历都没有时不要调这个方法。

• 2-4 把”两次插入”的顺序和关联讲清楚 需求：有人把业务层写成”先批量保存工作经历，再保存员工基本信息”，也有人忘了给工作经历填员工 id。请说明：① 这两步的正确顺序以及为什么；② 每段工作经历上的”员工 id”是什么时候、从哪儿来的；③ 如果用户一段工作经历都没填，代码要怎么处理。 （练习文件 test_69_新增员工.java 的题目2-4 里给了写作区。）

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

  一级 · 思路：工作经历要用员工的 id，所以”员工先存、经历后存”；id 是数据库自增的，只能靠”主键返回”拿到；没有经历时别调批量插入 二级 · 方法：empMapper.insert(emp) → emp.getId() → forEach 里 empExpr.setEmpId(id) → empExprMapper.insertBatch(exprList)；判空用 CollectionUtils.isEmpty(...) 三级 · 骨架：① empMapper.____(emp); → List<EmpExpr> exprList = emp.____(); if(!CollectionUtils.____(exprList)){ exprList.____(e -> e.setEmpId(emp.getId())); empExprMapper.____(exprList); }；② 顺序理由：工作经历需要 emp_id，而 emp_id 来自刚刚插入的员工的主键；③ 判空后跳过批量插入

  参考答案（做完再点开）

  ① 顺序：先员工、后经历。因为 emp_expr.emp_id 的值就是新员工的 emp.id，而它是第一步 insert 完成后（靠主键返回）才拿到的；反过来先插经历，emp_id 只能填 null。 ② 每段工作经历的 empId 由业务层在插入经历之前逐个赋值：empMapper.insert(emp) 之后 emp.getId() 拿到自增主键（本机实测 38），再 exprList.forEach(empExpr -> empExpr.setEmpId(emp.getId()))（PPT 上的写法是先存成局部变量 Integer empId = emp.getId(); 再用）。 ③ 用户一段都没填时 exprList 是 null 或空集合，要用 CollectionUtils.isEmpty(exprList) 判空后跳过 insertBatch——否则 <foreach> 会拼出 insert into emp_expr(...) values 后面空无一物的非法 SQL；但基本信息照样要存（这个人可以在没有简历经历的情况下入职）。

三、综合题#

• 3-1 照着课程把”新增员工”从页面做到数据库 这一题把本节从头到尾走一遍，并且故意制造一次失败，为下一篇（事务管理）留证据。

  1. 三层补齐”新增员工”：控制层接收 JSON、业务层补时间 + 保存基本信息 + 给经历赋 empId + 批量保存、数据访问层写两句 SQL（一句注解版、一句 XML 版）；
  2. 启动工程，用 Apifox（或用 JSON 文件 + curl --data-binary @body.json，文件必须是 UTF-8）发一次 POST /emps，请求体带 两段工作经历，把返回的 JSON 抄下来；
  3. 去客户端查库：select * from emp order by id desc limit 1; 和 select * from emp_expr where emp_id = <刚才那个 id>;——记录新员工的 id 和经历的条数，确认两段经历的 emp_id 都等于新员工的 id；
  4. 把服务端日志里 <foreach> 拼出来的那条 SQL 抄下来（提示：看 insert into emp_expr 那两行，数一数 values 后面有几组括号）；
  5. 做对照实验：把业务层里”保存工作经历”那一步注释掉（或者改成故意抛异常），再发一次新增请求，然后查库——员工和经历各有几条？把结果记下来；
  6. 回答两个问题。

  （练习文件 test_69_新增员工.java 的”综合题”一段里按这 6 步给了写作区。）

  回答：① 如果保存基本信息成功、保存经历失败，数据库会变成什么样？为什么说”不可以”？② 要在代码里避免这种情况，下一步该引入什么机制？

  涉及知识点

  知识点	在这里的应用
  需求与接口文档（PPT 5）	第 2 步——POST /emps、application/json、exprList 是工作经历列表
  三层分工（PPT 6）	第 1 步——Controller 接参、Service 双插入、Mapper 两句 SQL
  保存基本信息（PPT 7）	第 1、2 步——@RequestBody 接收、Service 补时间、@Insert 落库
  主键返回（PPT 10）	第 3 步——emp_expr.emp_id 等于新员工 id 的关键
  <foreach> 批量插入（PPT 8～10）	第 1、4 步——一条 SQL 多组 values，日志里能直接看到
  数据不一致问题（PPT 11）	第 5、6 步——故意失败后的对照结果，就是下一篇要解决的问题

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

  一级 · 思路：先把”成功路径”跑通（能查到员工 + 两段经历），再用一次”人为失败”暴露问题；每一步都用数据库查询和日志做证据 二级 · 方法：@PostMapping + @RequestBody；empMapper.insert(emp) + @Options 拿主键；empExprMapper.insertBatch(exprList) + XML 里的 <foreach>；查库用 select * from emp_expr where emp_id = ? 三级 · 骨架：① 业务层 empMapper.____(emp); List<EmpExpr> exprList = emp.getExprList(); if(!CollectionUtils.____(exprList)){ exprList.forEach(e -> e.setEmpId(emp.____())); empExprMapper.____(exprList); }；② 请求 POST http://localhost:8080/____；③ 查库 SQL select * from emp_expr where emp_id = ____；④ 对照实验后：emp 有 ____ 条、emp_expr 有 ____ 条

  参考答案（做完再点开）

  1. 三层代码（与 2-1、2-2、2-3 的答案一致，合起来就是课程 EmpController.save / EmpServiceImpl.save / EmpMapper.insert / EmpExprMapper.insertBatch）：

  1
  @Override
  2
  public void save(Emp emp) {
  3
      //1. 保存员工基本信息
  4
      emp.setCreateTime(LocalDateTime.now());
  5
      emp.setUpdateTime(LocalDateTime.now());
  6
      empMapper.insert(emp);
  7
  
  8
      //2. 保存员工工作经历信息
  9
      List<EmpExpr> exprList = emp.getExprList();
  10
      if(!CollectionUtils.isEmpty(exprList)){
  11
          exprList.forEach(empExpr -> empExpr.setEmpId(emp.getId()));
  12
          empExprMapper.insertBatch(exprList);
  13
      }
  14
  }

  2. 响应（本机实测）：{"code":1,"msg":"success","data":null}。 3. 查库（本机实测）：emp 里新员工 id = 38；emp_expr 2 条，emp_id 都是 38——主键返回生效的证据。 4. <foreach> 拼出来的 SQL（本机实测）：

  1
  ==>  Preparing: insert into emp_expr (emp_id, begin, end, company, job) values (?,?,?,?,?) , (?,?,?,?,?)

  两段经历 → 两组括号，中间是 separator 拼出的逗号。 5. 对照实验（结果就是 PPT 第 11 页说的情况）：把”保存工作经历”那一步去掉/改坏之后，emp 表里有这条员工，emp_expr 表里一条都没有——员工有了、他的工作经历丢了。把这两条查询结果记下来，70 篇和71 篇还会用它做对照。 6. 两个回答： ① 数据库会留下一个”只有基本信息、没有工作经历”的残缺员工——数据的完整性（该有的没有）和一致性（两张表对不上）都被破坏。PPT 说”不可以”的原因就是这个：新增员工在业务上是一个操作，员工和他的工作经历必须同生共死； ② 下一步引入事务管理：把这两次插入包进同一个事务里，出异常就整体回滚（70 篇）。