細(xì)數(shù)那些年遇到過Mybatis的這些坑！案例+解決方案
大多數(shù)開發(fā)者應(yīng)該都使用過Hibernate或者Mybatis的框架，或多或少都踩過一些坑!
如在MyBatis/Ibatis中#和$的區(qū)別，#方式能夠很大程度防止sql注入，$方式無法防止Sql注入。所以，老司機 對新手說，最好用#。簡單的說#{}是經(jīng)過預(yù)編譯的,是安全的,而是未經(jīng)過預(yù)編譯的,僅僅是取變量的值,是非安全的,存在sql注入。有些特例是需要關(guān)注的，有的時候需要用 解決解決一些實際問題。
如在執(zhí)行sql語句時你有時并不希望讓變量進行處理，而是直接賦值執(zhí)行，這時就要用到(${a})了，在使用時還要這樣賦值 @Param(value="a") String a
如日期問題：
可能會遇到日期格式的時間段問題，當(dāng)數(shù)據(jù)庫的時間為DATE類型時，MyBatis的jdbcType應(yīng)該使用DATE
- jdbcType=DATE，
而不是使用
- jdbcType=TIMESTAMP
如在使用resultMap的時候，要把ID寫在第一行，否則的話，就會報錯。
又如最近在做的項目，遇到myBatis的大坑，Mybatis一直報異常：
- Java.lang.ArrayIndexOutOfBoundsException，
于是開始代碼查錯，代碼中有存儲過程，然后開發(fā)使用ROOT用戶執(zhí)行SQL跑出來的數(shù)據(jù)結(jié)果集是正常的，在測試環(huán)境程序運行也正常，但是在正式環(huán)境就其他用戶不行，最后發(fā)現(xiàn)是因為數(shù)據(jù)庫沒有給該用戶授權(quán)出了問題。
案例一：
作為新手，在此記下剛踩的一個坑，(踩踩更健康= =踩過痛過才不會再次錯)，寫了一個sql語句用到兩張表，兩張表中有兩個字段名字是一樣的都是Time和Content，然后要查詢這兩張表的這兩個字段都要查出來放到一個dto中，dto如下圖所示，
sql語句如下，
然而運行后卻發(fā)現(xiàn)后幾個在數(shù)據(jù)庫表里同名的字段取出來都是null，
但是放到數(shù)據(jù)庫那邊執(zhí)行是沒有取出空數(shù)據(jù)的，
真是苦惱= =，后來經(jīng)大神指點，sql語句查詢出來的這個字段名必須和dto的參數(shù)名一致，改成這樣就通過了，
數(shù)據(jù)都取出來了。。。。。。。。。。還記得在hibernate里用hql時放到dto里，select new dto名()參數(shù)順序和類型一致就可以取出來。。。這應(yīng)該算一個不同點吧，，感覺還是hql用起來舒服，，，求大神科普兩者的差別優(yōu)缺點
當(dāng)實體類中的屬性名和表中的字段名不一致時，使用MyBatis進行查詢操作時無法查詢出相應(yīng)的結(jié)果的問題，當(dāng)時上網(wǎng)查了很多才知道，看到的一個解決方法分享給大家，通過來映射字段名和實體類屬性名的一一對應(yīng)關(guān)系。這種方式是使用MyBatis提供的解決方式來解決字段名和屬性名的映射關(guān)系的!
案例二：
數(shù)據(jù)庫表使用了聯(lián)合主鍵，逆向生成的時候生成了兩個實體類。看起來別扭。但還是可以用。后來就先取消主鍵，生成完后再將主鍵加上。還有就是，tinyint本來以為用來表示比較小的整數(shù)，結(jié)果生成了布爾型的屬性。后來就表示是和否才用tinyint了。逆向生成的sql語句絕對不能人為改動，否則再次生成的時候會重復(fù)生成。但是，盡管踩過坑，我還是覺得mybatis超級好用，比hibernate好多了。雖然hibernate我只試過一點之后就完全轉(zhuǎn)向了mybatis了。
案例三：
sum()和count()使用場景不對導(dǎo)致出錯：
count()、count(1)、count(0)就是指絕對的行數(shù)，哪怕某行所有字段全部為null也會計算在內(nèi)。count(1)和count()相比，innodb來說count(*)效率低。
如果count(列名)查詢出來的結(jié)果就是查出列名中不為null的行數(shù);
sum(列名)對指定列名進行求和
MyBatis把int類型的0處理成空串’’和mysql處理空串’’為0的問題，在Mybatis的Mapper中整數(shù)類型條件該如何判斷?
當(dāng)數(shù)據(jù)庫字段類型是整數(shù)，如果參數(shù)變量為空字符串或者NULL，Mybatis會自動將參數(shù)賦值0，所以如果要判斷整數(shù)參數(shù)的多種狀態(tài)在傳遞數(shù)值到Mapper之前就要判斷是否為空字符串和NULL并將相應(yīng)的狀態(tài)數(shù)值賦值給該參數(shù)，否則參數(shù)值等于空字符串、NULL和0得到的結(jié)果是一樣的。
一般情況下，涉及到int類型的操作的時候，在Service中會統(tǒng)一把數(shù)字類型先變成字符串類型，然后再傳遞到Mapper中操作。
時間戳的使用
在創(chuàng)建新記錄的時候把這個字段設(shè)置為當(dāng)前時間，但以后修改時，不再刷新它(可以給createtime使用這個)：
TIMESTAMP DEFAULT CURRENT_TIMESTAMP
在創(chuàng)建新記錄和修改現(xiàn)有記錄的時候都對這個數(shù)據(jù)列刷新(可以給update使用這個)：
TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
在使用resultMap的時候，要把ID寫在第一行，否則的話，就會報錯。
案例四：
XML轉(zhuǎn)義字符，如果直接寫就會報錯，需要用左邊一列的轉(zhuǎn)義字符
< < 小于號 > > 大于號
& & 和
' ' 單引號
" " 雙引號
案例五：
前幾天在項目中碰到，來說下吧。大神可繞道。在使用selectOne查詢個數(shù)時，
如果你寫了resultType為Integer，然后在業(yè)務(wù)代碼中很自然的用一個變量int去接當(dāng)前這個方法的返回，如果按照你傳入的條件在數(shù)據(jù)庫中沒有找到相關(guān)的值，此時selectOne方法的返回值會是一個null，當(dāng)你使用Java的自動拆箱機制的時候會報出一個無情的NPE。
原因：Java在自動拆箱的時候會調(diào)用Integer類中的intValue方法，如果當(dāng)前對象為null，則拋出NPE。
因此，在接受的時候要判空，否則可能異常。
案例六：
多參數(shù)的使用
MyBatis的查詢或者更新中，如果需要多個參數(shù)有如下幾種辦法：
對象映射，建立一個Java對象，并作為接口的參數(shù)，對象的屬性可以直接使用#{屬性名}的方式訪問;
Map, 參數(shù)為一個Map, key對于屬性名，value對于參數(shù)值，這個方法就是傳參數(shù)是需要建立一個Map的臨時對象;
@param參數(shù)注解，在接口方法參數(shù)前加入?yún)?shù)名稱注解，這樣就可以直接在Mapper中通過參數(shù)名訪問;
通過序號訪問，第一個參數(shù)#{0}或#{param1}, 第二個參數(shù)#{1}, #{param2}
MyBatis中時間字段的使用–返回;
時間字段的返回目前筆者采用放回字符串的方式：
date_format(update_time, ‘%Y-%c-%d %H:%i:%s’) updatetime
采用MySQL的時間格式化方法。
或者放回Timestamp類型的數(shù)據(jù)，要求放回對象屬性參數(shù)為Timestamp.
MyBatis中時間字段的使用–參數(shù)
如果需要查詢一段時間范圍的數(shù)據(jù)時，可以通過以下動態(tài)SQL的方式查詢數(shù)據(jù)：
and lbr.update_time > #{startTime}
and lbr.update_time < #{endTime, javaType=Date, jdbcType=TIMESTAMP}
對于的接口方法名稱如下：
… Date startTime, Date endTime…
我想這個方法會比通過格式轉(zhuǎn)換的效率要高一些
MyBatis中時間字段的使用–寫入
寫入可是直接寫入Timestamp的數(shù)據(jù)，需要描述一些寫入的jdbcType，如下：
{installTime, jdbcType=TIMESTAMP}
Mapper層參數(shù)為Map,由Service層負(fù)責(zé)重載。
Mapper由于機制的問題，不能重載，參數(shù)一般設(shè)置成Map，但這樣會使參數(shù)變得模糊，如果想要使代碼變得清晰，可以通過service層來實現(xiàn)重載的目的，對外提供的Service層是重載的，但這些重載的Service方法其實是調(diào)同一個Mapper，只不過相應(yīng)的參數(shù)并不一致。
也許有人會想，為什么不在Service層也設(shè)置成Map呢?我個人是不推薦這么做的，雖然為了方便，我在之前的項目中也大量采用了這種方式，但很明顯會給日后的維護工作帶來麻煩。因為這么做會使你整個MVC都依賴于Map模型，這個模型其實是很不錯的，方便搭框架，但存在一個問題：僅僅看方法簽名，你不清楚Map中所擁有的參數(shù)個數(shù)、類型、每個參數(shù)代表的含義。
試想，你只對Service層變更，或者DAO層變更，你需要清楚整個流程中Map傳遞過來的參數(shù)，除非你注釋或者文檔良好，否則必須把每一層的代碼都了解清楚，你才知道傳遞了哪些參數(shù)。針對于簡單MVC，那倒也還好，但如果層次復(fù)雜之后，代碼會變得異常復(fù)雜，而且如果我增加一個參數(shù)，需要把每一個層的注釋都添加上。相對于注釋，使用方法簽名來保證這種代碼可控性會來得更可行一些，因為注釋有可能是過時的，但方法簽名一般不太可能是陳舊的。
盡量少用if choose等語句，降低維護的難度。
Mybatis的配置SQL時，盡量少用if choose 等標(biāo)簽，能用SQL實現(xiàn)判斷的盡量用SQL來判斷(CASE WHEN ,DECODE等)，以便后期維護。否則，一旦SQL膨脹，超級惡心，如果需要調(diào)試Mybatis中的SQL，需要去除大量的判斷語句，非常麻煩。另一方面，大量的if判斷，會使生成的SQL中包含大量的空格，增加網(wǎng)絡(luò)傳輸?shù)臅r間，也不可取。
而且大量的if choose語句，不可避免地，每次生成的SQL會不太一致，會導(dǎo)致ORACLE大量的硬解析，也不可取。
我們來看看這樣的SQL：
這樣的if判斷，其實是完全沒有必要的,我們可以很簡單的采用DECODE來解決默認(rèn)值問題：
當(dāng)然有人會想，引入CASE WHEN,DECODE會導(dǎo)致需要ORACLE函數(shù)解析，會拖慢SQL執(zhí)行時間，有興趣的同學(xué)可以回去做一下測試，看看是否會有大的影響。就個人經(jīng)驗而言，在我的開發(fā)過程，沒有發(fā)現(xiàn)因為函數(shù)解析導(dǎo)致SQL變慢的情形。影響SQL執(zhí)行效率的一般情況下是JOIN、ORDER BY、DISTINCT、PARTITATION BY等這些操作，這些操作一般與表結(jié)構(gòu)設(shè)計有很大的關(guān)聯(lián)。相對于這些的效率影響程度，函數(shù)解析對于SQL執(zhí)行速度影響應(yīng)該是可以忽略不計的。
另外一點，對于一些默認(rèn)值的賦值，像上面那條SQL，默認(rèn)成當(dāng)前日期什么的，其實可以完全提到Service層或Controller層做處理，在Mybatis中應(yīng)該要少用這些判斷。因為，這樣的話，很難做緩存處理。如果startdate為空，在SQL上使用動態(tài)的SYSDATE，就無法確定緩存startdate日期的key應(yīng)該是什么了。所以參數(shù)最好在傳遞至Mybatis之前都處理好，這樣Mybatis層也能減少部分if choose語句，同時也方便做緩存處理。當(dāng)然不使用if choose也并不是絕對的，有時候為了優(yōu)化SQL，不得不使用if來解決，比如說LIKE語句，當(dāng)然一般不推薦使用LIKE，但如果存在使用的場景，盡可能在不需要使用時候去除LIKE，比如查詢文章標(biāo)題，以提高查詢效率。最好的方式是使用lucence等搜索引擎來解決這種全文索引的問題?？偟膩碚f，if與choose判斷分支是不可能完全去除的，但是推薦使用SQL原生的方式來解決一些動態(tài)問題，而不應(yīng)該完全依賴Mybatis來完成動態(tài)分支的判斷，因為判斷分支過于復(fù)雜，而且難以維護。
用XML注釋取代SQL注釋。
Mybatis中原SQL的注釋盡量不要保留，注釋會引發(fā)一些問題，如果需要使用注釋，可以在XML中用來注釋，保證在生成的SQL中不會存在SQL注釋，從而降低問題出現(xiàn)的可能性。這樣做還有一個好處，就是在IDE中可以很清楚的區(qū)分注釋與SQL?，F(xiàn)在來談?wù)勛⑨屢l(fā)的問題，我做的一個項目中，分頁組件是基于Mybatis的，它會在你寫的SQL腳本外面再套一層SELECT COUNT(*) ROWNUM_ FROM (….) 計算總記錄數(shù)，同時有另一個嵌套SELECT * FROM(…) WHERE ROWNUM > 10 AND RONNUM < 10 * 2這種方式生成分頁信息，如果你的腳本中最后一行出現(xiàn)了注釋，則添加的部分會成為注釋的一部分，執(zhí)行就會報錯。除此之外，某些情況下也可能導(dǎo)致部分條件被忽略，如下面的情況：
SELECT * FROM TESTWHERE COL1 > 1 -- 這里是注釋AND COL2 = #{a}
即使傳入的參數(shù)中存在對應(yīng)的參數(shù)，實際也不會產(chǎn)生效果，因為后面的內(nèi)容實際上是被完全注釋了。這種錯誤，如果不經(jīng)過嚴(yán)格的測試，是很難發(fā)現(xiàn)的。一般情況下，XML注釋完全可以替代SQL注釋，因此這種行為應(yīng)該可以禁止掉。
盡可能使用`#{}`，而不是`${}`.
Mybatis中盡量不要使用${}，盡量這樣做很方便開發(fā)，但是有一個問題，就是大量使用會導(dǎo)致ORACLE的硬解析，拖慢數(shù)據(jù)庫性能，運行越久，數(shù)據(jù)庫性能會越差。對于一般多個字符串IN的處理，可以參考如下的解決方案:http://www.myexception.cn/sql/849573.html，基本可以解決大部分${}.
關(guān)于${}，另一個誤用的地方就是LIKE。我這邊還有個案例：比如一些樹型菜單，節(jié)點會設(shè)計成'01','0101',用兩位節(jié)點來區(qū)分層級，這時候，如果需要查詢01節(jié)點下所有的節(jié)點，最簡單的SQL便是:SELECT * FROM TREE WHERE ID LIKE '01%'，這種SQL其實無可厚非，因為它也能用到索引，所以不需要特別的處理，直接使用就行了。但如果是文章標(biāo)題，則需要額外注意了：SELECT * FROM T_NEWS_TEXT WHERE TITLE LIKE '%OSC%'，這是怎么也不會用到索引的，上面說了，最好采用全文檢索。但如果離不開LIKE，就需要注意使用的方式：ID LIKE #{ID} || '%'而不是ID LIKE '有人覺得使用||會增加ORACLE處理的時間，我覺得不要把ORACLE看得太傻，雖然有時候確實非常傻，有空可以再總結(jié)ORACLE傻不垃圾的地方，但是稍加測試便知：這種串聯(lián)方式，對于整個SQL的解析執(zhí)行，應(yīng)該是微乎其微的。當(dāng)然還有一些特殊情況是沒有辦法處理的，比如說動態(tài)注入列名、表名等。對于這些情況，則比較棘手，沒有找到比較方便的手段。由于這種情況出現(xiàn)的可能性會比較少，所以使用ID有人覺得使用∣∣會增加ORACLE處理的時間，我覺得不要把ORACLE看得太傻，雖然有時候確實非常傻，有空可以再總結(jié)ORACLE傻不垃圾的地方，但是稍加測試便知：這種串聯(lián)方式，對于整個SQL的解析執(zhí)行，應(yīng)該是微乎其微的。當(dāng)然還有一些特殊情況是沒有辦法處理的，比如說動態(tài)注入列名、表名等。對于這些情況，則比較棘手，沒有找到比較方便的手段。由于這種情況出現(xiàn)的可能性會比較少，所以使用{}倒也不至于有什么太大的影響。當(dāng)然你如果有代碼潔癖的話，可以使用ORACLE的動態(tài)執(zhí)行SQL的機制Execute immediate，這樣就可以完全避免${}出現(xiàn)的可能性了。這樣會引入比較復(fù)雜的模型，這個時候，你就需要取舍了。針對于以上動態(tài)SQL所導(dǎo)致的問題，最激進的方式是全部采用存儲過程，用數(shù)據(jù)庫原生的方式來解決，方便開發(fā)調(diào)試，當(dāng)然也會帶來問題：對開發(fā)人員會有更高的要求、存儲過程的管理等等，我這邊項目沒有采用過這種方式，這里不做更多的展開。
簡單使用Mybatis。
Mybatis的功能相對而言還是比較弱的，缺少了好多必要的輔助庫，字符串處理等等，擴展也比較困難，一般也就可能對返回值進行一些處理。因此最好僅僅把它作為單純的SQL配置文件，以及簡單的ORM框架。不要嘗試在Mybatis中做過多的動態(tài)SQL，否則會導(dǎo)致后續(xù)的維護非常惡心。
幾點技巧總結(jié)：
1、查詢很多字段時可以提出來再引入到sql語句
提?。?/p>
id, type, shopCouId, Path, fromDate, toDate, insDate, insUserId, updDate, updUserId, delFlg引入：
select
from adinfo
where id = #{id,jdbcType=INTEGER}
2、如果sql語句中需要使用<, >, "" 符號時，需要使用< > " 或者
CDATA內(nèi)部所有東西都會被解析器忽略select type, shopCouId, Pathfrom adinfoWHERE delFlg ='0'and fromDate < #{date} and toDate >= #{date}
3、緩存使用
在增刪查改時，可以使用緩存屬性控制數(shù)據(jù)緩存
4、可以判斷傳進來的參數(shù)，再進行操作
- and langCd = #{langCd,jdbcType=VARCHAR}
5、可以在sql語句中直接進行加減乘除計算，模糊查詢時，需要注意使用方式
- SELECT sum(b.netCnt) + #{netCnt,jdbcType=INTEGER}
- FROM collectcnt b
- WHERE b.shopId = #{shopId,jdbcType=INTEGER}
- AND b.delflg = '0'
- newCnt = newCnt + 1,
- netCnt = netCnt +1,
- sumCnt = sumCnt + 1,
- AND o.oTime LIKE CONCAT('%',#{sdate},'%')
MyBatis把int類型的0處理成空串’’和mysql處理空串’’為0的問題
當(dāng)數(shù)據(jù)庫字段類型是整數(shù)，如果參數(shù)變量為空字符串或者NULL，Mybatis會自動將參數(shù)賦值0，所以如果要判斷整數(shù)參數(shù)的多種狀態(tài)在傳遞數(shù)值到Mapper之前就要判斷是否為空字符串和NULL并將相應(yīng)的狀態(tài)數(shù)值賦值給該參數(shù)，否則參數(shù)值等于空字符串、NULL和0得到的結(jié)果是一樣的。
一般情況下，涉及到int類型的操作的時候，在Service中會統(tǒng)一把數(shù)字類型先變成字符串類型，然后再傳遞到Mapper中操作。
案例七：
使用mybatis 進行批量insert的時候 會自動封裝成一個map key是list 要存的數(shù)據(jù)變成了數(shù)組 需要注意在xml里面如果使用自己定義的collection要在傳參時定義一個mapkey是自己定義的變量名哦。在使用resultMap的時候，要把ID寫在第一行，否則的話，就會報錯。
優(yōu)缺點
總結(jié)下mybatis的優(yōu)缺點，以便大家對于mybatis的了解能更全面些。但我所說的優(yōu)缺點，僅是我個人總結(jié)并結(jié)合使用體驗后得出的結(jié)果，并不能代表大眾想法，因此才以“淺談”作為文章標(biāo)題。如果大家的見解與我不同，歡迎積極提出來一塊討論，我也借以彌補自己認(rèn)識的不足和短見。
優(yōu)點：
- 易于上手和掌握。
- sql寫在xml里，便于統(tǒng)一管理和優(yōu)化。
- 解除sql與程序代碼的耦合。
- 提供映射標(biāo)簽，支持對象與數(shù)據(jù)庫的orm字段關(guān)系映射
- 提供對象關(guān)系映射標(biāo)簽，支持對象關(guān)系組建維護
- 提供xml標(biāo)簽，支持編寫動態(tài)sql。
缺點：
- sql工作量很大，尤其是字段多、關(guān)聯(lián)表多時，更是如此。
- sql依賴于數(shù)據(jù)庫，導(dǎo)致數(shù)據(jù)庫移植性差。
- 由于xml里標(biāo)簽id必須唯一，導(dǎo)致DAO中方法不支持方法重載。
- 字段映射標(biāo)簽和對象關(guān)系映射標(biāo)簽僅僅是對映射關(guān)系的描述，具體實現(xiàn)仍然依賴于sql。(比如配置了一對多Collection標(biāo)簽，如果sql里沒有join子表或查詢子表的話，查詢后返回的對象是不具備對象關(guān)系的，即Collection的對象為null)
- DAO層過于簡單，對象組裝的工作量較大。
- 不支持級聯(lián)更新、級聯(lián)刪除。
- 編寫動態(tài)sql時,不方便調(diào)試，尤其邏輯復(fù)雜時。
- 8 提供的寫動態(tài)sql的xml標(biāo)簽功能簡單(連struts都比不上)，編寫動態(tài)sql仍然受限，且可讀性低。
- 若不查詢主鍵字段，容易造成查詢出的對象有“覆蓋”現(xiàn)象。
- 參數(shù)的數(shù)據(jù)類型支持不完善。(如參數(shù)為Date類型時，容易報沒有g(shù)et、set方法，需在參數(shù)上加@param)
- 多參數(shù)時，使用不方便，功能不夠強大。(目前支持的方法有map、對象、注解@param以及默認(rèn)采用012索引位的方式)
- 緩存使用不當(dāng)，容易產(chǎn)生臟數(shù)據(jù)。
總結(jié)：
mybatis的優(yōu)點其實也是mybatis的缺點，正因為mybatis使用簡單，數(shù)據(jù)的可靠性、完整性的瓶頸便更多依賴于程序員對sql的使用水平上了。sql寫在xml里，雖然方便了修改、優(yōu)化和統(tǒng)一瀏覽，但可讀性很低，調(diào)試也非常困難，也非常受限，無法像jdbc那樣在代碼里根據(jù)邏輯實現(xiàn)復(fù)雜動態(tài)sql拼接。mybatis簡單看就是提供了字段映射和對象關(guān)系映射的jdbc，省去了數(shù)據(jù)賦值到對象的步驟而已，除此以外并無太多作為，不要把它想象成hibernate那樣強大，簡單小巧易用上手，方便瀏覽修改sql就是它最大的優(yōu)點了。
mybatis適用于小型且程序員能力較低的項目和人群使用，對于中大型項目來說我并不推薦使用，如果覺得hibernate效率低的話(實際上也是使用不當(dāng)所致，hibernate是實際上是不適用于擁有高負(fù)載的工程項目)，還不如直接用spring提供的jdbc簡單框架(Template)，同樣支持對象映射。
