三种解法（PPT 第 30 页）#

PPT 第 30 页给了三条路，前两条是”本地修”，第三条是”一劳永逸”。

解法一：手动结果映射——用 @Results 把”哪一列对应哪个属性”一条条写出来：

1
@Results({
2
    @Result(column = "create_time", property = "createTime"),
3
    @Result(column = "update_time", property = "updateTime")
4
})
5
@Select("select id, name, create_time, update_time from dept order by update_time desc")
6
public List<Dept> findAll();

解法二：起别名——在 SQL 里给列起一个”和属性名一样”的别名，让字段名与属性名自己变一致：

1
@Select("select id, name, create_time createTime, update_time updateTime from dept ...")
2
public List<Dept> findAll();

解法三：开启驼峰命名（PPT 推荐）——让 MyBatis 自己按规则把下划线转成驼峰：

1
mybatis:
2
  configuration:
3
    map-underscore-to-camel-case: true

这一行写在 application.yml 里（就是 57 篇工程搭建第 2 步里那份配置中已经带着的那行），开关一开，create_time 自动对应 createTime、update_time 自动对应 updateTime，Mapper 和 SQL 一个字都不用动。

1
{"id":3,"name":"咨询部","createTime":null,"updateTime":null}

为什么推荐第三种？把三条路放在一起比一比：

顺带看看 Mapper 干了什么（SQL 日志）#

工程 yml 里开了 MyBatis 的日志输出（log-impl 那行），查一次部门，控制台能看到这次执行的 SQL 细节——这也是排查”字段是不是封装错”最快的办法：

1
==>  Preparing: select id, name, create_time, update_time from dept order by update_time desc
2
==> Parameters:
3
<==      Total: 6

（Total: 6 就是一共查回 6 行数据；日志里 Parameters 为空，因为这次没有条件参数。）

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

1. 接口信息：查询部门是 GET /depts，无请求参数，响应 application/json，data 里是部门对象数组（id/name/createTime/updateTime）
2. 三层职责：Controller 接收请求、调用 Service 层、响应结果；Service 调用 Mapper 接口方法；Mapper 写 SQL（查询这类没有业务规则的接口，Service 是透传，但结构不能省）
3. 排序 SQL：select … from dept order by update_time desc——按修改时间倒序；本机实测 6 条数据里咨询部（2024-09-30）排最前，与库里存储顺序无关
4. Controller 三件套：类上 @RestController（返回对象转 JSON）、方法上 @GetMapping("/depts")（映射 GET 请求）、@Autowired 注入 Service；返回 Result.success(deptList)
5. Mapper：接口上 @Mapper（MyBatis 生成实现类），方法上用 @Select 写 SQL，返回 List<Dept>
6. MyBatis 封装规则：实体类属性名与表字段名一致 → 自动封装；不一致 → 封装不上（属性为 null）
7. 不一致的三种解法：① @Results/@Result 手动结果映射 ② SQL 里起别名（create_time createTime）③ 开启驼峰命名开关（mybatis.configuration.map-underscore-to-camel-case: true，PPT 推荐）
8. 为什么推荐驼峰开关：一行配置对整个工程生效；@Results 和起别名都要逐方法、逐条 SQL 写
9. 驼峰开关的前提与实测：字段名与属性名要符合 xxx_abc → xxxAbc 规则；本机实测把开关改成 false 后 createTime/updateTime 全变 null，改回 true 恢复
10. 响应细节：外层是 {"code":1,"msg":"success","data":…}；时间字段响应成 2024-09-30T21:26:24（带 T，LocalDateTime 转 JSON 的默认格式）

二、裸写题#

• 2-1 写数据访问层：查询全部部门、按最后修改时间倒序 需求：做一个”从 dept 表里查出所有部门”的数据访问方法，要求结果按最后修改时间从晚到早排好；返回类型要能装下多条部门记录。 （练习文件 test_58_查询部门接口.java 的题目2-1 里给了写作区。）

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

  一级 · 思路：这一层只干”取数据”，没有任何业务判断；所以就是一个接口 + 一个注解 + 一条 SQL，不用写实现类 二级 · 方法：接口标 @Mapper，方法标 @Select("…")；SQL 是 select 字段 from dept order by update_time desc；返回 List<Dept> 三级 · 骨架：@Mapper public interface DeptMapper { @Select("select ____ from dept order by ____ desc") List<Dept> ____(); }

  参考答案（做完再点开）

  1
  @Mapper
  2
  public interface DeptMapper {
  3
      /**
  4
       * 查询全部部门
  5
       */
  6
      @Select("select id, name, create_time, update_time from dept order by update_time desc")
  7
      List<Dept> findAll();
  8
  }

  说明：@Mapper 让 MyBatis 运行时生成这个接口的实现（不用自己写 Impl）；方法名 findAll 是自取的，真正执行的是 @Select 里的 SQL；desc 是倒序——本机实测的响应里咨询部（update_time 最新）排第一。PPT 上写的是 select *，课程工程写成明列四个字段，查询效果一样（* 会把所有列都查出来，包括以后新增的列）。注意：这样查出来的 createTime/updateTime 只有在驼峰开关开着时才有值。

