1 动态 SQL 语句-更复杂的查询业务需求
1.1 动态 SQL-官方文档
(1)文档地址: mybatis – MyBatis 3 | 动态 SQL
(2)为什么需要动态 SQL
- 动态 SQL 是 MyBatis 的强大特性之一
- 使用 JDBC 或其它类似的框架,根据不同条件拼接 SQL 语句非常麻烦,例如拼接时要确保不能忘记添加必要的空格,还要注意去掉列表最后一个列名的逗号等
- SQL 映射语句中的强大的动态 SQL 语言, 可以很好的解决这个问题
1.2 动态 SQL-基本介绍
- 在一个实际的项目中,sql 语句往往是比较复杂的
- 为了满足更加复杂的业务需求,MyBatis 的设计者,提供了动态生成 SQL 的功能。
动态 SQL 必要性
- 比如我们查询Monster 时,如果程序员输入的age 不大于0, 我们的sql语句就不带age 。
- 更新 Monster 对象时,没有设置的新的属性值,就保持原来的值,设置了新的值,才更新
解决方案分析
- 从上面的需求我们可以看出,有时我们在生成 sql 语句时,在同一个方法中,还要根据 不同的情况生成不同的 sql 语句
- 解决方案: MyBatis 提供的动态 SQL 机制
动态 SQL 常用标签
动态 SQL 提供了如下几种常用的标签,类似我们 Java 的控制语句:
(1)if [判断]
(2)where [拼接 where 子句]
(3)choose/when/otherwise [类似 java 的 switch 语句, 注意是单分支]
(4)foreach [类似 in ]
(5)trim [替换关键字/定制元素的功能]
(6)set [在 update 的 set 中,可以保证进入 set 标签的属性被修改,而没有进入 set 的,保持原来的值]
1.3 动态 SQL-案例演示
1.3.1 新建 Module dynamic-sql
(1)在原来的项目中,新建 dynamic-sql 模块演示动态 SQL 的使用
(2)新建 Module 后,先创建需要的包,再将需要的文件/资源拷贝过来(这里我们拷贝 Monster.java、resources/jdbc.properties 和 mybatis-config.xml)
(3)创建 MonsterMapper.java MonsterMapper.xml 和 MonsterMapperTest.java
1.3.2 if 标签应用实例
需求:请查询 age 大于 10 的所有妖怪,如果程序员输入的 age 不大于 0, 则输出所有 的妖怪
代码实现
(1)修改 MonsterMapper.java ,增加接口方法
//根据age查询结果
public List<Monster> findMonsterByAge(@Param(value = "age") Integer age);
(2)修改 MonsterMapper.xml,sql实现
<!--
1. 配置方法public List<Monster> findMonsterByAge(@Param(value="age") Integer age);
2. 请查询age 大于 10 的所有妖怪,如果程序员输入的age 不大于 0, 则输出所有的妖怪
3. 如果使用原来的#{age} 在test表达式是取不出入参值
4. 解决方案是使用@Param
-->
<select id="findMonsterByAge" parameterType="int" resultType="monster">
select * from `monster` where 1 = 1
<if test="age >= 0">
and `age` > ${age}
</if>
</select>
(3)修改 MonsterMapperTest.java 增加测试方法
@Test
public void findMonsterByAge() {
List<Monster> monsters =
monsterMapper.findMonsterByAge(-1);
for (Monster monster : monsters) {
System.out.println("monster--" + monster);
}
if (sqlSession != null) {
sqlSession.close();
}
System.out.println("操作成功~");
}
测试效果
1.3.3 where 标签应用实例
需求:查询 id 大于 20 的,并且名字包含 "狐狸精" 的所有妖怪, 如果名字为空 , 就不带名字条件, 如果输入的 id 小于 0, 就不带 id 的条件
(1)修改 MonsterMapper.java ,增加接口方法
//根据id和名字来查询结果
public List<Monster> findMonsterByIdAndName(Monster monster);
(2)修改 MonsterMapper.xml,sql实现
<!--
1、配置public List<Monster> findMonsterByIdAndName(Monster monster);
2. 如果我们入参是对象,test表达式中, 直接使用对象的属性名即可
3. where标签,会在组织动态sql时,加上where
4. mybatis底层自动的去掉多余的AND
-->
<select id="findMonsterByIdAndName" parameterType="monster" resultType="monster">
select * from `monster`
<where>
<if test="age >= 0">
`age` > #{age}
</if>
<if test="name != null and name != ''">
and `name` like '%${name}%'
</if>
</where>
</select>
(3)修改 MonsterMapperTest.java 增加测试方法
@Test
public void findMonsterByIdAndName(){
Monster monster = new Monster();
monster.setAge(20);
monster.setName("狐狸精");
List<Monster> monsters =
monsterMapper.findMonsterByIdAndName(monster);
for (Monster o : monsters) {
System.out.println("monster--" + o);
}
if (sqlSession != null){
sqlSession.close();
}
System.out.println("操作成功~");
}
测试效果
1.3.4 choose/when/otherwise 应用实例
需求:如果给的 name 不为空,就按名字查询妖怪,name 为空并且 id>0,就按 id 来查询妖怪, 如果name 为空 并且 id<0,则以 id > 10 为查询条件。要求使用 choose/when/otherwise 标签实现, 传入参数要求使用 Map
(1)修改 MonsterMapper.java ,增加接口方法
//测试choose标签的使用
public List<Monster> findMonsterByIdOrName_choose(Map<String, Object> map);
(2)修改 MonsterMapper.xml,sql实现
<!--
1、配置/实现public List<Monster> findMonsterByIdOrName_choose(Map<String, Object> map)
2、 1) 如果给的name不为空,就按名字查询妖怪,
2) 如果指定的id>0,就按id来查询妖怪
3) 如果前面两个条件都不满足, 就默认查询 `age` > 10的
4) 使用mybatis 提供choose-when-otherwise
-->
<select id="findMonsterByIdOrName_choose" parameterType="map" resultType="monster">
select * from `monster`
<where>
<choose>
<when test="name != null and name != ''">
`name` like '%${name}%'
</when>
<when test="age >= 0">
`age` > #{age}
</when>
<otherwise>
`age` > 10
</otherwise>
</choose>
</where>
</select>
(3)修改 MonsterMapperTest.java 增加测试方法
@Test
public void findMonsterByIdOrName_choose(){
HashMap<String, Object> map = new HashMap<>();
map.put("age",-1);
map.put("name","");
List<Monster> monsters =
monsterMapper.findMonsterByIdOrName_choose(map);
for (Monster o : monsters) {
System.out.println("monster--" + o);
}
if (sqlSession != null){
sqlSession.close();
}
System.out.println("操作成功~");
}
测试效果
1.3.5 forEach 标签应用实例
forEach 标签说明:可以将任何可迭代对象(如 List、Set 等)、Map 对象或者数组对象作为集合参数传递给 foreach。当使用可迭代对象或者数组时,index 是当前迭代的序号,item 的值是本次迭代获取到的元素。当使用 Map 对象(或者 Map.Entry 对象的集合)时,index 是键,item 是值。
需求:查询 monster_id 为 20, 22, 34 的妖怪
(1)修改 MonsterMapper.java ,增加接口方法
//测试foreach的标签使用
public List<Monster> findMonsterById_forEach(Map<String, Object> map)
(2)修改 MonsterMapper.xml,sql实现
<!--
1、配置/实现public List<Monster> findMonsterById_forEach(Map<String, Object> map);
2、查询id 为 5, 6, 7 的妖怪
3、是foreach标签
4. 入参map 中 会如何传入id值 k-v ids - [集合,比如List 10,12,14], 即
map 入参中应当有 ids-[10,12,14]
-->
<select id="findMonsterById_forEach" parameterType="map" resultType="monster">
select * from `monster`
<!-- 解读
3. 如果ids不为空,则使用foreach标签进行遍历
4. collection="ids" 对应入参map的 key 为 ids
5. item="id" 在遍历ids集合时,每次取出的值,对应的变量id
6. open="where id in (" 表示开头的字符串
7. separator="," 遍历出来的多个值之间的 分隔符号
8. close=")" 表示结尾的字符串
9. #{id} 对应的就是 item="id",即遍历出来的值
-->
<if test="ids != null and ids != ''">
<foreach collection="ids" index="" item="id" open="where id in ("
separator="," close=")">
#{id}
</foreach>
</if>
</select>
(3)修改 MonsterMapperTest.java 增加测试方法
@Test
public void findMonsterById_forEach() {
Map<String, Object> map = new HashMap<>();
map.put("ids", Arrays.asList(5, 6, 7));
List<Monster> monsters =
monsterMapper.findMonsterById_forEach(map);
for (Monster monster : monsters) {
System.out.println("monster--" + monster);
}
if (sqlSession != null) {
sqlSession.close();
}
System