(四) 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。

  1. 正例:在sqlmap.xml中引入 #start#, #size#
  2. Map<String, Object> map = new HashMap<String, Object>();
  3. map.put("start", start);
  4. 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.【参考】中的compareValue是与属性值对比的常量,一般是数字,表示相等时带上此条件;表示不为空且不为null时执行;表示不为null值时执行。