快捷導(dǎo)航

Mybatis的where標(biāo)簽使用總結(jié)梳理

更新時(shí)間：2022年05月25日 11:34:26 作者：??程序新視界????

這篇文章主要介紹了Mybatis的where標(biāo)簽使用總結(jié)梳理，文章通過將Mybatis中where標(biāo)簽的基本使用形式展開where標(biāo)簽小技巧以及容易踩到的坑進(jìn)行總結(jié)梳理，具有一定的參考價(jià)值，需要的小伙伴可以參考一下

背景

在上篇文章，我們系統(tǒng)地學(xué)習(xí)了where 1=1 相關(guān)的知識(shí)點(diǎn)，大家可以回看《MySQL中where 1=1方法的使用及改進(jìn)》這篇文章。文章中涉及到了Mybatis的替代方案，有好學(xué)的朋友在評(píng)論區(qū)有朋友問了基于Mybatis寫法的問題。

本篇文章會(huì)將Mybatis中where標(biāo)簽的基本使用形式、小技巧以及容易踩到的坑進(jìn)行總結(jié)梳理，方便大家更好地實(shí)踐運(yùn)用d

原始的手動(dòng)拼接

在不使用Mybatis的where標(biāo)簽時(shí)，我們通常是根據(jù)查詢條件進(jìn)行手動(dòng)拼接，也就是用到了上面提到的where 1=1的方式，示例如下：

  <select id="selectSelective" resultType="com.secbro.entity.User">
 ?  select * from t_user
 ?  where 1=1
 ?  <if test="username != null and username != ''">
 ? ? and username = #{username}
 ?  </if>
 ?  <if test="idNo != null and idNo != ''">
 ? ?  and id_no = #{idNo}
 ?  </if>
  </select>

這種方式主要就是為了避免語(yǔ)句拼接錯(cuò)誤，出現(xiàn)類似如下的錯(cuò)誤SQL：

select * from t_user where and username = 'Tom' and id = '1001';
select * from t_user where and id = '1001';

當(dāng)添加上1=1時(shí)，SQL語(yǔ)句便是正確的了：

select * from t_user where 1=1 and username = 'Tom' and id = '1001';
select * from t_user where 1=1 and id = '1001';

這個(gè)我們之前已經(jīng)提到過，多少對(duì)MySQL數(shù)據(jù)庫(kù)的有一定的壓力。因?yàn)?=1條件的優(yōu)化過濾是需要MySQL做的。如果能夠?qū)⑦@部分放到應(yīng)用程序來做，就減少了MySQL的壓力。畢竟，應(yīng)用程序是可以輕易地橫向擴(kuò)展的。

Mybatis where標(biāo)簽的使用

為了能達(dá)到MySQL性能的調(diào)優(yōu)，我們可以基于Mybatis的where標(biāo)簽來進(jìn)行實(shí)現(xiàn)。where標(biāo)簽是頂層的遍歷標(biāo)簽，需要配合if標(biāo)簽使用，單獨(dú)使用無意義。通常有下面兩種實(shí)現(xiàn)形式。

方式一：

  <select id="selectSelective" resultType="com.secbro.entity.User">
 ?  select * from t_user
 ?  <where>
 ? ?  <if test="username != null and username != ''">
 ? ? ?  username = #{username}
 ? ?  </if>
 ? ?  <if test="idNo != null and idNo != ''">
 ? ? ?  and id_no = #{idNo}
 ? ?  </if>
 ?  </where>
  </select>

方式二：

  <select id="selectSelective" resultType="com.secbro.entity.User">
 ?  select * from t_user
 ?  <where>
 ? ?  <if test="username != null and username != ''">
 ? ? ?  and username = #{username}
 ? ?  </if>
 ? ?  <if test="idNo != null and idNo != ''">
 ? ? ?  and id_no = #{idNo}
 ? ?  </if>
 ?  </where>
  </select>

仔細(xì)觀察會(huì)發(fā)現(xiàn)，這兩種方式的區(qū)別在于第一if條件中的SQL語(yǔ)句是否有and。

這里就涉及到where標(biāo)簽的兩個(gè)特性：

第一，只有if標(biāo)簽有內(nèi)容的情況下才會(huì)插入where子句；
第二，若子句的開通為 “AND” 或 “OR”，where標(biāo)簽會(huì)將它替換去除；

所以說，上面的兩種寫法都是可以了，Mybatis的where標(biāo)簽會(huì)替我們做一些事情。

但需要注意的是：where標(biāo)簽只會(huì) 智能的去除（忽略）首個(gè)滿足條件語(yǔ)句的前綴。所以建議在使用where標(biāo)簽時(shí)，每個(gè)語(yǔ)句都最好寫上 and 前綴或者 or 前綴，否則像以下寫法就會(huì)出現(xiàn)問題：

  <select id="selectSelective" resultType="com.secbro.entity.User">
 ?  select * from t_user
 ?  <where>
 ? ?  <if test="username != null and username != ''">
 ? ? ?  username = #{username}
 ? ?  </if>
 ? ?  <if test="idNo != null and idNo != ''">
 ? ? ?  id_no = #{idNo}
 ? ?  </if>
 ?  </where>
  </select>

