动态SQL其实就是根据不同的条件生成不同的SQL,MyBatis中有where、if、choose、when、otherwise、set、foreach等标签,我们可以使用这些标签来对参数值进行条件判断,进而拼接成不同的SQL。中文文档 https://mybatis.org/mybatis-3/zh/dynamic-sql.html
示例中使用的实体类
// 省略了get、set、构造器等方法 public class Blog { private String id; private String title; private String author; private Date createTime; private int views; }
where标签和if标签都可以单独使用,我这里为了方便演示,在示例中就放在一起了。
<select id="queryBlogIf" parameterType="map" resultType="Blog"> select * from blog <!-- where标签会自动添加where语句,并将后面满足条件的if标签中的内容进行拼接, 并且如果拼接之后检查到where之后紧接着的开始语句是and或or的的话,也会自动删除单词and或or, 当然如果所有if都不满足,where语句也不会拼接到SQL里。 例如:如果下面第一个if没有满足,第二if满足了,直接拼接的话就会变成where and,这样的SQL是有问题的, 所以where标签会自动将这个and给删除掉 ,当然如果两个条件都不满足, where语句也不会拼接到最终的SQL里 --> <where> <!-- test中是对传入参数的判断,这里的title != null表示是map中有key为title且不为null时才满足条件, 通常没有传入该参数的话就会是null --> <if test="title != null"> title = #{title} </if> <if test="author != null"> and author = #{author} </if> </where> </select>
choose,when和otherwise标签类似于java的switch,case和default语句。
<select id="queryBlogWhen" parameterType="map" resultType="Blog"> select * from blog <where> <!-- choose标签类似于java中的switch case语句,从上往下顺序判断, 只要遇到满足条件的when标签,就会拼接对应的SQL,其他的when标签就不会再去判断了, 如果所有when标签都不满足的话,则会拼接最后的otherwise标签的SQL --> <choose> <when test="title != null"> title = #{title} </when> <when test="author != null"> and author = #{author} </when> <otherwise> and views = #{views} </otherwise> </choose> </where> </select>
set标签用于拼接update更新操作的SQL,注意示例中使用的标签是update,不再是select查询标签了。
<update id="updateBlogSet" parameterType="map"> update blog <!-- set标签用于拼接update操作的set语句,会在之前的update语句之后自动添加set语句, 同时还会自动处理拼接后SQL中的逗号。例如:如果下面的if判断只有第一个if满足条件, 拼接之后在末尾就会多一个逗号,此时set标签会自动删除这个逗号,保证SQL语句的合法性 --> <set> <if test="title != null"> title = #{title}, </if> <if test="author != null"> author = #{author} </if> </set> <!-- 这里的where语句也可以使用where标签进行更复杂的查询 --> where id = #{id} </update>
foreach标签用于在参数是集合类型的场景下,我们可以循环遍历集合中的元素并拼接到SQL中。
<select id="queryBlogForeach" parameterType="map" resultType="Blog"> select * from blog where id in <!-- foreach标签会根据指定规则拼接SQL,比如下面的配置:collection="ids"表示 从参数map中根据key="ids"拿到对应的集合,然后遍历集合中的元素,item="id"表示遍历时元素对应的变量为id, open="("表示拼接时开始的语句(可以是多个字符),open="("表示结束的语句(可以是多个字符),separator=","表示每个元素在拼接时使用的 连接符或分隔符(可以是多个字符),最终会生成的SQL为“ ( xxx , xxx , xxx ) ”,对应的空格(缺少的或多余的)会自动进行处理 --> <foreach collection="ids" item="id" open="(" close=")" separator=","> #{id} </foreach> </select>
sql标签用于提取公共的SQL配置,在需要使用的地方直接通过include标签进行引用即可。
<!-- 可以使用sql标签将常用的SQL抽取出来,在需要的地方使用include标签进行引用即可 --> <sql id="blogIf"> <if test="title != null"> title = #{title} </if> <if test="author != null"> and author = #{author} </if> </sql> <select id="queryBlogIf2" parameterType="map" resultType="Blog"> select * from blog <where> <!-- 使用include标签的refid引用对应的sql标签内容 --> <include refid="blogIf"/> </where> </select>