MyBatis--08--常用标签

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

---

1.常用属性

属性	描述
id	在命名空间中唯一的标识符，被用来引用这条语句
parameterType	传入这条语句的参数的类全限定名或别名
resultType	期望从这条语句中返回结果的类全限定名或别名，resultType 和 resultMap 之间只能同时使用一个
resultMap	在命名空间中唯一的标识符，被用来引用这条语句 ，resultType 和 resultMap 之间只能同时使用一个
flushCache	将其设置为 true 后，只要语句被调用，都会导致本地缓存和二级缓存被清空，默认值：对于（select语句）false ；对于（ insert、update 和 delete 语句）true
useCache	将其设置为 true 后，将会导致本条语句的结果被二级缓存缓存起来，默认值：对于（select语句）为 true
useGeneratedKeys	（仅适用于 insert 和 update）这会令 MyBatis 使用 JDBC 的 getGeneratedKeys 方法来取出由数据库内部生成的主键（比如：像 MySQL 和 SQL Server 这样的关系型数据库管理系统的自动递增字段），默认值：false
keyProperty	（仅适用于 insert 和 update）指定能够唯一识别对象的属性，MyBatis 会使用 getGeneratedKeys 的返回值或 insert 语句的 selectKey 子元素设置它的值，默认值：未设置（unset）

2.SQL定义标签

2.1 select

用于数据查询操作，例：

<select id="selectUserInfo" parameterType="int" resultType="map">
  select * from user_info where id=#{keyId}
select>

属性介绍:

1. id :唯一的标识符.
2. parameterType:传给此语句的参数的全路径名或别名 例:com.test.poso.User或user
3. resultType :语句返回值类型或别名。注意，如果是集合，那么这里填写的是集合的泛型，而不是集合本身（resultType 与resultMap 不能并用）

2.2 insert

用于数据保存操作，例：

<insert id="insertUserInfo" parameterType="map" useGeneratedKeys="true" keyProperty="keyId">
  insert into user_info (
	userName,
	userSex
  )values(
  	#{userName},
  	#{userSex}
  )
insert>

属性介绍:

1. id :唯一的标识符
2. parameterType:传给此语句的参数的全路径名或别名 例:com.test.poso.User
   PS：keyProperty属性可返回此条插入数据的主键值

2.3 update

用于数据更新操作，例：

<update id="updateUserInfo" parameterType="map">
  update  user_info
  set userName=#{userName}
  where id=#{keyId}
update>

2.4 delete

用于数据删除操作，例：

<delete id="selectUserInfo" parameterType="int">
  delete  from user_info 
  where id=#{keyId}
delete>

2.5 resultMap

2.6 sql

用于定义可重用的 SQL 代码片段，以便在多个SQL语句中使用。 参数可以静态地（在加载的时候）确定下来，并且可以在不同的 include 元素中定义不同的参数值。例：

<sql id="userColumns"> ${alias}.userName,${alias}.userSexsql>

<select id="selectUserInfo" resultType="map">
  select
    <include refid="userColumns"><property name="alias" value="t1"/>include>,
    <include refid="userColumns"><property name="alias" value="t2"/>include>
  from user_info  t1
  left join user_info_copy t2
select>

3.SQL动态标签

3.1 if

单个条件判断，用以实现条件筛选，例：

