问题：参数还会继续加（PPT 第 59-60 页）#

PPT 第 60 页把理由说得很清楚：

如果 controller 方法的参数较多，且未来可能继续增加，这会使得方法签名变得复杂难以维护，此时可以考虑将多个请求参数封装为一个对象。

想一想也是：员工列表要 6 个参数，以后按”职位""薪资范围”查还要再加；参数一个个排在方法签名上，方法头比方法体还长，调 Service 时还要一个个按顺序传——顺序传错一个就是隐藏的 bug。

方案：EmpQueryParam（PPT 第 60 页）#

PPT 第 60 页给的方案是一个专门装”查询参数”的类：

1
@Data
2
public class EmpQueryParam {
3
    private Integer page = 1; // 当前页码
4
    private Integer pageSize = 10; // 每页记录数
5
    private String name; // 员工姓名
6
    private Integer gender; // 员工性别
7
    @DateTimeFormat(pattern = "yyyy-MM-dd")
8
    private LocalDate begin; // 入职日期
9
    @DateTimeFormat(pattern = "yyyy-MM-dd")
10
    private LocalDate end; // 入职日期
11
}

控制层随之简化成”一个参数”：

1
@GetMapping
2
public Result page(EmpQueryParam empQueryParam){
3
    log.info("分页查询，参数：{}", empQueryParam);
4
    PageResult<Emp> pageResult = empService.page(empQueryParam);
5
    return Result.success(pageResult);
6
}

对照改造前的版本，有三处变化值得注意：

1. 参数变成一个对象：page(EmpQueryParam empQueryParam)——以后加条件只在类里加字段，方法签名不动；
2. 默认值搬家了：page/pageSize 的默认值从 @RequestParam(defaultValue = …) 挪到了字段的初始值（private Integer page = 1;）——对象接收时没有 defaultValue 可用，就在字段上直接给默认值，效果一样（不传就是 1 和 10）；
3. @DateTimeFormat 也搬家了：日期格式注解挪到字段上，照样生效。

为什么 Spring 能把 URL 上的参数装进这个对象？ 因为 EmpQueryParam 是一个普通的 POJO，里面的属性名（page、pageSize、name、gender、begin、end）和 queryString 的 key 一一对应，Spring MVC 会自动按名字把参数值塞进对应的属性里——33 篇讲的”POJO 参数”就是这种用法。

Service 那边的签名也跟着简化（page(EmpQueryParam empQueryParam)），实现里把分页参数从对象里取出来：

1
@Override
2
public PageResult<Emp> page(EmpQueryParam empQueryParam) {
3
    //1. 设置分页参数(PageHelper)
4
    PageHelper.startPage(empQueryParam.getPage(), empQueryParam.getPageSize());
5

6
    //2. 执行查询
7
    List<Emp> empList = empMapper.list(empQueryParam);
8

9
    //3. 解析查询结果，并封装
10
    Page<Emp> p = (Page<Emp>) empList;
11
    return new PageResult<Emp>(p.getTotal(), p.getResult());
12
}

（数据访问层的方法也变成 List<Emp> list(EmpQueryParam empQueryParam);——SQL 里要用哪个条件，就从对象的属性里取，见下一节。）

必答问答（PPT 第 61 页）#

动态 SQL 是什么（PPT 第 63 页）#

PPT 第 63 页给出了定义和两个标签：

随着用户的输入或外部条件的变化而变化的 SQL 语句，我们称为动态 SQL。

• <if>：判断条件是否成立，如果条件为 true，则拼接 SQL。
• <where>：根据查询条件，来生成 where 关键字，并会自动去除条件前面多余的 and 或 or。

两个标签各管一件事，配合起来正好解决”条件个数不固定”：

PPT 第 63 页给了一小段示例，重点是那个 test 属性：

1
<if test="gender != null">
2
    and e.gender = #{gender}
3
</if>

test 里写的是判断表达式（gender != null 表示”性别这个参数有值”）——有值才拼 and e.gender = ?，没值就整段跳过。

