文 | 学者学者
各位屏幕前的读者朋友大家早上中午晚上凌晨好，本文是《码出规范》专题的第十九篇，ORM映射规范。文中参考阿里巴巴最新发布的《Java开发手册》，结合《springboot2.x独门秘籍》专题中的项目开发进度，学以致用，让你在开发中码出高效，码出质量。本专题所得收入均捐赠公益事情，希望用技术情怀帮助更多的人。
| 注释规约 | 代码格式 |
|---|---|
| 命名风格 | 常量定义 |
| 并发处理 | 集合处理 |
| OOP规约 | 日志规约 |
| 单元测试 | ...更多 |
关于MySQL数据库相关的规范，总计分为四篇文章来讲解，本文是第四篇：ORM映射规范。
强烈推荐做后端开发的程序员朋友认真学习学习MySQL数据库，因为工作以后首先接触到、并且工作头两年用到最多的一定是MySQL数据库。
-
【强制】在表查询中，一律不要使用 * 作为查询的字段列表，需要哪些字段必须明确写明。
说明：
1）增加查询分析器解析成本。
2）增减字段容易与 resultMap 配置不一致。
3）无用字段增加网络消耗，尤其是 text 类型的字段。 -
【强制】POJO 类的布尔属性不能加 is，而数据库字段必须加 is_，要求在 resultMap 中进行字段与属性之间的映射。
说明：参见定义 POJO 类以及数据库字段定义规定，在<resultMap>中增加映射，是必须的。在MyBatis Generator 生成的代码中，需要进行对应的修改。 -
【强制】不要用 resultClass 当返回参数，即使所有类属性名与数据库字段一一对应，也需要定义；反过来，每一个表也必然有一个 POJO 类与之对应。
说明：配置映射关系，使字段与 DO 类解耦，方便维护。 -
【强制】sql.xml 配置参数使用：#{}，#param# 不要使用${} 此种方式容易出现 SQL 注入。
-
【强制】iBATIS 自带的 queryForList(String statementName,int start,int size)不推荐使用。
说明：其实现方式是在数据库取到 statementName 对应的 SQL 语句的所有记录，再通过 subList 取start,size 的子集合。
正例：Map<String, Object> map = new HashMap<>();
map.put("start", start);
map.put("size", size);
-
【强制】不允许直接拿 HashMap 与 Hashtable 作为查询结果集的输出。
说明：resultClass=”Hashtable”，会置入字段名和属性值，但是值的类型不可控。 -
【强制】更新数据表记录时，必须同时更新记录对应的 gmt_modified 字段值为当前时间。
-
【推荐】不要写一个大而全的数据更新接口。传入为 POJO 类，不管是不是自己的目标更新字段，都进行 update table set c1=value1,c2=value2,c3=value3; 这是不对的。执行 SQL时，不要更新无改动的字段，一是易出错；二是效率低；三是增加 binlog 存储。
- 【参考】@Transactional 事务不要滥用。事务会影响数据库的 QPS，另外使用事务的地方需要考虑各方面的回滚方案，包括缓存回滚、搜索引擎回滚、消息补偿、统计修正等。
10.【参考】<isEqual>中的 compareValue 是与属性值对比的常量，一般是数字，表示相等时带上此条件；<isNotEmpty>表示不为空且不为 null 时执行；<isNotNull>表示不为 null 值时执行。
一如既往，期待您的真知灼见…，《码出规范》系列文章以及大厂内部资料将持续更新，如需获取资料或实战案例源码，欢迎点击我的主页呼叫我，乐意为你解决开发中的疑难杂症。
网友评论