<select id="selectUserInfo" parameterType="map" resultType="map">
  select * from user_info 
  where 1=1
  <if test="userSex !=null and userSex !='' ">
  	and userSex=#{userSex}
  if>
  <if test="userName !=null and userName !='' ">
  	and userName like CONCAT('%',#{userName},'%')
  if>
select>

PS：此处需要注意，如果参数值为数字int型，判断是否等于某个固定值时可能会导致判断失效，例如：

<if test="userFlag !=null and userFlag !='' and userFlag =='1'">
  	……
if>

可以修改为：

<if test="userFlag !=null and userFlag !='' and userFlag =='1'.toString()">
  	……
if>

或

<if test='userFlag !=null and userFlag !="" and userFlag =="1"'>
  	……
if>

3.2 foreach

*open和close指在foreach标签头和尾添加指定内容,常见于IN和VALUES函数

3.2.1 批量插入表数据

INSERT INTO table (a, b, c, d) VALUES
<foreach collection = "list" item = "item" separatior = ",">
    (#{item.a}, #{item.b}, #{item.c}, #{item.d})
foreach>
 
/*执行Mybatis后的SQL语句示例
 *<foreach>在每个数据集间添加了','
 */
INSERT INTO table (a, b, c, d) VALUES
 ('a',123,true,'112456789'),
 ('b',124,true,'112455789'),
 ('c',125,false,'112466789'),
 ('d',126,true,'112451789')

3.2.2 批量更新表数据

(1)单条件更新

UPDATE table SET b = '10'
WHERE a IN
<foreach collection = "list" item = "item" open = "(" close = ")" separator = ",">
    #{item.a}
foreach>
 
/*执行Mybatis后的SQL语句示例
 *单条件用到了IN函数
 *<foreach>在标签头尾添加了'(' ')'，并在每个数据间添加了','
 */
UPDATE table SET b = '10'
WHERE a IN ('ZBD12131','ZBD12132','ZBD12133')

(2)多条件更新

UPDATE table
SET a =
CASE
<foreach collection="list" item="item">
    WHEN b=#{item.b} AND c = #{item.c} THEN '10'
foreach>
ELSE a END;
 
/*执行Mybatis后的SQL语句示例
 *多条件批量更新用到了SQL语句中的CASE WHEN函数
 */
UPDATE table
SET a =
CASE
WHEN b=123 AND c = true THEN '10'
WHEN b=124 AND c = true THEN '10'
WHEN b=125 AND c = false THEN '10'
WHEN b=126 AND c = true THEN '10'
ELSE d END;

复杂

3.2.3 批量查询表数据

(1)list单条件查询

SELECT * FROM table
WHERE a IN
<foreach collection = "list" item = "item" open = '(' close = ')' separator = ','>
    #{item.a}
foreach>
 
//执行Mybatis后的SQL语句示例
SELECT * FROM table
WHERE a IN ('ZBD123','ZBD124','ZBD125','ZBD126')

(2)list多条件查询

SELECT * FROM table
WHERE a = #{a}
AND
<foreach collection = "list" item = "item" open = '(' close = ')' separator = 'OR'>
    b = #{item.b} 
    AND c = #{item.c}
    AND d = #{item.d}
foreach>
 
/*执行Mybatis后的SQL语句示例
 *多条件批量查询用到了SQL语句OR函数，视实际应用环境修改separator参数
 */
SELECT * FROM table
WHERE a = '123'
AND (
    b=123 AND c = true AND d = 'ZBD123' OR
    b=124 AND c = true AND d = 'ZBD124' OR
    b=125 AND c = false AND d = 'ZBD125' OR
    b=126 AND c = true AND d = 'ZBD126'
)

3.3 choose/when/otherwise

用以实现条件的多种判断，类似与if else，例：

<select id="selectUserInfo" parameterType="map" resultType="map">
  select * from user_info 
  where 1=1
  <choose>
  	<when test="userFlag!=null and userFlag!='' and userFlag=='Y'">
  		and id<=100
  	when>
  	<when test="userFlag!=null and userFlag!='' and userFlag=='N'">
  		and id <=200
  	when>
  	<otherwise>
  		and id<=300
  	otherwise>
  choose>
select>

3.4 where

只会在子元素返回任何内容的情况下才插入 “WHERE” 子句，并且可以自动处理判断条件语句返回的第一个and或or，
例：不使用where标签时，若userSex为空，语法错误会报错：

<select id="selectUserInfo" parameterType="map" resultType="map">
  select * from user_info 
  where
  <if test="userSex !=null and userSex !='' ">
  	userSex=#{userSex}
  if>
  <if test="userName !=null and userName !='' ">
  	and userName like CONCAT('%',#{userName},'%')
  if>
select>

修改为：< where>

<select id="selectUserInfo" parameterType="map" resultType="map">
  select * from user_info
  <where>
  <if test="userSex !=null and userSex !='' ">
  	userSex=#{userSex}
  if>
  <if test="userName !=null and userName !='' ">
  	and userName like CONCAT('%',#{userName},'%')
  if>
  where>
select>

自动转换为：select * from user_info where userName like ……

3.5 set

可以动态更新需要更新的列，忽略其它不更新的列，例：

<update id="updateUserInfo" parameterType="map">
  update  user_info
  <set>
  <if test="userName!= null and userName!=''">
  userName=#{userName},
  if>
  userSex=#{userSex}
  set>
  where id=#{keyId}
update>

3.6 trim

• trim标记是一个格式化的标记，主要用于拼接sql的条件语句（前缀或后缀的添加或忽略），可以完成set或者是where标记的功能。

prefix	给sql语句拼接的前缀
suffix	给sql语句拼接的后缀
prefixOverrides	指定去除多余的前缀内容，如：prefixOverrides=“AND OR”，去除trim标签内sql语句多余的前缀"and"或者"or"
suffixOverrides	指定去除多余的后缀内容 ，去除sql语句后面的关键字或者字符，

<trim prefix="前缀" suffix="后缀" prefixOverrides="忽略前缀字符" suffixOverrides="忽略后缀字符">
    SQL语句
trim>

3.6.1 在select中

<select id="selectByNameOrHobby" resultMap="BaseResultMap">
	select * from student 
	<trim prefix="WHERE" prefixOverrides="AND | OR">
		<if test="name != null and name.length()>0"> 
			AND name=#{name}
		if>
		<if test="hobby != null and hobby.length()>0">
			AND hobby=#{hobby}
		if>
	trim>
select>

• 当然，避免出现“WHERE AND”还有其他方法，如where 1=1的查询条件

select * from student where 1=1
	<trim suffixOverrides=",">
		<if test="name != null and name != ''">
			and NAME = #{name}
		if>
		<if test="hobby != null and hobby != ''">
			and HOBBY = #{hobby}
		if>
	trim>

3.6.2 用在insert中

<insert id="insert" parameterType="Object">
    insert into student 
	<trim prefix="(" suffix=")" suffixOverrides=",">
		<if test="name != null">
			NAME,
		if>
		<if test="hobby != null  ">
			HOBBY,
		if>
	trim>
	<trim prefix="values(" suffix=")" suffixOverrides=",">
		<if test="name != null  ">
			#{name},
		if>
		<if test="hobby != null  ">
			#{hobby},
		if>
	trim>
insert>

3.6.3 在update中

<update id="updateByPrimaryKey" parameterType="Object">
	update student set 
	<trim  suffixOverrides=",">
		<if test="name != null">
		    NAME=#{name},
		if>
		<if test="hobby != null">
		    HOBBY=#{hobby},
		if>
	trim> 
	where id=#{id}
update>

复杂