Mybatis实用Mapper SQL汇总示例

永夜海

Mybatis作为一个非常好用的持久层框架，相关资料真的是少得可怜，所幸的是官方文档还算详细。本博文主要列举一些个人感觉比较常用的场景及相应的Mapper SQL写法，希望能够对大家有所帮助。
不少持久层框架对动态SQL的支持不足，在SQL需要动态拼接时非常苦恼，而Mybatis很好地解决了这个问题，算是框架的一大亮点。对于常见的场景，例如：批量插入/更新/删除，模糊查询，多条件查询，联表查询，都有非常好的支持。Mybatis的动态SQL生成功能实际使用的是OGNL表达式语言，理解OGNL表达式对动态SQL的使用会有很大程度的帮助。
下面直接上示例：
一、批量插入/更新/删除
批量操作主要使用的是Mybatis的foreach，遍历参数列表执行相应的操作，所以批量插入/更新/删除的写法是类似的，只是SQL略有区别而已。MySql批量操作需要数据库连接配置allowMultiQueries=true才可以。
（1）批量插入 

<insert id="batchInsert" parameterType="java.util.List" useGeneratedKeys="true">
<foreach close="" collection="list" index="index" item="item" open="" separator=";">
insert into user (name, age,dept_code) values
(#{item.name,jdbcType=VARCHAR},
#{item.age,jdbcType=INTEGER},
#{item.deptCode,jdbcType=VARCHAR}
)
</foreach>
</insert>
　　上面演示的是MySql的写法(表主键自增的写法)，因为MySql支持主键自增，所以直接设置useGeneratedKeys=true，即可在插入数据时自动实现主键自增；不需要自增时就不需要设置useGeneratedKeys，而且插入SQL包含所有字段即可。实际Mysql还有另外一种写法，就是拼接values的写法，这种方法我测试过比多条insert语句执行的效率会高些。不过需要注意一次批量操作的数量做一定的限制。具体写法如下： 

<insert id="batchInsert" parameterType="java.util.List" useGeneratedKeys="true">
insert into user (name, age,dept_code) values
<foreach collection="list" index="index" item="item" open="" close="" separator=",">
(#{item.name,jdbcType=VARCHAR},
#{item.age,jdbcType=INTEGER},
#{item.deptCode,jdbcType=VARCHAR}
)
</foreach>
</insert>
　　对于Oracle不支持主键自增，需要序列替换，所以在SQL写法上略有不同，需要在insert语句前加个 <selectKey>...</selectKey>告知Mybatis主键如何生成（selectKey中间的内容有省略，实际是生成主键的SQL）。
　　（2）批量更新 

<update id="batchUpdate" parameterType="java.util.List">
<foreach close="" collection="list" index="index" item="item" open="" separator=";">
update user set name=#{item.name,jdbcType=VARCHAR},age=#{item.age,jdbcType=INTEGER}
where id=#{item.id,jdbcType=INTEGER}
</foreach>
</update>
　　（3）批量删除 

<delete id="batchDelete" parameterType="java.util.List">
<foreach close="" collection="list" index="index" item="item" open="" separator=";">
delete from user
where id=#{item.id,jdbcType=INTEGER}
</foreach>
</delete>
　　二、模糊查询 

<select id="selectLikeName" parameterType="java.lang.String" resultMap="BaseResultMap">
select
<include refid="Base_Column_List" />
from user
where name like CONCAT('%',#{name},'%' )
</select>
　　上面的模糊查询语句是Mysql数据库的写法示例，用到了Mysql的字符串拼接函数CONCAT，其它数据库使用相应的函数即可。
三、多条件查询
多条件查询常用到Mybatis的if判断，这样只有条件满足时，才生成对应的SQL。 

<select id="selectUser" parameterType="map" resultMap="BaseResultMap">
select
<include refid="Base_Column_List" />
from user
<where>
<if test="name != null">
name = #{name,jdbcType=VARCHAR}
</if>
<if test="age != null">
and age = #{age,jdbcType=INTEGER}
</if>
</where>
</select>
　　四、联表查询
　　联表查询在返回结果集为多张表的数据时，可以通过继承resultMap，简化写法。例如下面的示例，结果集在User表字段的基础上添加了Dept的部门名称。 

<resultMap id="ExtResultMap" type="com.research.mybatis.generator.model.UserExt" extends="BaseResultMap">
<result column="name" jdbcType="VARCHAR" property="deptName" />
</resultMap>
<select id="selectUserExt" parameterType="map" resultMap="ExtResultMap">
select
u.*, d.name
from user u inner join dept d on u.dept_code = d.code
<where>
<if test="name != null">
u.name = #{name,jdbcType=VARCHAR}
</if>
<if test="age != null">
and u.age = #{age,jdbcType=INTEGER}
</if>
</where>
</select>
　　上述示例皆在MySql数据库下测试通过，这里限于篇幅，相应的代码及测试类我就不贴上来了。完整的代码及测试类，可以查看我的Github项目地址：https://github.com/wdmcygah/research-mybatis。主要是UserService和UserServiceTest两个类，仓库里面还有些与本博文不相关的代码，注意区分。