生成的SQL語(yǔ)句如下：

select * from t_user ? ?  WHERE username = ?  id_no = ?

很顯然，語(yǔ)法是錯(cuò)誤的。

因此，在使用where標(biāo)簽時(shí)，建議將所有條件都添加上and或or；

進(jìn)階：自定義trim標(biāo)簽

上面使用where標(biāo)簽可以達(dá)到拼接條件語(yǔ)句時(shí)，自動(dòng)去掉首個(gè)條件的and或or，那么如果是其他自定義的關(guān)鍵字是否也能去掉呢？

此時(shí)，where標(biāo)簽就無能為力了，該trim標(biāo)簽上場(chǎng)了，它也可以實(shí)現(xiàn)where標(biāo)簽的功能。

  <select id="selectSelective" resultType="com.secbro.entity.User">
 ?  select * from t_user
 ?  <trim prefix="where" prefixOverrides="and | or ">
 ? ?  <if test="username != null and username != ''">
 ? ? ?  and username = #{username}
 ? ?  </if>
 ? ?  <if test="idNo != null and idNo != ''">
 ? ? ?  and id_no = #{idNo}
 ? ?  </if>
 ?  </trim>
  </select>

將上面基于where標(biāo)簽的寫改寫為trim標(biāo)簽，發(fā)現(xiàn)執(zhí)行效果完全一樣。而且trim標(biāo)簽具有了更加靈活的自定義性。

where語(yǔ)句的坑

另外，在使用where語(yǔ)句或其他語(yǔ)句時(shí)一定要注意一個(gè)地方，那就是：注釋的使用。

先來看例子：

  <select id="selectSelective" resultType="com.secbro.entity.User">
 ?  select * from t_user
 ?  <where>
 ? ?  <if test="username != null and username != ''">
 ? ? ?  and username = #{username}
 ? ?  </if>
 ? ?  <if test="idNo != null and idNo != ''">
 ? ? ?  /* and id_no = #{idNo}*/
 ? ? ?  and id_no = #{idNo}
 ? ?  </if>
 ?  </where>
  </select>

上述SQL語(yǔ)句中添加了 /**/的注釋，生成的SQL語(yǔ)句為：

select * from t_user WHERE username = ? /* and id_no = ?*/ and id_no = ?

執(zhí)行時(shí)，直接報(bào)錯(cuò)。

還有一個(gè)示例：

  <select id="selectSelective" resultType="com.secbro.entity.User">
 ?  select * from t_user
 ?  <where>
 ? ?  <if test="username != null and username != ''">
 ? ? ?  -- and username = #{username}
 ? ? ?  and username = #{username}
 ? ?  </if>
 ? ?  <if test="idNo != null and idNo != ''">
 ? ? ?  and id_no = #{idNo}
 ? ?  </if>
 ?  </where>
  </select>

生成的SQL語(yǔ)句為：

select * from t_user WHERE -- and username = ? and username = ? and id_no = ?

同樣會(huì)導(dǎo)致報(bào)錯(cuò)。

這是因?yàn)槲覀兪褂?XML 方式配置 SQL 時(shí)，如果在 where 標(biāo)簽之后添加了注釋，那么當(dāng)有子元素滿足條件時(shí)，除了 < !-- --> 注釋會(huì)被 where 忽略解析以外，其它注釋例如 // 或 /**/ 或 -- 等都會(huì)被 where 當(dāng)成首個(gè)子句元素處理，導(dǎo)致后續(xù)真正的首個(gè) AND 子句元素或 OR 子句元素沒能被成功替換掉前綴，從而引起語(yǔ)法錯(cuò)誤。

同時(shí)，個(gè)人在實(shí)踐中也經(jīng)常發(fā)現(xiàn)因?yàn)樵赬ML中使用注釋不當(dāng)導(dǎo)致SQL語(yǔ)法錯(cuò)誤或執(zhí)行出錯(cuò)誤的結(jié)果。強(qiáng)烈建議，非必要，不要在XML中注釋掉SQL，可以通過版本管理工具來追溯歷史記錄和修改。

小結(jié)

本文基于Mybatis中where標(biāo)簽的使用，展開講了它的使用方式、特性以及拓展到trim標(biāo)簽的替代作用，同時(shí)，也提到了在使用時(shí)可能會(huì)出現(xiàn)的坑。內(nèi)容雖然簡(jiǎn)單，但如果能夠很好地實(shí)踐、避免踩坑也是能力的體現(xiàn)。

到此這篇關(guān)于Mybatis的where標(biāo)簽使用總結(jié)梳理的文章就介紹到這了,更多相關(guān)Mybatis的where標(biāo)簽內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: