MyBatis 使用 POJO 参数动态查询教程

项目结构概览（基于图片描述）：

mybatis02
├─ src/main/java
│  └─ cn.cjxy
│     ├─ domain      # 实体类（如 Emp.java）
│     ├─ mapper      # Mapper 接口（如 EmpMapper.java）
│     └─ pojo        # 查询参数 POJO（如 QueryPojo.java）
├─ src/main/resources
│  ├─ cn.cjxy.mapper # XML 映射文件（如 EmpMapper.xml）
│  └─ mybatis-config.xml

---

一、POJO 参数定义

1.1 查询参数封装类 QueryPojo.java

package cn.cjxy.pojo;

import cn.cjxy.domain.Emp;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.AllArgsConstructor;

@Data
@NoArgsConstructor
@AllArgsConstructor
public class QueryPojo {
    private Emp emp;     // 嵌套对象（用于模糊查询名称）
    private Double start; // 薪资范围下限
    private Double end;   // 薪资范围上限
}

• Lombok 注解作用 ：
  • @Data：自动生成 getter/setter
  • @NoArgsConstructor：无参构造器
  • @AllArgsConstructor：全参构造器

---

二、Mapper 接口与 XML 映射配置

2.1 Mapper 接口方法 EmpMapper.java

List<Emp> findByPojo(QueryPojo pojo); // 接收 POJO 参数

2.2 XML 动态查询配置 EmpMapper.xml

<select id="findByPojo" resultType="cn.cjxy.domain.Emp">
    SELECT * FROM emp 
    WHERE 
        salary >= #{start} 
        AND salary <= #{end} 
        AND name LIKE #{emp.name} <!-- 访问嵌套对象属性 -->
</select>

• 关键点 ：
  • #{start} 和 #{end} 直接访问 QueryPojo 的成员变量
  • #{emp.name} 通过嵌套对象访问 Emp 的 name 属性

---

三、测试类实现

3.1 测试代码 Test01.java

@Test
public void testFindByPojo() throws IOException {
    // 1. 创建 Emp 对象并设置模糊查询条件
    Emp emp = new Emp();
    emp.setName("%小%");  // 包含"小"的任意位置

    // 2. 封装查询参数到 POJO
    QueryPojo pojo = new QueryPojo();
    pojo.setEmp(emp);
    pojo.setStart(6000.00);  // 薪资范围：6000~8000
    pojo.setEnd(8000.00);

    // 3. 执行查询
    List<Emp> empList = mapper.findByPojo(pojo);

    // 4. 输出结果
    empList.forEach(System.out::println);
}

3.2 执行流程

1. 参数构建 ：
   • 创建 Emp 对象，设置 name 为模糊查询条件 %小%
   • 将 Emp 对象及薪资范围封装到 QueryPojo
2. SQL 动态生成 ：
   • MyBatis 解析 #{emp.name} → 获取 emp.getName()
   • 最终生成 SQL：

SELECT * FROM emp 
WHERE 
    salary >= 6000.00 
    AND salary <= 8000.00 
    AND name LIKE '%小%'

---

四、核心优势与注意事项

4.1 优势

1. 参数集中管理 ：
   • 将散落的参数封装为对象，提高代码可读性
2. 支持复杂查询 ：
   • 可嵌套对象、集合等复杂结构
3. 动态 SQL 友好 ：
   • 结合 <if> 标签实现条件过滤：

<if test="start != null">
    AND salary >= #{start}
</if>

4.2 注意事项

1. 属性访问规则 ：
   • MyBatis 通过 getter 方法访问属性，需确保 QueryPojo 和 Emp 类有对应的 getter（或使用 Lombok）
2. 模糊查询语法 ：
   • 通配符 % 应在 Java 代码中设置（如 %小%），而非 XML 中拼接，避免 SQL 注入风险
3. 空值处理 ：
   • 若 emp 为 null，#{emp.name} 会抛出 NullPointerException，建议初始化对象：

public class QueryPojo {
    private Emp emp = new Emp(); // 防御性初始化
}

---

五、完整代码对照

文件	关键代码
QueryPojo.java	封装 Emp 对象及薪资范围
EmpMapper.java	List<Emp> findByPojo(QueryPojo pojo);
EmpMapper.xml	通过 #{start}, #{end}, #{emp.name} 动态拼接 SQL
Test01.java	构建 QueryPojo 参数并调用 Mapper 方法

---

六、扩展应用

1. 动态条件增强 ：
   结合 <where> 和 <if> 标签实现可选条件查询：

<select id="findByPojo" resultType="cn.cjxy.domain.Emp">
    SELECT * FROM emp 
    <where>
        <if test="start != null">AND salary >= #{start}</if>
        <if test="end != null">AND salary <= #{end}</if>
        <if test="emp.name != null">AND name LIKE #{emp.name}</if>
    </where>
</select>

2. 分页查询整合 ：
   在 QueryPojo 中添加 pageNum 和 pageSize 字段，结合 PageHelper 插件实现分页：

PageHelper.startPage(pojo.getPageNum(), pojo.getPageSize());
List<Emp> list = mapper.findByPojo(pojo);