ORM规约


1. 【强制】在表查询中,一律不要使用 * 作为查询的字段列表,需要哪些字段必须明确写明。

说明:1 ) 增加查询分析器解析成本。2 ) 增减字段容易与 resultMap 配置不一致。


2. 【强制】 POJO 类的 boolean 属性不能加 is ,而数据库字段必须加 is _,要求在 resultMap 中进行字段与属性之间的映射。

说明:参见定义 POJO 类以及数据库字段定义规定,在 sql . xml 增加映射,是必须的。


3. 【强制】不要用 resultClass 当返回参数,即使所有类属性名与数据库字段一一对应,也需要定义 ; 反过来,每一个表也必然有一个与之对应。

说明:配置映射关系,使字段与 DO 类解耦,方便维护。


4. 【强制】 xml 配置中参数注意使用:#{},# param # 不要使用${} 此种方式容易出现 SQL 注入。


5. 【强制】 iBATIS 自带的 queryForList(String statementName , int start , int size) 不推荐使用。

说明:其实现方式是在数据库取到 statementName 对应的 SQL 语句的所有记录,再通过 subList取 start , size 的子集合,线上因为这个原因曾经出现过 OOM 。

正例:在 sqlmap . xml 中引入 #start#, #size#

Map<String, Object> map = new HashMap<String, Object>();
map.put("start", start);
map.put("size", size);


6. 【强制】不允许直接拿 HashMap 与 Hashtable 作为查询结果集的输出。


7. 【强制】更新数据表记录时,必须同时更新记录对应的 gmt _ modified 字段值为当前时间。


8. 【推荐】不要写一个大而全的数据更新接口,传入为 POJO 类,不管是不是自己的目标更新字段,都进行 update table set c1=value1,c2=value2,c3=value3;  这是不对的。执行 SQL时,尽量不要更新无改动的字段,一是易出错 ; 二是效率低 ; 三是 binlog 增加存储。


9. 【参考】@ Transactional 事务不要滥用。事务会影响数据库的 QPS ,另外使用事务的地方需要考虑各方面的回滚方案,包括缓存回滚、搜索引擎回滚、消息补偿、统计修正等。


10. 【参考】< isEqual >中的 compareValue 是与属性值对比的常量,一般是数字,表示相等时带上此条件 ; < isNotEmpty >表示不为空且不为 null 时执行 ; < isNotNull >表示不为 null 值时

执行。