ORM規(guī)約
1. 【強(qiáng)制】在表查詢(xún)中,一律不要使用 * 作為查詢(xún)的字段列表,需要哪些字段必須明確寫(xiě)明。
說(shuō)明:1 ) 增加查詢(xún)分析器解析成本。2 ) 增減字段容易與 resultMap 配置不一致。
2. 【強(qiáng)制】 POJO 類(lèi)的 boolean 屬性不能加 is ,而數(shù)據(jù)庫(kù)字段必須加 is _,要求在 resultMap 中進(jìn)行字段與屬性之間的映射。
說(shuō)明:參見(jiàn)定義 POJO 類(lèi)以及數(shù)據(jù)庫(kù)字段定義規(guī)定,在 sql . xml 增加映射,是必須的。
3. 【強(qiáng)制】不要用 resultClass 當(dāng)返回參數(shù),即使所有類(lèi)屬性名與數(shù)據(jù)庫(kù)字段一一對(duì)應(yīng),也需要定義 ; 反過(guò)來(lái),每一個(gè)表也必然有一個(gè)與之對(duì)應(yīng)。
說(shuō)明:配置映射關(guān)系,使字段與 DO 類(lèi)解耦,方便維護(hù)。
4. 【強(qiáng)制】 xml 配置中參數(shù)注意使用:#{},# param # 不要使用${} 此種方式容易出現(xiàn) SQL 注入。
5. 【強(qiáng)制】 iBATIS 自帶的 queryForList(String statementName , int start , int size) 不推薦使用。
說(shuō)明:其實(shí)現(xiàn)方式是在數(shù)據(jù)庫(kù)取到 statementName 對(duì)應(yīng)的 SQL 語(yǔ)句的所有記錄,再通過(guò) subList取 start , size 的子集合,線(xiàn)上因?yàn)檫@個(gè)原因曾經(jīng)出現(xiàn)過(guò) OOM 。
正例:在 sqlmap . xml 中引入 #start#, #size#
Map<String, Object> map = new HashMap<String, Object>(); map.put("start", start); map.put("size", size);
6. 【強(qiáng)制】不允許直接拿 HashMap 與 Hashtable 作為查詢(xún)結(jié)果集的輸出。
7. 【強(qiáng)制】更新數(shù)據(jù)表記錄時(shí),必須同時(shí)更新記錄對(duì)應(yīng)的 gmt _ modified 字段值為當(dāng)前時(shí)間。
8. 【推薦】不要寫(xiě)一個(gè)大而全的數(shù)據(jù)更新接口,傳入為 POJO 類(lèi),不管是不是自己的目標(biāo)更新字段,都進(jìn)行 update table set c1=value1,c2=value2,c3=value3; 這是不對(duì)的。執(zhí)行 SQL時(shí),盡量不要更新無(wú)改動(dòng)的字段,一是易出錯(cuò) ; 二是效率低 ; 三是 binlog 增加存儲(chǔ)。
9. 【參考】@ Transactional 事務(wù)不要濫用。事務(wù)會(huì)影響數(shù)據(jù)庫(kù)的 QPS ,另外使用事務(wù)的地方需要考慮各方面的回滾方案,包括緩存回滾、搜索引擎回滾、消息補(bǔ)償、統(tǒng)計(jì)修正等。
10. 【參考】< isEqual >中的 compareValue 是與屬性值對(duì)比的常量,一般是數(shù)字,表示相等時(shí)帶上此條件 ; < isNotEmpty >表示不為空且不為 null 時(shí)執(zhí)行 ; < isNotNull >表示不為 null 值時(shí)
執(zhí)行。