and user_email = #{userEmail}
需要注意的内容:
test的属性值是一个符合OGNL要求的判断表达式,表达式的结果可以是true或false。除此之外,所有的非0值都为true,只有0为false。为了方便理解,在表达式中,建议只用true和false作为结果
判断条件
properties != null
或
properties == null
适用于任何类型的字段,用于判断属性值是否为空
判断条件
properties != ''
或
properties == ''
只适用与
string
类型的字段,用于判断是否为空字符串
当有多个判断时,使用
and
或
or
进行连接,嵌套的判断可以使用小括号分组
在OGNL表达式中,判断的顺序不会影响判断的结果,也不会有空指针异常。但建议判断顺序与Java一致
注意SQL中where关键字后面的查询条件
1 = 1
由于查询条件都是动态的,当两个if判断都不满足时,最后生成的SQL就会以where结束,因此会报错。加上
1 = 1
这个条件就可以避免
注意条件中的and或or
当if判断通过时,这部分拼接到where 1 = 1之后时仍然是合法的SQL
在update更新列中使用if
需求:只更新有变化的字段,更新时不能将原来有值但没有变化的字段更新为空或null
update sys_user
<if test="userName != null and userName != ''">
user_name = #{userName},
<if test="userPassword != null and userPassword != ''">
user_password = #{userPassword},
<if test="userEmail != null and userEmail != ''">
user_email = #{userEmail},
<if test="userInfo != null and userInfo != ''">
user_info = #{userInfo},
<if test="headImg != null">
head_img = #{headImg, jdbcType=BLOB},
<if test="createTime != null">
create_time = #{createTime, jdbcType=TIMESTAMP},
id = #{id},
where id = #{id}
需要注意的内容:
每个if元素里面SQL语句后面的逗号
where关键字前面的id = #{id}
注意以上两点确保生成的SQL的正确性
在insert动态插入列中使用if
需求:在数据库表插入数据的时候,如果某一列的参数值不为空,就用传入的值;如果传入的参数为空,就用数据库中的默认值(或空值)。
<insert id="insert2" useGeneratedKeys="true" keyProperty="id">
insert into sys_user(
user_name, user_password,
<if test="userEmail != null and userEmail != ''">
user_email,
user_info, head_img, create_time)
values(
#{userName}, #{userPassword},
<if test="userEmail != null and userEmail != ''">
#{userEmail},
#{userInfo}, #{headImg, jdbcType=BLOB}, #{createTime, jdbcType=TIMESTAMP})
</insert>
需要注意的内容:
若在列的部分增加if条件,则values部分也要增加相同的if条件,必须保证上下可以互相对应
choose用法
choose标签用于实现if...else if...else...的逻辑。choose标签包含when和otherwise两个标签,至多有一个otherwise标签
需求:当参数id有值时优先使用id查询,当id为没有值时,就去判断用户名是否有值,如果有值就用用户名查询,如果用户名没有值,就使SQL查询无结果。
<select id="selectByIdOrUserName" resultType="tk.mybatis.simple.model.SysUser">
select id,
user_name userName,
user_password userPassword,
user_email userEmail,
user_info userInfo,
head_img headImg,
create_time createTime
from sys_user
where 1 = 1
<choose>
<when test="id != null">
and id = #{id}
</when>
<when test="userName != null and userName != ''">
and user_name = #{userName}
</when>
<otherwise>
and 1 = 2
</otherwise>
</choose>
</select>
需要注意内容:
使用choose标签的时候逻辑要严密,避免某些值出现问题导致SQL出错。
例如,如果没有otherwise这个限制条件,所有的用户都会被查询出来,如果我们在接口方法中使用对象作为返回值,当查询结果是多个的时候就会报错。添加otherwise条件后,由于where条件不满足,因此在这种情况下就查询不到结果。
where、set、trim 用法
where用法
where标签的作用:如果该标签包含的元素中有返回值,就插入一个where;如果where后面的字符串是以and或or开头的,就将它们剔除。
<select id="selectByUser" resultType="tk.mybatis.simple.model.SysUser">
select id,
user_name userName,
user_password userPassword,
user_email userEmail,
user_info userInfo,
head_img headImg,
create_time createTime
from sys_user
<where>
<if test="@tk.mybatis.util.StringUtil@isNotEmpty(userName)">
and user_name like concat('%', #{userName}, '%')
<if test="userEmail != '' and userEmail != null">
and user_email = #{userEmail}
</where>
</select>
当if条件都不满足的时候,where元素中没有内容,所以在SQL中不会出现where;
当if条件满足,where元素的内容就是以and开头的查询条件,where会自动去掉开头的and。
set用法
set标签的作用:如果该标签包含的元素有返回值,就插入一个set;
如果set后面的字符串是以逗号结尾的,就想这个逗号剔除。
<update id="updateByIdSelective">
update sys_user
<if test="userName != null and userName != ''">
user_name = #{userName},
<if test="userPassword != null and userPassword != ''">
user_password = #{userPassword},
<if test="userEmail != null and userEmail != ''">
user_email = #{userEmail},
<if test="userInfo != null and userInfo != ''">
user_info = #{userInfo},
<if test="headImg != null">
head_img = #{headImg, jdbcType=BLOB},
<if test="createTime != null">
create_time = #{createTime, jdbcType=TIMESTAMP},
id = #{id},
where id = #{id}
</update>
需要注意的内容:
当set标签中没有返回值时,形成的SQL为:
update sys_user where id = #{id}
所以,仍需要添加id = #{id},使最后的SQL满足语法
trim用法
where和set标签的功能都可以用trim标签来实现
where标签对应的trim实现:
<trim prefix="WHERE" prefixOverrides="AND |OR ">
</trim>
需要注意的内容:
AND 和 OR后面的空格不能省略,这是为了避免匹配到andes、orders等单词
prefixOverriders包含的值除了AND和OR之外,还有:AND\n
,OR\n
,AND\r
,OR\r
,AND\t
,OR\t
set标签对应的trim实现:
<trim prefix="SET" suffixOverrides=",">
</trim>
trim标签有如下属性:
prefix:当trim元素包含内容时,会给内容增加prefix指定的前缀
prefixOverrides:当trim元素包含内容时,会把prefixOverrides中指定的前缀字符串去掉
suffix:当trim元素包含内容时,会给内容增加suffix指定的前缀
suffixOverrides:当trim元素包含内容时,会把suffixOverrides中指定的后缀字符串去掉
foreach用法
foreach标签可以对数组、Map、实现Iterable接口的对象进行遍历。由于数组在处理时会转化为List对象,因此foreach遍历的对象可以分为两大类:Iterable类型和Map类型
foreach标签包含如下属性:
collection:必填,值为要迭代循环的属性名
item:变量名,值为从迭代对象中取出的每一个值
index:索引名,在Iterable类型下为当前索引值,当Map类型下为Map的Key
open:整个循环内容开头的字符串
close:整个循环内容结尾的字符串
separator:每次循环的分隔符
foreach标签
由于foreach遍历的对象分为:Iterable类型和Map类型,所以collection的属性值也分为不同情况:
参数是一个Iterable
参数是一个Map类型
参数是一个对象
有多个参数
参数是一个Iterable
前提:没有使用@Param
注解,使用默认的名称。如果使用了@Param
注解,collection属性的值为@Param
注解中指定的内容
当遍历的对象是一个数组时,collection属性的默认值为array
当遍历的对象是一个List时,collection属性的默认值为list
参数是一个Map类型
前提:没有使用@Param
注解,使用默认的名称。如果使用了@Param
注解,collection属性的值为@Param
注解中指定的内容
当遍历的对象是一个Map时,collection属性的默认值为_parameter
参数是一个对象
指定为对象的属性名即可。当使用对象内多层嵌套的对象时,使用属性.属性的方式可以指定深层的属性值
有多个参数
当有多个参数的时候,要使用@Param
注解给每个参数指定一个名字,否则在SQL中使用参数时就会不方便。因此将collection属性值设置为@Param
直接指定的名字即可
foreach实现in集合
需求:根据传入的用户id集合查询出所有符合条件的用户
<select id="selectByIdList" resultType="tk.mybatis.simple.model.SysUser">
select id,
user_name userName,
user_password userPassword,
user_email userEmail,
user_info userInfo,
head_img headImg,
create_time createTime
from sys_user
where id in
<foreach collection="list" open="(" close=")" separator="," item="id" index="i">
#{id}
</foreach>
</select>
foreach实现批量插入
当参数类型是List时,实现批量插入
<insert id="insertList">
insert into sys_user(
user_name, user_password,user_email,
user_info, head_img, create_time)
values
<foreach collection="list" item="user" separator=",">
#{user.userName}, #{user.userPassword},#{user.userEmail},
#{user.userInfo}, #{user.headImg, jdbcType=BLOB},
#{user.createTime, jdbcType=TIMESTAMP})
</foreach>
</insert>
从MyBatis 3.3.1 版本开始,MyBatis开始支持批量新增回写主键值的功能。这个功能要求数据库主键值为自增类型,透视还要求该数据库提供的JDBC可以支持返回批量插入的主键值。目前只有Mysql数据库支持。
如果要在Mysql中实现批量插入返回自增主键值,只需要在原来代码的基础上进行如下修改即可:
<insert id="insertList" useGeneratedKeys="true" keyProperty="DTO对象的主键字段">
foreach实现动态update
当参数类型是Map时,实现批量更新
<update id="updateByMap">
update sys_user
<foreach collection="_parameter" item="val" index="key" separator=",">
${key} = #{val}
</foreach>
where id = #{id}
</update>
对应的Mapper接口方法为:
void updateByMap(Map map);
当参数类型是Map时,foreach标签的index属性为Map的key,item属性为Map的value
bind用法
bind标签的作用:
bind标签使用OGNL表达式创建一个变量并将其绑定当上下文中
bind标签用于打印传入的参数
bind标签有两个属性,并且都为必选项:name、value
name为绑定到上下文的变量名
value为OGNL表达式
在Mysql中,concat函数支持多个参数,但在Oracle中只支持两个参数。所以下面的SQL在迁移数据库时就会出现错误
<if test="userName != null and userName != ''">
and user_name like concat('%', #{userName}, '%')
使用bind标签改写
<if test="userName != null and userName != ''">
<bind name="userNameTemp" value="'%' + userName + '%'"/>
and user_name like #{userNameTemp}
打印SQL中传入的参数
<update id="updateByIdSelective">
<bind name="print" value="@tk.mybatis.util.StringUtil@print(_parameter,'updateByIdSelective方法')"/>
update sys_user
<if test="userName != null and userName != ''">
user_name = #{userName},
<if test="userPassword != null and userPassword != ''">
user_password = #{userPassword},
<if test="userEmail != null and userEmail != ''">
user_email = #{userEmail},
<if test="userInfo != null and userInfo != ''">
user_info = #{userInfo},
<if test="headImg != null">
head_img = #{headImg, jdbcType=BLOB},
<if test="createTime != null">
create_time = #{createTime, jdbcType=TIMESTAMP},
id = #{id},
where id = #{id}
</update>
多数据支持
MyBatis多数据库的支持除了可以使用bind标签之外,还可以使用if标签配合databaseIdProvider进行配置。
MyBatis可以根据不同的数据库厂商执行不同的语句,这种多厂商的支持基于映射语句中的databaseId
属性
<select id="selectRolesByUserId" resultType="tk.mybatis.simple.model.SysRole" databaseId="mysql">
select
r.id,
r.role_name roleName,
r.enabled,
r.create_by createBy,
r.create_time createTime,
u.user_name as "user.userName",
u.user_email as "user.userEmail"
from sys_user u
inner join sys_user_role ur on u.id = ur.user_id
inner join sys_role r on ur.role_id = r.id
where u.id = #{userId}
</select>
Mybatis会加载不带databaseId属性和带有匹配当前数据库databaseId属性的所有语句。如果同时找到带有databaseId和不带databaseId的相同语句,则后者会被抛弃。
为支持多厂商特性,只要像下面这样在mybatis-config.xml文件中加入databaseIdProvider配置即可。
<databaseIdProvider type="DB_VENDER" />
这里的DB_VENDER值会通过DatabaseMetaData类的getDatabaseProductName()方法的返回值进行设置。由于该返回值非常长,并且包含相同产品的不同版本,所以通常设置属性别名使其变短。
<databaseIdProvider type="DB_VENDER">
<property name="SQL Server" value="sqlserver" />
<property name="DB2" value="db2" />
<property name="Oracle" value="oracle" />
<property name="MySQL" value="mysql" />
<property name="PostgreSQL" value="postgresql" />
<property name="Derby" value="derby" />
<property name="HSQL" value="hsqldb" />
<property name="H2" value="h2" />
</databaseIdProvider>
除了增加上面的配置外,映射文件也需要进行修改,包含databaseId属性的标签有:
insert
delect
update
select
selectKey
示例:在Mysql中contract函数可以接受多个参数,才Oracle中contract函数只接受两个参数
mysql
<select id="selectByUser" resultType="tk.mybatis.simple.model.SysUser" databaseId="mysql">
select id,
user_name userName,
user_password userPassword,
user_email userEmail,
user_info userInfo,
head_img headImg,
create_time createTime
from sys_user
<where>
<if test="userName != '' and userName != null">
and user_name like concat('%', #{userName}, '%')
<if test="userEmail != '' and userEmail != null">
and user_email = #{userEmail}
</where>
</select>
oracle
<select id="selectByUser" resultType="tk.mybatis.simple.model.SysUser" databaseId="oracle">
select id,
user_name userName,
user_password userPassword,
user_email userEmail,
user_info userInfo,
head_img headImg,
create_time createTime
from sys_user
<where>
<if test="userName != '' and userName != null">
and user_name like concat(concat('%', #{userName}),'%')
<if test="userEmail != '' and userEmail != null">
and user_email = #{userEmail}
</where>
</select>
还有更简单的写法,只是因为数据库的更换可能只会引起某个SQL语句的部分不同,所以没有必要使用上面的方式。可以使用if标签配合默认上下文中的_databaseId参数实现上面的功能,避免大量重复的SQL出现。当然也可以使用choose标签
<select id="selectByUser" resultType="tk.mybatis.simple.model.SysUser">
select id,
user_name userName,
user_password userPassword,
user_email userEmail,
user_info userInfo,
head_img headImg,
create_time createTime
from sys_user
<where>
<if test="userName != '' and userName != null">
<if test="_databaseId == 'mysql'">
and user_name like concat(concat('%', #{userName}),'%')
<if test="_databaseId == 'oracle'">
and user_name like concat(concat('%', #{userName}),'%')
<if test="userEmail != '' and userEmail != null">
and user_email = #{userEmail}
</where>
</select>
OGNL用法
在Mybatis的动态SQL中大量使用了OGNL表达式,Mybatis常用的OGNL表达式有:
e1 and e2 , e1 or e2 , !e1 (not e1)
e1 == e2 (e1 eq e2) , e1 != e2 (e1 neq e2) , e1 gt e2 , e1 gte e2 , e1 lt e2 , e1 lte e2
e1 + e2 , e1 - e2 , e1 * e2 , e1/e2 , e1%e2
e.method(args) : 调用对象方法
e.property :调用对象属性
@class@methd(args):调用类的静态方法
@class@field:调用类的静态字段
e[key]:按索引取值(数组、List、Map)
调用对象方法
<if test="list != null and list.size() > 0">
调用类型静态方法
<if test="!@org.apache.commons.collections.CollectionUtils@isEmpty(list)">
需要注意的内容:
对于5、8中的用法,可以多层嵌套使用;不管e是不是null,必须保证属性或索引必须存在,否则会报错
对于用法6,还可以实现一些特殊功能,例如:打印传递进SQL中的参数
<bind name="print" value="@tk.mybatis.util.StringUtil@print(_parameter)"/>
其中print方法的内容大致为
public void print(Object param){
System.out.println(param);