mybatis sql常用标签，Mybatis系列-5-动态SQL
mybatis sql常用标签，Mybatis系列-5-动态SQL<select id="findProInfoTestIf" parameterType="com.shpe.chapter3.entity.ProductInfo" resultType="com.shpe.chapter3.entity.ProductInfo"> select * from product_info WHERE 1=1 <if test="proNo!=null and proNo!=''"> and pro_No=#{proNo} </if> </select>2.where 标签where 元素只会在子元素返回任何内容的情况下才插入 “WHERE” 子句。而且，若子句的开头为 “AND”
今天再努力一下，没准明天会更好呢？
演示版本为Mybatis最新版本3.5.9。不同版本效果可能不一样。
一、什么是动态SQL动态SQL说白了就是根据不同条件拼接而成的一个可执行SQL语句。
动态SQL的实现是通过MyBatis提供的各种标签对查询条件做出判断实现动态拼接SQL语句的过程，其条件判断是通过OGNL表达式实现。常用的标签有<if/>、<where/>、<foreach/>等。
注意：当在mapper中使用动态SQL时，如果SQL中出现了诸如>(大于)、<(小于)、>=(大于等于)、<=(小于等于)等符号时，最好使用实体符号。否则 XML可能会出现解析错误的情况，因为mapper配置文件中标签是<和>拼接的。
符号转换
二、常用标签演示演示版本为Mybatis最新版本3.5.9。不同版本效果可能不一样。
1.if标签if标签的执行，当test的值为true时，会将其包含的SQL片段拼接到SQL语句中；反之，不拼接。
<select id="findProInfoTestIf" parameterType="com.shpe.chapter3.entity.ProductInfo" resultType="com.shpe.chapter3.entity.ProductInfo">
select * from product_info WHERE 1=1
<if test="proNo!=null and proNo!=''">
and pro_No=#{proNo}
</if>
</select>2.where 标签
where 元素只会在子元素返回任何内容的情况下才插入 “WHERE” 子句。而且，若子句的开头为 “AND” 或 “OR”，where 元素也会将它们去除。
将上边的if标签的SQL变形如下：
<select id="findProInfoTestWhere" parameterType="com.shpe.chapter3.entity.ProductInfo" resultType="com.shpe.chapter3.entity.ProductInfo">
select * from product_info
<where>
<if test="proNo!=null and proNo!=''">
and pro_No=#{proNo}
</if>
</where>
</select>3.choose、when、otherwise
choose、when、otherwise这三个标签是一个整体，就像switch....case(含break)...default。
这几个标签的关系是：
- <choose/>标签只可以包含<when/>、<otherwise/>
- <choose/>可以包含多个<wher/>标签与一个<otherwise>标签。
- <choose/>标签的执行，其会从第一个<when/>标签开始，逐个向后进行条件判断。若出现某个<when/>中的test属性值为true，则会直接结束<choose/>标签，不再执行其它<when/>标签。若所有的<when/>的test属性的值为false，则最后执行<otherwise/>标签。
<select id="findProInfoTestChoose" parameterType="com.shpe.chapter3.entity.ProductInfo" resultType="com.shpe.chapter3.entity.ProductInfo">
<bind name="proNo1" value="'%' _parameter.getProNo() '%'" />
select * from product_info
<where>
<choose>
<!--%与#占位符之间必须有空格 不然查不到-->
<when test="proNo=='1'.toString()">
and pro_No like #{proNo1}
</when>
<when test='proNo=="2"'>
and pro_No like '%' #{proNo} '%'
</when>
<otherwise>
1=2
</otherwise>
</choose>
</where>
</select>
另外，如果判断条件的值是纯数字，但实际是字符串，上边给出了两种字符串比较的方法。
<when test="proNo=='1'.toString()">;<when test='proNo=="2"'>
4.foreach标签该标签主要用于实现对数组或集合的遍历。常用属性有：
collection：表示传入过来的参数的数据类型。该参数为必选。要做 foreach 的对象，作为入参时，大致可分为以下三种情况：
(1).如果传入的是单参数且参数类型是一个List集合，collection属性值为【arg0或collection或 list】 .
(2).如果传入的是单参数且参数类型是一个array数组，collection的属性值为【array或arg0 】.
(3).如果传入的参数是多个，此时最好是将它们封装成一个Map，此时collection属性值就是传入的List或array对象在自己封装的map里面的key.
item： 循环体中的具体对象。
index：在list和数组中 index是元素的序号；在map里index 是元素的 key。
open：表示该语句以什么开始。
close：表示该语句以什么结束。
separator：表示在每次进行迭代之间以什么符号作为分隔符。
- 参数是List集合
参数可以是【arg0或collection或 list】且获取集合个数可以写成size或size()，效果相同
<select id="findProInfoTestForeachList" resultType="com.shpe.chapter3.entity.ProductInfo">
select * from product_info
<where>
<if test="list!=null and list.size>0">
id in
<foreach collection="list" open="(" close=")" separator=" " item="id">
#{id}
</foreach>
</if>
<!-- <if test="arg0!=null and arg0.size>0">
id in
<foreach collection="arg0" open="(" close=")" separator=" " item="id">
#{id}
</foreach>
</if>-->
<!-- <if test="collection!=null and collection.size()>0">
id in
<foreach collection="collection" open="(" close=")" separator=" " item="id">
#{id}
</foreach>
</if>-->
</where>
</select>
- 参数是array数组
参数可以是【array或arg0 】任意一个，效果相同。
<select id="findProInfoTestForeachAyyay" resultType="com.shpe.chapter3.entity.ProductInfo">
select * from product_info
<where>
<!--<if test="arg0!=null and arg0.length>0">
id in
<foreach collection="arg0" open="(" close=")" separator=" " item="id">
#{id}
</foreach>
</if>-->
<if test="array!=null and array.length>0">
id in
<foreach collection="array" open="(" close=")" separator=" " item="id">
#{id}
</foreach>
</if>
</where>
</select>
- 参数为Map
参数为Map中对应的Key
<select id="findProInfoTestForeachMap" resultType="com.shpe.chapter3.entity.ProductInfo">
select * from product_info
<where>
<if test="idsKey!=null and idsKey.size>0">
id in
<foreach collection="idsKey" open="(" close=")" separator=" " item="id">
#{id}
</foreach>
</if>
</where>
</select>5.set标签
set标签主要用在更新操作中。
<update id="updateInfo" parameterType="com.shpe.chapter3.entity.ProductInfo">
UPDATE Product_info
<set>
pro_no=#{proNo} pro_name=#{proName}
</set>
<where>
id=#{id}
</where>
</update>6.bind标签
bind 元素允许你在 OGNL 表达式以外创建一个变量，并将其绑定到当前的上下文。
拿choose、when、otherwise标签的演示案例举例模糊查询
- 参数为单个参数且为一个对象
_parameter必须是__parameter 不能是其它参数。
<select id="findProInfoTestChoose" parameterType="com.shpe.chapter3.entity.ProductInfo" resultType="com.shpe.chapter3.entity.ProductInfo">
<bind name="proNo1" value="'%' _parameter.getProNo() '%'" />
select * from product_info
<where>
<choose>
<!--%与#占位符之间必须有空格 不然查不到-->
<when test="proNo=='1'.toString()">
and pro_No like #{proNo1}
</when>
<when test='proNo=="2"'>
and pro_No like '%' #{proNo} '%'
</when>
<otherwise>
1=2
</otherwise>
</choose>
</where>
</select>
- 参数为Map
proNoKey必须是对应绑定对象在Map中的key。
<select id="findProInfoTestChooseMap" parameterType="map" resultType="com.shpe.chapter3.entity.ProductInfo">
<bind name="proNo1" value="'%' proNoKey '%'" />
select * from product_info
<where>
<choose>
<!--%与#占位符之间必须有空格 不然查不到-->
<when test="proNoKey=='1'.toString()">
and pro_No like #{proNo1}
</when>
<when test='proNoKey=="2"'>
and pro_No like '%' #{proNo} '%'
</when>
<otherwise>
1=2
</otherwise>
</choose>
</where>
</select>
- 单参数为简单类型(如String）
_parameter可以是任意变量，如命名为aaa或b或c，都可以
<select id="findProInfoTestChooseSinglePram" parameterType="string" resultType="com.shpe.chapter3.entity.ProductInfo">
<bind name="proNo1" value="'%' _parameter '%'" />
select * from product_info
<where>
<choose>
<!--%与#占位符之间必须有空格 不然查不到-->
<when test="proNoKey=='1'.toString()">
and pro_No like #{proNo1}
</when>
<when test='proNoKey=="2"'>
and pro_No like '%' #{proNo} '%'
</when>
<otherwise>
1=2
</otherwise>
</choose>
</where>
</select>7.trim标签
trim标签可以看做是一个自定义标签，不常用。常用属性
- prefix 给sql语句拼接的前缀。
- suffix 给sql语句拼接的后缀。
- prefixOverrides 去除sql语句前面的关键字或者字符，该关键字或者字符由prefixOverrides属性指定，假设该属性指定为"AND"，当sql语句的开头为"AND"，trim标签将会去除该"AND"
- suffixOverrides 去除sql语句后面的关键字或者字符，该关键字或者字符由suffixOverrides属性指定。
- 自定义where
我们改写下，前边where标签的演示案例。
<select id="findProInfoTestWhere" parameterType="com.shpe.chapter3.entity.ProductInfo" resultType="com.shpe.chapter3.entity.ProductInfo">
<!-- select * from product_info
<where>
<if test="proNo!=null and proNo!=''">
and pro_No=#{proNo}
</if>
</where>-->
select * from product_info
<trim prefix="where" prefixOverrides="AND|OR">
<if test="proNo!=null and proNo!=''">
and pro_No=#{proNo}
</if>
</trim>
</select>
- 自定义set
- set等价于下列格式，小伙伴可以自己演示下。
<trim prefix="SET" suffixOverrides=" ">
...
</trim>8.script标签
引用官方案例，此处不再列举实例演示。
script要在带注解的映射器接口类中使用动态 SQL，可以使用 script 元素。比如:
@Update({"<script>"
"update Author"
" <set>"
" <if test='username != null'>username=#{username} </if>"
" <if test='password != null'>password=#{password} </if>"
" <if test='email != null'>email=#{email} </if>"
" <if test='bio != null'>bio=#{bio}</if>"
" </set>"
"where id=#{id}"
"</script>"})
void updateAuthorValues(Author author);