• 2-2 写业务层：接口 + 实现类 需求：给”查询全部部门”配一个业务层——一个接口 + 一个实现类，实现类里调用上一题写好那个数据访问方法、把结果原样返回。要求这个实现类能被 Spring 管理（后面控制器才能注入它）。 （练习文件 test_58_查询部门接口.java 的题目2-2 里给了写作区。）

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

  一级 · 思路：接口负责”声明能力”，实现类负责”干活”；这次的活很简单，就是转手调 Mapper 二级 · 方法：实现类标 @Service 交给 Spring；用 @Autowired 注入上题的 Mapper；方法上加 @Override 三级 · 骨架：public interface DeptService { List<Dept> ____(); } ＋ @Service public class DeptServiceImpl implements DeptService { @Autowired private DeptMapper ____; @Override public List<Dept> findAll() { return ____.findAll(); } }

  参考答案（做完再点开）

  1
  public interface DeptService {
  2
      /**
  3
       * 查询所有部门
  4
       */
  5
      List<Dept> findAll();
  6
  }

  1
  @Service
  2
  public class DeptServiceImpl implements DeptService {
  3
  
  4
      @Autowired
  5
      private DeptMapper deptMapper;
  6
  
  7
      @Override
  8
      public List<Dept> findAll() {
  9
          return deptMapper.findAll();
  10
      }
  11
  }

  说明：实现类放在 service.impl 包里，接口放在 service 包（与课程工程一致）；@Service 是 38-39 篇学的 IOC 注解——不加它，Controller 里 @Autowired private DeptService deptService; 启动就会失败。这一层现在”看着多余”（纯透传），但它是分层的固定结构，后面新增部门要在这里补 createTime/updateTime，业务逻辑就写在这一层。

• 2-3 写控制层：把查询部门做成一个 HTTP 接口 需求：对外提供一个接口——浏览器（或 Apifox）用 GET 方式访问 /depts 时，返回统一响应结果，data 里装着部门集合。要求这个类能接收请求、调业务层、把结果包起来返回。 （练习文件 test_58_查询部门接口.java 的题目2-3 里给了写作区。）

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

  一级 · 思路：控制层只做三件事——接请求、调业务、包响应；方法的返回值类型就是统一响应结果类的类型 二级 · 方法：类上 @RestController；方法上 @GetMapping("/depts")；用 @Autowired 注入业务层接口；最后 return Result.success(deptList);（注意要带数据，不是无参的那个 success()） 三级 · 骨架：@RestController public class DeptController { @Autowired private DeptService ____; @GetMapping("____") public Result ____() { List<Dept> deptList = ____.findAll(); return ____; } }

  参考答案（做完再点开）

  1
  @RestController
  2
  public class DeptController {
  3
  
  4
      @Autowired
  5
      private DeptService deptService;
  6
  
  7
      @GetMapping("/depts")
  8
      public Result findAll(){
  9
          List<Dept> deptList = deptService.findAll();
  10
          return Result.success(deptList);
  11
      }
  12
  }

  说明：@RestController = @Controller + @ResponseBody，所以返回的 Result 对象会被自动转成 JSON；@GetMapping("/depts") 就是 Restful 里”GET 表示查询”的落地。课件代码把 /depts 提到类上的 @RequestMapping("/depts")、方法上只留 @GetMapping，访问地址同样是 GET /depts。本机实测响应：{"code":1,"msg":"success","data":[{"id":3,"name":"咨询部",…}]}——如果两个时间字段是 null，去看下一题的开关。

• 2-4 字段名与属性名对不上，把时间字段救回来 需求：数据库字段是 create_time、update_time，实体类属性是 createTime、updateTime，查询结果里两个时间字段是 null。请给出三种解法，并说明你选哪一种、为什么。 （练习文件 test_58_查询部门接口.java 的题目2-4 里给了写作区。）

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

  一级 · 思路：问题的本质是”名字没对上，MyBatis 不知道该把哪一列塞进哪个属性”；那就三条路——手工告诉它、让 SQL 里的名字变一致、让它自己按规则猜 二级 · 方法：手工告诉它用 @Results + @Result(column=…, property=…)；改名字用 SQL 别名；让它自己猜用 yml 里的驼峰开关 三级 · 骨架：① @Results({ @Result(column = "____", property = "____") }) ② select create_time ____ ③ mybatis.configuration.____: true

  参考答案（做完再点开）

  解法一 · 手动结果映射（写在 Mapper 方法上）：

  1
  @Results({
  2
      @Result(column = "create_time", property = "createTime"),
  3
      @Result(column = "update_time", property = "updateTime")
  4
  })
  5
  @Select("select id, name, create_time, update_time from dept order by update_time desc")
  6
  List<Dept> findAll();

  解法二 · 起别名（写进 SQL）：

  1
  @Select("select id, name, create_time createTime, update_time updateTime from dept order by update_time desc")
  2
  List<Dept> findAll();

  解法三 · 开驼峰命名开关（写在 application.yml）：

  1
  mybatis:
  2
    configuration:
  3
      map-underscore-to-camel-case: true

  我选第三种：它一行配置对整个工程生效，Mapper 和 SQL 一个字都不用改；而前两种每张表、每个方法都得写一遍，字段一多就容易漏。 补充两点：① 本机实测把这个开关改成 false，响应里 createTime/updateTime 立刻变成 null，改回 true 恢复正常——它就是这个问题的开关；② 开关的前提是字段名与属性名符合驼峰规则（xxx_abc → xxxAbc）；如果名字根本对不上（如 dname 对 deptName），还得回去用 @Results 或起别名。

