qdbp-jdbc数据库 ORM 框架
qdbp-jdbc 简称为 qdbc,是一个数据库 ORM 框架,底层基于 Spring 的 JdbcTemplate ,完善之后希望可以成为 MyBatis 的替代品。
为什么会有这个项目?因为现有的框架用得不够爽:(更多讨论见《ORM框架的痛点讨论》)
- Hibernate 太重量级,学习成本高,用得不好容易出现性能问题;
- Spring 的 JdbcTemplate 太基础,只做了预编译参数和结果映射;
- MyBatis 要生成一大堆 xml 文件,难以维护,尤其表结构变更时,重新生成的 xml 就需要跟以前的比对,很是麻烦;
- 即使有 MyBatisGenerator 之类的工具来辅助生成代码,但由于代码是提前生成的,结构变更时依然麻烦;
- 还有一个问题,所有的框架输出预编译参数的 SQL 日志都是用问号代替参数, 如果参数很多,根据日志到数据库中重现问题的时候简直痛苦。
特点和独创内容
- 特点:对于单表增删改查,以及涉及的大于/小于/不等于/like/in 等条件,不需要写 sql 或 xml《基本用法简介》
- 特点:多表关联基础查询,以及涉及的大于/小于/不等于/like/in 等条件,不需要写 sql 或 xml《表关联查询》
- 特点:集成全局业务处理接口
提供公共字段(创建人/创建时间/修改人/修改时间/租户隔离等)的赋值接口。
集成逻辑删除解决方案。《逻辑删除数据状态填充策略》
集成数据权限解决方案。《关于数据权限的解决思路》 - 特点:集成兼容多种数据库的常用操作
兼容多种数据库的批量新增 crudDao.inserts()、批量修改 crudDao.updates() 方法
兼容多种数据库的递归查找子节点的方法 crudDao.listChildren() - 独创:SqlBuffer,一行内实现 SQL 文本与变量的统一:《关于代码中SQL书写方式的思考》
- 独创:日志中打印的 SQL,复制到数据库就能执行:《SQL日志问题排查的痛点》
- 独创:批量日志采样,批量操作日志只能在开启或关闭之间二选一?《关于批量日志的思考》
- 独创:SQL 模板中不仅可以判断数据库类型,还可以判断数据库版本:《多数据库方言支持》
SQL模板优化
复杂的查询或统计,还是要写 sql 或 xml:
- 一是因为太复杂无法封装,强行封装就会变成 hibernate,学习成本骤升,得不偿失;
- 二是独立 SQL 方便 DBA 审查,而恰恰只有这部分复杂语句才是需要审查的。
这方面也存在一些优化点:
- MyBatis 中大量的单表增删改查语句也要用到 SQL 模板,对 DBA 审查来说只是一种干扰,并不会过多关注;
- 多种数据库就需要多套模板,但实际情况往往是多套模板大体相同,只有少量差异;
- SQL 模板首先应该是 SQL,然后其中有一些 XML 的判断条件和循环语句,而不应该是 XML 格式。
详见《SQL模板说明》。
版本说明
JDK 支持 jdk1.7+
数据库:MySQL、Oracle、DB2,做了较完整的测试。详见《多数据库方言支持》的【数据库类型测试】
POM依赖
https://mvnrepository.com/artifact/com.gitee.qdbp/qdbp-jdbc-spring
<dependency> <groupId>com.gitee.qdbp</groupId> <artifactId>qdbp-jdbc-spring</artifactId> <version>3.2.6</version> </dependency>
如果不是 spring-web 项目,可以单独使用 qdbp-jdbc-core
https://mvnrepository.com/artifact/com.gitee.qdbp/qdbp-jdbc-core
<dependency> <groupId>com.gitee.qdbp</groupId> <artifactId>qdbp-jdbc-core</artifactId> <version>3.2.6</version> </dependency>
评论