什么是动态SQL?
动态sql是mybatis的核心,主要是对sql语句进行灵活操作,通过表达式进行判断,对sql进行灵活的拼接、组装。
实例
用户信息综合查询列表和用户信息查询列表总数这两个statement的定义使用动态sql。对查询条件进行判断,如果输入参数不为空才进行查询条件拼接。
Mapper.xml
<span style="color:#000000"><code><span style="color:#880000"><!-- 用户信息综合查询
#{userCustom.sex}:取出pojo包装对象中性别值
${userCustom.username}:取出pojo包装对象中用户名称
--></span>
<span style="color:#006666"><<span style="color:#4f4f4f">select</span> <span style="color:#4f4f4f">id</span>=<span style="color:#009900">"findUserList"</span> <span style="color:#4f4f4f">parameterType</span>=<span style="color:#009900">"cn.itcast.mybatis.po.UserQueryVo"</span>
<span style="color:#4f4f4f">resultType</span>=<span style="color:#009900">"cn.itcast.mybatis.po.UserCustom"</span>></span>
SELECT * FROM USER
<span style="color:#880000"><!--
where可以自动去掉条件中的第一个and
--></span>
<span style="color:#006666"><<span style="color:#4f4f4f">where</span>></span>
<span style="color:#006666"><<span style="color:#4f4f4f">if</span> <span style="color:#4f4f4f">test</span>=<span style="color:#009900">"userCustom!=null"</span>></span>
<span style="color:#006666"><<span style="color:#4f4f4f">if</span> <span style="color:#4f4f4f">test</span>=<span style="color:#009900">"userCustom.sex!=null and userCustom.sex!=''"</span>></span>
and user.sex = #{userCustom.sex}
<span style="color:#006666"></<span style="color:#4f4f4f">if</span>></span>
<span style="color:#006666"><<span style="color:#4f4f4f">if</span> <span style="color:#4f4f4f">test</span>=<span style="color:#009900">"userCustom.username!=null and userCustom.username!=''"</span>></span>
and user.username LIKE '%${userCustom.username}%'
<span style="color:#006666"></<span style="color:#4f4f4f">if</span>></span>
<span style="color:#006666"></<span style="color:#4f4f4f">if</span>></span>
<span style="color:#006666"></<span style="color:#4f4f4f">where</span>></span>
<span style="color:#006666"></<span style="color:#4f4f4f">select</span>></span></code></span>
<span style="color:#000000"><code><span style="color:#006666"><<span style="color:#4f4f4f">select</span> <span style="color:#4f4f4f">id</span>=<span style="color:#009900">"findUserCount"</span> <span style="color:#4f4f4f">parameterType</span>=<span style="color:#009900">"cn.itcast.mybatis.po.UserQueryVo"</span> <span style="color:#4f4f4f">resultType</span>=<span style="color:#009900">"int"</span>></span>
SELECT count(*) FROM USER
<span style="color:#880000"><!--
where可以自动去掉条件中的第一个and
--></span>
<span style="color:#006666"><<span style="color:#4f4f4f">where</span>></span>
<span style="color:#006666"><<span style="color:#4f4f4f">if</span> <span style="color:#4f4f4f">test</span>=<span style="color:#009900">"userCustom!=null"</span>></span>
<span style="color:#006666"><<span style="color:#4f4f4f">if</span> <span style="color:#4f4f4f">test</span>=<span style="color:#009900">"userCustom.sex!=null and userCustom.sex!=''"</span>></span>
and user.sex = #{userCustom.sex}
<span style="color:#006666"></<span style="color:#4f4f4f">if</span>></span>
<span style="color:#006666"><<span style="color:#4f4f4f">if</span> <span style="color:#4f4f4f">test</span>=<span style="color:#009900">"userCustom.username!=null and userCustom.username!=''"</span>></span>
and user.username LIKE '%${userCustom.username}%'
<span style="color:#006666"></<span style="color:#4f4f4f">if</span>></span>
<span style="color:#006666"></<span style="color:#4f4f4f">if</span>></span>
<span style="color:#006666"></<span style="color:#4f4f4f">where</span>></span>
<span style="color:#006666"></<span style="color:#4f4f4f">select</span>></span></code></span>
测试代码
<span style="color:#000000"><code><span style="color:#880000">//用户信息的综合 查询</span>
<span style="color:#9b859d">@Test</span>
<span style="color:#000088">public</span> <span style="color:#000088">void</span> <span style="color:#009900">testFindUserList</span>() <span style="color:#000088">throws</span> Exception {
SqlSession sqlSession = sqlSessionFactory.openSession();
<span style="color:#880000">//创建UserMapper对象,mybatis自动生成mapper代理对象</span>
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
<span style="color:#880000">//创建包装对象,设置查询条件</span>
UserQueryVo userQueryVo = <span style="color:#000088">new</span> UserQueryVo();
UserCustom userCustom = <span style="color:#000088">new</span> UserCustom();
<span style="color:#880000">//由于这里使用动态sql,如果不设置某个值,条件不会拼接在sql中</span>
<span style="color:#880000">//userCustom.setSex("1");</span>
userCustom.setUsername(<span style="color:#009900">"小明"</span>);
userQueryVo.setUserCustom(userCustom);
<span style="color:#880000">//调用userMapper的方法</span>
List<UserCustom> list = userMapper.findUserList(userQueryVo);
System.out.println(list);
}</code></span>
sql片段
将上边实现的动态sql判断代码块抽取出来,组成一个sql片段。其它的statement中就可以引用sql片段。方便程序员进行开发。
定义sql片段
<span style="color:#000000"><code><span style="color:#880000"><!-- 定义sql片段
id:sql片段的唯 一标识
经验:是基于单表来定义sql片段,这样话这个sql片段可重用性才高
在sql片段中不要包括 where
--></span>
<span style="color:#006666"><<span style="color:#4f4f4f">sql</span> <span style="color:#4f4f4f">id</span>=<span style="color:#009900">"query_user_where"</span>></span>
<span style="color:#006666"><<span style="color:#4f4f4f">if</span> <span style="color:#4f4f4f">test</span>=<span style="color:#009900">"userCustom!=null"</span>></span>
<span style="color:#006666"><<span style="color:#4f4f4f">if</span> <span style="color:#4f4f4f">test</span>=<span style="color:#009900">"userCustom.sex!=null and userCustom.sex!=''"</span>></span>
and user.sex = #{userCustom.sex}
<span style="color:#006666"></<span style="color:#4f4f4f">if</span>></span>
<span style="color:#006666"><<span style="color:#4f4f4f">if</span> <span style="color:#4f4f4f">test</span>=<span style="color:#009900">"userCustom.username!=null and userCustom.username!=''"</span>></span>
and user.username LIKE '%${userCustom.username}%'
<span style="color:#006666"></<span style="color:#4f4f4f">if</span>></span>
<span style="color:#006666"></<span style="color:#4f4f4f">if</span>></span>
<span style="color:#006666"></<span style="color:#4f4f4f">sql</span>></span></code></span>
引用sql片段
<span style="color:#000000"><code><span style="color:#880000"><!-- 用户信息综合查询
#{userCustom.sex}:取出pojo包装对象中性别值
${userCustom.username}:取出pojo包装对象中用户名称
--></span>
<span style="color:#006666"><<span style="color:#4f4f4f">select</span> <span style="color:#4f4f4f">id</span>=<span style="color:#009900">"findUserList"</span> <span style="color:#4f4f4f">parameterType</span>=<span style="color:#009900">"cn.itcast.mybatis.po.UserQueryVo"</span>
<span style="color:#4f4f4f">resultType</span>=<span style="color:#009900">"cn.itcast.mybatis.po.UserCustom"</span>></span>
SELECT * FROM USER
<span style="color:#880000"><!--
where可以自动去掉条件中的第一个and
--></span>
<span style="color:#006666"><<span style="color:#4f4f4f">where</span>></span>
<span style="color:#880000"><!-- 引用sql片段 的id,如果refid指定的id不在本mapper文件中,需要前边加namespace --></span>
<span style="color:#006666"><<span style="color:#4f4f4f">include</span> <span style="color:#4f4f4f">refid</span>=<span style="color:#009900">"query_user_where"</span>></span><span style="color:#006666"></<span style="color:#4f4f4f">include</span>></span>
<span style="color:#880000"><!-- 在这里还要引用其它的sql片段 --></span>
<span style="color:#006666"></<span style="color:#4f4f4f">where</span>></span>
<span style="color:#006666"></<span style="color:#4f4f4f">select</span>></span></code></span>
其中的关键是这一句引用:
<span style="color:#000000"><code><span style="color:#880000"><!-- 引用sql片段 的id,如果refid指定的id不在本mapper文件中,需要前边加namespace --></span>
<span style="color:#006666"><<span style="color:#4f4f4f">include</span> <span style="color:#4f4f4f">refid</span>=<span style="color:#009900">"query_user_where"</span>></span><span style="color:#006666"></<span style="color:#4f4f4f">include</span>></span></code></span>
foreach
向sql传递数组或List,mybatis使用foreach解析
应用场景
在用户查询列表和查询总数的statement中增加多个id输入查询。
类似下面的sql语句:
<span style="color:#000000"><code><span style="color:#000088">SELECT</span> * <span style="color:#000088">FROM</span> <span style="color:#000088">USER</span> <span style="color:#000088">WHERE</span> id=<span style="color:#006666">1</span> <span style="color:#000088">OR</span> id=<span style="color:#006666">10</span> <span style="color:#000088">OR</span> id=<span style="color:#006666">16</span>
<span style="color:#000088">SELECT</span> * <span style="color:#000088">FROM</span> <span style="color:#000088">USER</span> <span style="color:#000088">WHERE</span> id <span style="color:#000088">IN</span>(<span style="color:#006666">1</span>,<span style="color:#006666">10</span>,<span style="color:#006666">16</span>)
</code></span>
在输入参数类型中添加List ids传入多个id
<span style="color:#000000"><code><span style="color:#000088">public</span> <span style="color:#000088">class</span> UserQueryVo {
<span style="color:#880000">//传入多个id</span>
<span style="color:#000088">private</span> List<Integer> ids;
</code></span>
修改Mapper.xml
WHERE id=1 OR id=10 OR id=16,在查询条件中,查询条件定义成一个sql片段,需要修改sql片段。
<span style="color:#000000"><code><span style="color:#006666"><<span style="color:#4f4f4f">if</span> <span style="color:#4f4f4f">test</span>=<span style="color:#009900">"ids!=null"</span>></span>
<span style="color:#880000"><!-- 使用 foreach遍历传入ids
collection:指定输入 对象中集合属性
item:每个遍历生成对象中
open:开始遍历时拼接的串
close:结束遍历时拼接的串
separator:遍历的两个对象中需要拼接的串
--></span>
<span style="color:#880000"><!-- 使用实现下边的sql拼接:
AND (id=1 OR id=10 OR id=16)
--></span>
<span style="color:#006666"><<span style="color:#4f4f4f">foreach</span> <span style="color:#4f4f4f">collection</span>=<span style="color:#009900">"ids"</span> <span style="color:#4f4f4f">item</span>=<span style="color:#009900">"user_id"</span> <span style="color:#4f4f4f">open</span>=<span style="color:#009900">"AND ("</span> <span style="color:#4f4f4f">close</span>=<span style="color:#009900">")"</span> <span style="color:#4f4f4f">separator</span>=<span style="color:#009900">"or"</span>></span>
<span style="color:#880000"><!-- 每个遍历需要拼接的串 --></span>
id=#{user_id}
<span style="color:#006666"></<span style="color:#4f4f4f">foreach</span>></span>
</code></span>
测试代码
修改上面的测试方法,传入多个id进行测试。
<span style="color:#000000"><code> <span style="color:#880000">//创建包装对象,设置查询条件</span>
UserQueryVo userQueryVo <span style="color:#4f4f4f">=</span> <span style="color:#006666">new</span> UserQueryVo();
UserCustom userCustom <span style="color:#4f4f4f">=</span> <span style="color:#006666">new</span> UserCustom();
<span style="color:#880000">//由于这里使用动态sql,如果不设置某个值,条件不会拼接在sql中</span>
<span style="color:#880000">//userCustom.setSex("1");</span>
userCustom<span style="color:#4f4f4f">.</span>setUsername(<span style="color:#009900">"小明"</span>);
<span style="color:#880000">//传入多个id</span>
<span style="color:#4f4f4f">List</span><span style="color:#4f4f4f"><</span><span style="color:#4f4f4f">Integer</span><span style="color:#4f4f4f">></span> ids <span style="color:#4f4f4f">=</span> <span style="color:#006666">new</span> ArrayList<span style="color:#4f4f4f"><</span><span style="color:#4f4f4f">Integer</span><span style="color:#4f4f4f">></span>();
ids<span style="color:#4f4f4f">.</span>add(<span style="color:#006666">1</span>);
ids<span style="color:#4f4f4f">.</span>add(<span style="color:#006666">10</span>);
ids<span style="color:#4f4f4f">.</span>add(<span style="color:#006666">16</span>);
<span style="color:#880000">//将ids通过userQueryVo传入statement中</span>
userQueryVo<span style="color:#4f4f4f">.</span>setIds(ids);
userQueryVo<span style="color:#4f4f4f">.</span>setUserCustom(userCustom);
<span style="color:#880000">//调用userMapper的方法</span>
<span style="color:#4f4f4f">List</span><span style="color:#4f4f4f"><</span>UserCustom<span style="color:#4f4f4f">></span> <span style="color:#4f4f4f">list</span> <span style="color:#4f4f4f">=</span> userMapper<span style="color:#4f4f4f">.</span>findUserList(userQueryVo);
System<span style="color:#4f4f4f">.</span>out<span style="color:#4f4f4f">.</span>println(<span style="color:#4f4f4f">list</span>);</code></span>