改造后的完整 XML（课程最终版）#

把 55 篇的三条规则和上面两个标签合起来，EmpMapper.xml 的最终写法是（课程 05. 最终代码 里就是这个）：

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.EmpMapper">
6

7
    <select id="list" resultType="com.itheima.pojo.Emp">
8
        select e.*, d.name deptName from emp e left join dept d on e.dept_id = d.id
9
        <where>
10
            <if test="name != null and name != ''">
11
                e.name like concat('%',#{name},'%')
12
            </if>
13
            <if test="gender != null">
14
                and e.gender = #{gender}
15
            </if>
16
            <if test="begin != null and end != null">
17
                and e.entry_date between #{begin} and #{end}
18
            </if>
19
        </where>
20
        order by e.update_time desc
21
    </select>
22

23
</mapper>

逐条对照着看：

1
# 带姓名 + 性别条件（/emps?name=李&gender=1&page=1&pageSize=5）
2
==>  Preparing: SELECT count(0) FROM emp e LEFT JOIN dept d ON e.dept_id = d.id WHERE e.name LIKE concat('%', ?, '%') AND e.gender = ?
3
==>  Preparing: select e.*, d.name deptName from emp e left join dept d on e.dept_id = d.id
4
                 WHERE e.name like concat('%', ?, '%') and e.gender = ? order by e.update_time desc LIMIT ?
5

6
# 一个条件都不带（/emps?page=2&pageSize=5）
7
==>  Preparing: SELECT count(0) FROM emp e LEFT JOIN dept d ON e.dept_id = d.id
8
==>  Preparing: select e.*, d.name deptName from emp e left join dept d on e.dept_id = d.id
9
                 order by e.update_time desc LIMIT ?, ?

联调时的中文坑（本机实测）#

条件参数里有中文（姓名），联调时特别容易踩一个坑，顺手记在这里：

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

1. 条件分页查询的条件：name（姓名）、gender（性别）、begin/end（入职日期范围），接口文档里四个都是”否”（可以不填）
2. 三层职责的变化：Controller 接收参数（分页 + 条件）；Service 用 PageHelper 完成分页条件查询并封装 PageResult；Mapper 的 SQL 里带上条件
3. 日期参数：LocalDate 类型 + @DateTimeFormat(pattern = "yyyy-MM-dd")——不指定格式，2007-09-01 这样的字符串转不成日期；格式要和前端传的一致
4. 两个注解的使用场景：@RequestParam 用于参数名不一致时指定名字、以及用 defaultValue 设置默认值；@DateTimeFormat 用于接收日期时间类型参数并指定日期格式
5. SQL 为什么进 XML：SQL 长、连表、要动态变化——用 XML（同包同名、namespace 是接口全限定名、id 是方法名、resultType 是单条记录类型）
6. 请求参数封装：参数多且会继续增加 → 封装成 EmpQueryParam（@Data）；默认值写在字段上（page = 1、pageSize = 10）；@DateTimeFormat 也挪到字段上；queryString 参数少用形参、多用对象
7. 条件写死的问题：用户没填的参数是 null，字段 = null 永远不成立 → 查不出数据；条件组合太多，不可能每种都写一个方法
8. 动态 SQL 定义与两个标签：动态 SQL 是随着用户的输入或外部条件的变化而变化的 SQL 语句；<if test="…"> 条件成立才拼接 SQL 片段；<where> 生成 where 关键字并去掉多余的 and/or；无条件时连 where 都不生成（本机实测日志可证）
9. 本机实测的两个数：带日期条件（2007-09-01 ~ 2022-09-01）时 total 是 20；不带条件时 total 是 30
10. 中文条件的坑：Windows 命令行 curl 发中文按 GBK → 服务端收到 ??、total 0；URL 编码后（?name=%E6%9D%8E）正常返回 total 6 条

二、裸写题#

• 2-1 让控制层能接收”分页 + 条件”六个参数 需求：员工列表接口要接收这些东西——页码、每页记录数（不传时默认第 1 页、每页 10 条），姓名（可以不填）、性别（可以不填）、入职日期的开始和结束（可以不填，前端传的是 2007-09-01 这样的字符串）。要求这些参数能正确接收，日期参数不能报类型转换错误。 （练习文件 test_68_条件分页与动态SQL.java 的题目2-1 里给了写作区。）

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

  一级 · 思路：六个形参排一排——两个分页参数要默认值，两个简单条件直接收，两个日期要告诉 Spring 按什么格式解析 二级 · 方法：分页参数用 @RequestParam(defaultValue = …)；姓名用 String、性别用 Integer；日期用 LocalDate + @DateTimeFormat(pattern = "yyyy-MM-dd")；方法里先用 log.info 打印参数，再调 Service 三级 · 骨架：@GetMapping public Result page(@RequestParam(defaultValue = "1") Integer page, @RequestParam(defaultValue = "10") Integer pageSize, String name, Integer gender, @DateTimeFormat(pattern = "yyyy-MM-dd") LocalDate begin, @DateTimeFormat(pattern = "yyyy-MM-dd") LocalDate end) { log.info(…); PageResult<Emp> pageResult = empService.page(…); return Result.success(pageResult); }

  参考答案（做完再点开）

  1
  @GetMapping
  2
  public Result page(@RequestParam(defaultValue = "1") Integer page,
  3
                     @RequestParam(defaultValue = "10") Integer pageSize,
  4
                     String name, Integer gender,
  5
                     @DateTimeFormat(pattern = "yyyy-MM-dd") LocalDate begin,
  6
                     @DateTimeFormat(pattern = "yyyy-MM-dd") LocalDate end){
  7
      log.info("分页查询，参数：{}，{}，{}，{}，{}，{}", page, pageSize, name, gender, begin, end);
  8
      PageResult<Emp> pageResult = empService.page(page, pageSize, name, gender, begin, end);
  9
      return Result.success(pageResult);
  10
  }

  说明：name/gender 不加注解也能收（形参名和 queryString 的 key 一致）；两个日期参数必须有 @DateTimeFormat，否则 2007-09-01 转不成 LocalDate，请求直接失败。日志那一行六个 {} 要按顺序对上实参——联调时先看它，能立刻确认”条件到底传进来没有”。

• 2-2 把六个请求参数封装成一个对象接收 需求：控制层方法的参数已经有六个，以后还可能加（职位、薪资范围……），方法签名越来越难维护。请把这一批请求参数封装成一个对象来接收，要求：页码和每页记录数不传时仍有默认值（1 和 10）、日期参数照样能按 2007-09-01 的格式解析；控制层方法体里的日志和 Service 调用也要跟着改。 （练习文件 test_68_条件分页与动态SQL.java 的题目2-2 里给了写作区。）

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

  一级 · 思路：建一个 POJO 装这六个参数，属性名和 queryString 的 key 一模一样；默认值从”注解”搬到”字段初始值” 二级 · 方法：类名 EmpQueryParam，标 @Data；page = 1、pageSize = 10 直接写字段初始值；@DateTimeFormat(pattern = "yyyy-MM-dd") 标在 begin/end 字段上；控制层改成 page(EmpQueryParam empQueryParam) 三级 · 骨架：@Data public class EmpQueryParam { private Integer page = 1; private Integer pageSize = 10; private String name; private Integer gender; @DateTimeFormat(pattern = "yyyy-MM-dd") private LocalDate begin; @DateTimeFormat(pattern = "yyyy-MM-dd") private LocalDate end; } ＋ @GetMapping public Result page(EmpQueryParam empQueryParam){ log.info("分页查询，参数：{}", empQueryParam); PageResult<Emp> pageResult = empService.page(empQueryParam); return Result.success(pageResult); }

  参考答案（做完再点开）

  1
  @Data
  2
  public class EmpQueryParam {
  3
      private Integer page = 1; // 当前页码
  4
      private Integer pageSize = 10; // 每页记录数
  5
      private String name; // 员工姓名
  6
      private Integer gender; // 员工性别
  7
      @DateTimeFormat(pattern = "yyyy-MM-dd")
  8
      private LocalDate begin; // 入职日期
  9
      @DateTimeFormat(pattern = "yyyy-MM-dd")
  10
      private LocalDate end; // 入职日期
  11
  }

  1
  @GetMapping
  2
  public Result page(EmpQueryParam empQueryParam){
  3
      log.info("分页查询，参数：{}", empQueryParam);
  4
      PageResult<Emp> pageResult = empService.page(empQueryParam);
  5
      return Result.success(pageResult);
  6
  }

  说明：Spring 能自动把 URL 上的参数装进这个对象，靠的是属性名与参数名一致（?name=张 → name 属性）。两处容易忘：① 默认值要写在字段上（对象接收没有 defaultValue 可用）；② @DateTimeFormat 也要跟着挪到字段上。以后加条件只在类里加字段，控制层方法一个字都不用改——这就是封装的收益。

• 2-3 在 XML 里写一条”条件写死”的多表条件查询 SQL 需求：员工列表要按姓名（模糊匹配）、性别（精确匹配）、入职日期范围（含头含尾）查询，同时带出部门名称，结果按最后修改时间倒序。请把这条 SQL 写进 XML 映射文件里，并说明文件该放在哪、namespace 和 id 该写什么。 （练习文件 test_68_动态SQL配置.xml 的题目2-3 里给了写作区。）

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

  一级 · 思路：先想 SQL 本身（连表 + 三个条件 + 排序），再套 XML 的外壳（55 篇的三条规则） 二级 · 方法：文件放 src/main/resources/com/itheima/mapper/EmpMapper.xml（与接口同包同名）；<mapper namespace="com.itheima.mapper.EmpMapper">；<select id="list" resultType="com.itheima.pojo.Emp">；模糊匹配用 like concat('%',#{name},'%')，范围用 between #{begin} and #{end}，别名用 d.name deptName 三级 · 骨架：<?xml version="1.0" encoding="UTF-8" ?> + <!DOCTYPE mapper …> + <mapper namespace="____"> <select id="____" resultType="____"> select e.*, d.name deptName from emp e left join dept d on e.dept_id = d.id where ____ </select> </mapper>

  参考答案（做完再点开）

  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.EmpMapper">
  6
  
  7
      <select id="list" resultType="com.itheima.pojo.Emp">
  8
          select e.*, d.name deptName from emp e left join dept d on e.dept_id = d.id
  9
          where e.name like concat('%',#{name},'%') and e.gender = #{gender} and e.entry_date between #{begin} and #{end}
  10
          order by e.update_time desc
  11
      </select>
  12
  
  13
  </mapper>

  说明：文件放 src/main/resources/com/itheima/mapper/EmpMapper.xml（与 EmpMapper 接口”同包同名”）；namespace 是接口全限定名 com.itheima.mapper.EmpMapper；语句 id="list" 与接口方法名一致；resultType 写单条记录的类型（接口返回 List<Emp>，这里还是写 com.itheima.pojo.Emp）。这条 SQL 跑起来”看起来”没问题——只要三个条件都填。下一题就来看它的毛病。

• 2-4 把上面那条 SQL 改成动态 SQL 需求：上面那条 SQL 的条件是写死的——用户只填姓名、不填性别和日期时，一行数据都查不出来。请把它改成”用户填了哪个条件就按哪个条件查，一个条件都不填就查全部”，并说明两个标签各自解决了什么问题。 （练习文件 test_68_动态SQL配置.xml 的题目2-4 里给了写作区。）

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

  一级 · 思路：每个条件都用”有没有值”包起来；where 关键字和多余的 and 交给标签去管 二级 · 方法：每个条件外面套 <if test="…">（字符串要同时判 != null 和 != ''；日期范围两个参数都有值才拼）；外面套 <where>；order by 放在 <where> 外面 三级 · 骨架：<where> <if test="name != null and name != ''"> e.name like concat('%',#{name},'%') </if> <if test="gender != null"> and e.gender = #{gender} </if> <if test="begin != null and end != null"> and e.entry_date between #{begin} and #{end} </if> </where> order by e.update_time desc

  参考答案（做完再点开）

  1
  <select id="list" resultType="com.itheima.pojo.Emp">
  2
      select e.*, d.name deptName from emp e left join dept d on e.dept_id = d.id
  3
      <where>
  4
          <if test="name != null and name != ''">
  5
              e.name like concat('%',#{name},'%')
  6
          </if>
  7
          <if test="gender != null">
  8
              and e.gender = #{gender}
  9
          </if>
  10
          <if test="begin != null and end != null">
  11
              and e.entry_date between #{begin} and #{end}
  12
          </if>
  13
      </where>
  14
      order by e.update_time desc
  15
  </select>

  显示更多显示更少

  两个标签解决的问题：<if> 让”填了的条件才拼进 SQL”——没填的条件整段消失（不是拼成 = null）；<where> 负责生成 where 关键字、并去掉第一个条件前多余的 and（所以后两个条件都写 and、第一个不写也能拼对），一个条件都没有时连 where 都不生成。本机实测的日志正是这样：带姓名 + 性别时 WHERE e.name LIKE concat('%', ?, '%') AND e.gender = ?，不带条件时 … d.id order by …（连 where 都没有），两种情况都能正常返回数据。

三、综合题#

• 3-1 给员工列表加上条件分页查询，并用日志和实测把三个问题回答清楚 这一题把本节从头到尾做一遍：先按”条件写死”跑通，再改成动态 SQL，最后用实测数据回答”动态 SQL 到底做了什么”。

  1. 控制层：接收分页参数（默认 1 和 10）+ 姓名/性别/入职日期范围（日期按 yyyy-MM-dd 解析）；
  2. 数据访问层：把 SQL 写进 XML（同包同名、namespace 与 id 按 55 篇的规则），先写条件写死的版本；
  3. 业务层：用分页插件完成分页（67 篇的做法），把分页参数从请求对象里取出来；
  4. 启动工程，先用”三个条件都填”的请求验证接口能查出数据（/emps?name=李&gender=1&begin=2007-09-01&end=2022-09-01&page=1&pageSize=5），记下 total 和 rows 的条数；
  5. 再发一个”只填日期范围”的请求（/emps?begin=2007-09-01&end=2022-09-01&page=1&pageSize=5），观察返回的 total——为什么它和刚才不一样？ 如果只填姓名、其余空着，会发生什么？
  6. 把 XML 改成”按需拼接条件”的动态 SQL，重启后再发一个什么条件都不带的请求（/emps?page=1&pageSize=10），把服务端日志里那条 SQL 抄下来——注意里面有没有 where；
  7. 用 Apifox（不要用 Windows 命令行的 curl 直接传中文）发一个带中文姓名的请求（比如 name=李），记录 total；再回答：为什么命令行 curl 传中文会查不到数据、该怎么处理？
  8. 最后回答三个问题：
     • 为什么”条件写死”的 SQL 在用户只填部分条件时查不出数据？
     • <if> 和 <where> 各解决了什么问题？
     • 动态 SQL 改完之后，分页还正常吗？从日志里哪里能看出来？

  涉及知识点

  知识点	在这里的应用
  参数接收（queryString）	第 1 步——简单参数直接收、日期用 @DateTimeFormat 指定格式
  请求参数封装	第 1、3 步——EmpQueryParam 装六个参数，默认值写在字段上
  XML 映射配置	第 2 步——同包同名、namespace、id、resultType
  PageHelper 分页	第 3、5、8 步——startPage + 解析 Page，日志里看 LIMIT
  动态 SQL（<if>/<where>）	第 6、7、8 步——条件按需拼接、无条件时不生成 where
  联调与编码	第 7 步——中文参数的 URL 编码

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

  一级 · 思路：先”能查出数据”（条件都填），再故意”少填条件”制造问题，然后用动态 SQL 修掉它——每一步都用日志和 total 做证据 二级 · 方法：@DateTimeFormat(pattern = "yyyy-MM-dd")；XML 里 like concat('%',#{name},'%') / between #{begin} and #{end}；动态 SQL 用 <where> 包 <if test="…">；请求用 Apifox 或对中文做 URL 编码 三级 · 骨架：控制层 page(EmpQueryParam empQueryParam) → 业务层 PageHelper.startPage(…) + empMapper.list(empQueryParam) → XML 的 <where> + 三个 <if>；对比观察点：日志里 WHERE 后拼了哪些条件、LIMIT 的参数是几、total 是 20 还是 30

  参考答案（做完再点开）

  1~3. 三个文件：控制层与 EmpQueryParam 见 2-1、2-2 的参考答案；XML 见 2-4 的参考答案；业务层：

  1
  @Override
  2
  public PageResult<Emp> page(EmpQueryParam empQueryParam) {
  3
      //1. 设置分页参数(PageHelper)
  4
      PageHelper.startPage(empQueryParam.getPage(), empQueryParam.getPageSize());
  5
      //2. 执行查询
  6
      List<Emp> empList = empMapper.list(empQueryParam);
  7
      //3. 解析查询结果，并封装
  8
      Page<Emp> p = (Page<Emp>) empList;
  9
      return new PageResult<Emp>(p.getTotal(), p.getResult());
  10
  }

  4. 三个条件都填（本机实测）：/emps?name=李&gender=1&begin=2007-09-01&end=2022-09-01&page=1&pageSize=5 能查出数据，日志里 WHERE 后面是 e.name like concat('%', ?, '%') and e.gender = ? and e.entry_date between ? and ?——三个条件都在。 5. 只填日期范围（本机实测）：/emps?begin=2007-09-01&end=2022-09-01&page=1&pageSize=5 返回 total 为 20、rows 5 条；它和不带条件时（total 为 30）不一样，因为多了一个日期范围限制，符合条件的员工变少了。而如果条件写死、只填姓名、性别和日期空着，SQL 里的 e.gender = null 和 e.entry_date between null and null 永远不成立，结果是一行都查不出来——这就是必须改成动态 SQL 的原因。 6. 改成动态 SQL 后的无条件请求（本机实测）：

  1
  ==>  Preparing: SELECT count(0) FROM emp e LEFT JOIN dept d ON e.dept_id = d.id
  2
  ==>  Preparing: select e.*, d.name deptName from emp e left join dept d on e.dept_id = d.id
  3
                   order by e.update_time desc LIMIT ?, ?

  SQL 里没有 where（… d.id order by … 直接接排序）——<where> 标签发现一个 <if> 都没成立，就没生成 where 关键字；这正是动态 SQL 生效的证据。 7. 中文条件：用 Apifox 发 name=李 能正常返回（本机实测：把中文做 URL 编码后 ?name=%E6%9D%8E 返回 total 6 条）；而 Windows 命令行里 curl --get --data-urlencode "name=张" 会把中文按 GBK 发出去，服务端日志里参数变成 ??、total 为 0。处理办法：先把中文做 URL 编码再传，或者干脆用 Apifox / 浏览器 / 前端页面发请求（它们会自动编码）。 8. 三个问题的答案：

  • 条件写死时，没填的条件参数是 null，而 SQL 里 字段 = null（或 between null and null）永远不成立，所以整个 where 条件都为假，一行都查不出来。
  • <if> 解决”条件个数不固定”：填了的条件才拼进 SQL，没填的整段消失；<where> 解决”where 关键字和 and 的摆放”：自动生成 where、去掉多余的 and/or，一个条件都没有时连 where 都不生成。
  • 分页照常工作：动态 SQL 管的是 where 那一段，PageHelper 管的是在 SQL 末尾加 LIMIT，两者互不干扰——日志里 … order by e.update_time desc LIMIT ?, ?（第 2 页时参数是 5, 5）就是证据；返回的 total 也仍然是”符合当前条件的总记录数”。