三、综合题#

• 3-1 从零写出”查询部门”的三层代码，并用 Apifox 验证 这一题把本节从头到尾做一遍：只照接口文档，不抄代码——写完再用工具发请求，看响应对不对。

  1. 准备数据库：在 tlias 库里建 dept 表并插入 6 条数据（表结构见练习文件素材，update_time 要有先后差距，才能看出排序）；
  2. 写实体类：照接口文档响应里 data 内部的字段写一个对应类（属性名用驼峰、时间用 LocalDateTime）；
  3. 写数据访问层：查全部部门、按最后修改时间倒序；
  4. 写业务层：接口 + 实现类（实现类里调用第 3 步的方法）；
  5. 写控制层：对外提供 GET /depts，返回统一响应结果（data 里装部门集合）；
  6. 配置检查：确认 application.yml 里有数据源、MyBatis 的 SQL 日志、以及驼峰映射开关；启动工程；
  7. 用 Apifox（或 curl）发一个 GET 请求给 http://localhost:8080/depts，把响应的前两条数据抄下来，并回答下面三个问题：
     • 响应里部门是什么顺序？和数据库里 select * from dept 的顺序一样吗？为什么？
     • 把 yml 里的驼峰开关临时改成 false、重启，createTime/updateTime 变成什么？为什么？
     • 如果页面要展示”最后操作时间”，你打算用响应里的哪个字段？

  涉及知识点

  知识点	在这里的应用
  接口文档	第 2、5 步——请求方式与响应字段照文档来
  三层架构	第 3、4、5 步——Mapper/Service/Controller 各写各的，靠注入串起来
  Restful	第 5 步——GET /depts 表示”查询部门集合”
  排序 SQL	第 3、7 步——order by update_time desc 与响应顺序
  数据封装与驼峰开关	第 6、7 步——null 字段与开关实验

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

  一级 · 思路：从”数据”到”接口”倒着推——表 → 实体类 → Mapper（SQL）→ Service（透传）→ Controller（映射 + 包 Result）；最后用 Apifox 发 GET 请求看 JSON 二级 · 方法：建表用 int unsigned primary key auto_increment / varchar(10) not null unique / datetime；三层分别用 @Mapper+@Select、@Service+@Autowired、@RestController+@GetMapping；yml 里 spring.datasource 与 mybatis.configuration.map-underscore-to-camel-case 三级 · 骨架：DeptMapper.findAll() → DeptServiceImpl.findAll() → DeptController 的 @GetMapping("/depts") → Result.success(deptList)；Apifox 里新建请求、方法选 GET、URL 填 http://localhost:8080/depts、点”发送”

  参考答案（做完再点开）

  1. 建表 + 造数据：

  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');

  2. 实体类：

  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
  }

  3~5. 三层代码：与 2-1、2-2、2-3 的参考答案完全一致（Mapper 的 @Select("select id, name, create_time, update_time from dept order by update_time desc")、Service 透传、Controller 的 @GetMapping("/depts") 返回 Result.success(deptList)）。 6. yml（含两个 MyBatis 配置项）：

  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 的密码。）启动日志里能看到 Tomcat started on port 8080 (http)。 7. Apifox 的请求与响应：新建一个请求，方法选 GET、地址填 http://localhost:8080/depts、请求体留空，发送后拿到（本机实测）：

  1
  {"code":1,"msg":"success","data":[
  2
    {"id":3,"name":"咨询部","createTime":"2024-09-25T09:47:40","updateTime":"2024-09-30T21:26:24"},
  3
    {"id":6,"name":"行政部","createTime":"2024-11-30T20:56:37","updateTime":"2024-09-30T20:56:37"},
  4
    …
  5
  ]}

  三个问题的答案：

  • 顺序：咨询部（09-30）在最前，往后 update_time 越来越早——与 select * from dept 的存储顺序不一样（存储顺序里 1 号学工部在最前）。原因就是 SQL 最后那句 order by update_time desc。
  • 关掉驼峰开关（改 false 重启）后响应变成 {"id":3,"name":"咨询部","createTime":null,"updateTime":null}——字段 create_time 与属性 createTime 名字对不上、又没人告诉 MyBatis 怎么对应，就封装不上了（id/name 本来就一致，不受影响）。改回 true 即恢复。
  • 页面上的”最后操作时间” 用 updateTime（表里的 update_time），这也正是 SQL 按它排序的原因。