qdbp-jdbc数据库 ORM 框架

联合创作 · 2023-09-30 23:53

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>

 

浏览 8
点赞
评论
收藏
分享

手机扫一扫分享

编辑 分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

编辑 分享
举报