MyBatis 的动态 SQL 使用 OGNL 表达式
http://commons.apache.org/proper/commons-ognl/language-guide.html
在 XML 中的一些特殊字符需要转义,参考 HTML ISO-8859-1 手册
http://www.w3school.com.cn/tags/html_ref_entities.html
一、IF
https://www.cnblogs.com/jhxxb/p/10637219.html
<select id="selectMyUserByIF" resultType="myUser" parameterType="myUser">
select * from myuser where
<if test="id != null">
id = #{id}
</if>
<if test="name != null && name != """>
and name like #{name}
</if>
<if test="age == 0 or age == 1">
and age = #{age}
</if>
</select>
入参没有ID属性时会报错,会拼接成 where and,解决:可以在 where 后添加一个恒成立,如 1=1。或者使用 where 标签,会自动去除 SQL 中多出来的 and 或 or
二、WHERE
<select id="selectMyUserByIF" resultType="myUser" parameterType="myUser">
select * from myuser
<where>
<if test="id != null">
id = #{id}
</if>
<if test="name != null and name != ''.toString()">
and name like #{name}
</if>
<if test="age == 0 or age == 1">
and age = #{age}
</if>
</where>
</select>
where 标签只能去除第一个 and 或 or,所以不能把条件符号写多个或写在后面
三、SET
<update id="updateMyUser" parameterType="myUser">
update myuser
<!-- 用作更新 -->
<set>
<if test="name != null">
name = #{name},
</if>
<if test="age != null">
age = #{age}
</if>
</set>
where id = #{id}
</update>
四、TRIM
<select id="selectMyUserByIF" resultType="myUser" parameterType="myUser">
select * from myuser
<!-- prefix:替换拼接后字符串的前缀,单独使用则为添加。prefixOverrides:想替换的前缀类容(条件),单独使用则为删除
suffix:替换拼接后字符串的后缀,单独使用则为添加。suffixOverrides:想替换的后缀类容(条件),单独使用则为删除 -->
<trim prefix="where" prefixOverrides="AND | OR" suffixOverrides="and">
<if test="id != null">
id = #{id} and
</if>
<if test="name != null and name.trim() != ''">
name like #{name}
</if>
</trim>
</select>
trim 标签可以替代 where 标签
<!-- 等效于 where 标签 -->
<trim prefix="WHERE" prefixOverrides="AND |OR ">
...
</trim>
trim 标签也可以替代 set 标签
<!-- 等效于 set 标签 -->
<trim prefix="set" suffixOverrides=",">
...
</trim>
五、CHOOSE
<select id="selectMyUserByIF" resultType="myUser" parameterType="myUser">
select * from myuser
<where>
<!-- 类似于 if-else if-else 分支结构 -->
<choose>
<when test="id != null">
id = #{id}
</when>
<when test="name != null and name.trim() != ''">
name like #{name}
</when>
<otherwise>
age = 22
</otherwise>
</choose>
</where>
</select>
六、FOREACH
Map 入参
<!--public List<MyUser> selectMyUserByArray(Map<String,Object> maps);-->
<select id="selectMyUserByArray" resultType="myUser">
select * from myuser where id in
<!-- collection:指定要遍历的集合或数组(list 和 array 参数都会特殊处理封装在 Map 中,Map 的 key 默认为 list 或 array)
入参为单个 list 或 array 时 collection 值默认为 list 或 array,若接口方法指定了 @Param 注解,则为 @Param 的值
入参为多个参数可以封装为 Map,collection 值为 Map 中集合或数组对应的 key 的值(Map 的 key 最好为 String 类型)
open:给结果拼接一个前缀
close:给结果拼接一个后缀
item:集合中每一个元素在迭代时的别名,#{item} 取出变量的值,也就是当前遍历出的元素
separator:每个元素之间的分隔符
index:索引
遍历 list 或 arrays 时,index 是当前索引(下标),item 为索引对应的值
遍历 map 时 index 表示 map 的 key,item 为 map 的 value -->
<foreach collection="ids" item="item" index="index" separator="," open="(" close=")">
#{item}
</foreach>
</select>
测试代码
public static void main(String[] args) {
SqlSession session = null;
try {
InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
session = sqlSessionFactory.openSession(); MyUserMapper mapper = session.getMapper(MyUserMapper.class);
Map<String,Object> ids = new HashMap<>(10);
ids.put("ids",Arrays.asList(7,8,9,10));
ids.put("b",8);
System.out.println(mapper.selectMyUserByArray(ids));
} catch (IOException e) {
e.printStackTrace();
} finally {
if (session != null) {
session.close();
}
}
}
List 入参
<!--public List<MyUser> selectMyUserByArray(List<Integer> ids);-->
<select id="selectMyUserByArray" resultType="myUser">
select * from myuser where id in
<foreach collection="list" item="item" index="index" separator="," open="(" close=")">
#{item}
</foreach>
</select>
Array 入参
<!--public List<MyUser> selectMyUserByArray(Integer[] ids);-->
<select id="selectMyUserByArray" resultType="myUser">
select * from myuser
<foreach collection="array" item="item" index="index" separator="," open="where id in (" close=",20)">
#{item}
</foreach>
</select>
七、内置参数
<!-- 不只是方法传递过来的参数可以被用来判断和取值,mybatis 默认还有两个内置参数。
_parameter:代表整个参数
单个参数:_parameter 就是这个参数
多个参数:参数会被封装为一个 map,_parameter 就代表这个 map
_databaseId:如果配置了 databaseIdProvider 标签,_databaseId 代表当前数据库的别名 -->
<select id="selectMyUserById" resultType="myUser">
<if test="_databaseId == 'mysql'">
select * from myuser
<if test="_parameter != null">
where id = #{_parameter}
</if>
</if>
<if test="_databaseId == 'oracle'">
select * from oracle_myuser
<if test="_parameter != null">
where name = #{_parameter.name}
</if>
</if>
</select>
八、BIND
<select id="selectMyUserByNameLike" resultType="myUser" parameterType="string">
select * from myuser where name like #{name}
</select>
例 SQL 映射想变为模糊查询有几种方式
1.传入参数时加上 %
2.改用 ${name} 来取值。name 取值会报错,用 _parameter 取值
<select id="selectMyUserByNameLike" resultType="myUser">
select * from myuser where name like '%${_parameter}%'
</select>
3.使用 bind 标签
<select id="selectMyUserByNameLike" resultType="myUser">
<!-- bind:可以将OGNL表达式的值绑定到一个变量中,方便后来引用这个变量的值 -->
<bind name="_name" value="'%'+_parameter+'%'"/>
select * from myuser where name like #{_name}
</select>
九、SQL 复用
<!-- 抽取可重用的sql片段。方便后面引用,使用 include 标签来引用已经抽取的 sql
include 中可以自定义一些 property,sql 标签内部就能使用自定义的属性
include-property:取值用 ${prop}, 使用 #{prop} 不能取出,无法预编译 -->
<sql id="columnNames">
<if test="_databaseId=='mysql'">
${id},name,age
</if>
<if test="_databaseId=='oracle'">
xxx,xxx,xxx
</if>
</sql>
<select id="selectMyUserByNameLike" resultType="myUser" parameterType="string">
select
<include refid="columnNames">
<property name="id" value="id"/>
</include>
from myuser where name like #{name}
</select>
可以使用其他语言来写动态 SQL:MyBatis-Velocity、MyBatis-FreeMarker 和自带的 XML
http://www.mybatis.org/velocity-scripting/
http://www.mybatis.org/freemarker-scripting/