MyBatis动态SQL教程

动态SQL是 MyBatis 中非常强大且灵活的功能，允许你根据不同的条件构建SQL查询。
这主要通过 <if>、<choose>、<when>、<otherwise>、<foreach>等标签实现。

查询场景

/**
 * 根据条件查询员工信息
 * @param emp
 * @return
 */
List<Emp> getEmpCondition(Emp emp);

if标签的使用

<if> 标签：该标签用于根据条件判断是否包含某段SQL片段。

<select id="getEmpCondition" resultType="com.evan.mybatis.entity.Emp">
	select * from t_emp where 1=1
	<if test="empName != null and empName != ''">
		and emp_name = #{empName}
	</if>
	<if test="age != null and age != ''">
		and age = #{age}
	</if>
	<if test="gender != null and gender != ''">
		and gender = #{gender}
	</if>
</select>

测试

@Test
public void test1() {
	SqlSession sqlSession = SqlSessionUtil.getSqlSession();
	EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
	Emp emp = new Emp();
	emp.setEmpName("李四");
	List<Emp> emps = mapper.getEmpCondition(emp);
	emps.forEach(System.out::println);
	sqlSession.close();
}

结论：if标签可通过test属性的表达式进行判断，若表达式的结果为true，则标签中的内容会执行；反之标签中的内容不会执行

where标签的使用

• 若where标签中的if条件都不满足，则where标签没有任何功能，即不会添加where关键字
• 若where标签中的if条件满足，则where标签会自动添加where关键字，并将条件前面多余的and或or去掉

注意：where标签不能去掉条件最后多余的and或or

<select id="getEmpCondition" resultType="com.evan.mybatis.entity.Emp">
        select * from t_emp
        <where>
            <if test="empName != null and empName !=''">
                emp_name = #{empName}
            </if>
            <if test="age != null and age != ''">
                and age = #{age}
            </if>
            <if test="gender != null and gender !=''">
                or gender = #{gender}
            </if>
        </where>
    </select>

测试

@Test
public void test1() {
	SqlSession sqlSession = SqlSessionUtil.getSqlSession();
	EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
	Emp emp = new Emp();
	emp.setEmpName("李四");
	emp.setAge(19);
	emp.setGender("女");
	List<Emp> emps = mapper.getEmpCondition(emp);
	emps.forEach(System.out::println);
	sqlSession.close();
}

trim标签的使用

trim用于去掉或添加标签中的内容，常用属性：

• prefix：在trim标签中内容的前面添加指定内容
• prefixOverrides：在trim标签中内容的前面去掉指定内容
• suffix：在trim标签中内容的后面添加指定内容
• suffixOverrides：在trim标签中内容的后面去掉指定内容

<select id="getEmpCondition" resultType="com.evan.mybatis.entity.Emp">
	select * from t_emp
	<trim prefix="where" suffixOverrides="and|or">
		<if test="empName != null and empName != ''">
			emp_name = #{empName} and
		</if>
		<if test="age != null and age != ''">
			age = #{age} or
		</if>
		<if test="gender != null and gender != ''">
			gender = #{gender}
		</if>
	</trim>
</select>

测试

@Test
public void test1() {
	SqlSession sqlSession = SqlSessionUtil.getSqlSession();
	EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
	Emp emp = new Emp(0,"李四",19,"男",null);
	List<Emp> emps = mapper.getEmpCondition(emp);
	emps.forEach(System.out::println);
	sqlSession.close();
}

choose、when、otherwise标签的使用

<choose>、<when>、<otherwise> 标签：这些标签类似于Java中的switch-case-default结构。
<choose>标签中的<when>标签表达式结果满足则条件拼接查询，否则在读多个<when>标签中继续判断，如都不满足，则执行<otherwise>标签内容。

注意：when至少有一个,otherwise最多设置一个

<select id="getEmpCondition" resultType="com.evan.mybatis.entity.Emp">
	select * from t_emp
	<where>
		<choose>
			<when test="empName != null and empName != ''">
				emp_name = #{empName}
			</when>
			<when test="age != null and age != ''">
				age = #{age}
			</when>
			<when test="gender != null and gender != ''">
				gender = #{gender}
			</when>
			<otherwise>
				gender = '女'
			</otherwise>
		</choose>
	</where>
</select>

测试

@Test
public void test1() {
	SqlSession sqlSession = SqlSessionUtil.getSqlSession();
	EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
	Emp emp = new Emp(0,null,0,"男",null);
	List<Emp> emps = mapper.getEmpCondition(emp);
	emps.forEach(System.out::println);
	sqlSession.close();
}

foreach标签的使用

场景1

方法形参为集合,实现批量添加操作。

/**
  * 批量添加
  * @param emps
  * @return
  */
int addEmp(@Param("emps") List<Emp> emps);

<insert id="addEmp">
	insert into t_emp(emp_name,age,gender,dept_id) values
	<foreach collection="emps" item="e" separator=",">
		(#{e.empName},#{e.age},#{e.gender},null)
	</foreach>
</insert>

测试

@Test
public void test2() {
	SqlSession sqlSession = SqlSessionUtil.getSqlSession();
	EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
	Emp emp1 = new Emp(0, "evan", 22, "女", null);
	Emp emp2 = new Emp(0, "allen", 23, "男", null);
	Emp emp3 = new Emp(0, "john", 24, "女", null);
	int result = mapper.addEmp(Arrays.asList(emp1, emp2, emp3));
	System.out.println("结果:" + result);
	sqlSession.close();
}

场景2:

形参为数组，实现批量删除操作。

/**
 * 批量删除
 * @param empNames
 * @return
 */
int removeEmp(@Param("empNames") String[] empNames);

• 方式1： 通过形参数组并且where条件为in()方式条件进行批量删除

<delete id="removeEmp">
	delete from t_emp where emp_name in
		(
			<foreach collection="empNames" item="e" separator=",">
				#{e}
			</foreach>
		)
</delete>

或

<delete id="removeEmp">
    delete from t_emp where emp_name in
        <foreach collection="empNames" separator="," item="e" open="(" close=")">
            #{e}
        </foreach>
</delete>

• 方式2： 通过形参数组并且where条件为or方式的模糊条件遍历

<delete id="removeEmp">
	delete from t_emp where 
	<foreach collection="empNames" item="item" separator="or">
		emp_name like '%${item}%'
	</foreach>
</delete>

sql标签的使用

sql标签，可以记录一段公共sql片段，在使用的地方通过include标签进行引入。

<!-- 公共sql语句 -->
<sql id="empColumns">emp_id,emp_name,age,gender,dept_id</sql>

<select id="getEmpCondition" resultType="com.evan.mybatis.entity.Emp">
        select <include refid="empColumns"/> from t_emp
        <where>
            <choose>
                <when test="empName != null and empName != ''">
                    emp_name = #{empName}
                </when>
                <when test="age != null and age != ''">
                    age = #{age}
                </when>
                <when test="gender != null and gender != ''">
                    gender = #{gender}
                </when>
                <otherwise>
                    gender = '女'
                </otherwise>
            </choose>
        </where>
</select>