[开源项目] Java 动态 SQL 构建框架 - Dynamic-SQL2 - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
请不要在回答技术问题时复制粘贴 AI 生成的内容
null123456

[开源项目] Java 动态 SQL 构建框架 - Dynamic-SQL2

  •  
  •   null123456 2 月 25 日 1736 次点击
    这是一个创建于 58 天前的主题,其中的信息可能已经有所发展或是发生改变。

    Dynamic-SQL2 是一个 纯 Java 、低侵入、跨数据库、可组合的动态 SQL 构建框架。它提供 优雅的 DSL 风格 API ,让你可以像写代码一样构建 SQL ,同时保持 SQL 的表达力与可控性。

    它不是完整的 ORM ,也不是 MyBatis 的替代品,而是定义为 Lightweight ORM / Micro ORM:

    补足传统 ORM 在“动态 SQL + 多表查询 + 跨库兼容 + 类型检查”上的空白和拓展。

    适用于 企业级业务系统、SaaS 平台、多租户架构、复杂动态查询场景。

    核心特性:

    • 动态 SQL 构建:链式 DSL ,告别字符串拼接
    • 跨数据库兼容:内置 MySQL / Oracle / DB2 方言
    • 高级 SQL 支持:子查询、窗口函数、CTE 、递归查询
    • 现代化分页:支持 List / Map / 一对多结构分页
    • Spring 友好:可与 Spring 、JDBC 、MyBatis 灵活组合
    • 可扩展性强:自定义函数、条件生成器、值解析器
    • 可测试性强:SQL 由 Java 构建,天然适合单元测试
    • 专业日志模块:结构化、可自定义、可读性极高的 SQL 输出
    • 提升团队协作和代码一致性:遵循统一的 SQL 构建方式,确保代码的一致性和可读性

    项目地址 https://github.com/pengweizhong/dynamic-sql2

    20 条回复    2026-04-06 20:37:09 +08:00
    a0210077
        1
    a0210077  
       2 月 25 日
    轮子不错,但企业级一般用完整的稳定的 ORM 框架,暂时还没想到特别合适的应用场景。
    Jackysunhp
        2
    Jackysunhp  
       2 月 25 日
    让我想到了 ES 的 DSL 语句转 SDK ,对于看 sql 的时候不直观, 捞 sql 定位问题不是很方便吧。
    bojue
        3
    bojue  
       2 月 25 日
    @a0210077 我们自研的 ORM 框架,可以适配一个前端低代码或者代码生产工具是不是有点市场,我公司之前买了一套适配的前端 200 万
    a0210077
        4
    a0210077  
       2 月 25 日
    @bojue 确实可以,低代码平台和代码工具是个不错的方向。不过 OP 的项目与您说的方向上有点差异
    dcsuibian
        5
    dcsuibian  
       2 月 25 日
    感觉,有点像 jOOQ 啊
    bojue
        6
    bojue  
       2 月 25 日
    @a0210077 #4 我知道 op 的意思,我看你说到了应用场景刚好我们搞过,现在客户基本上还是以整体方案为主,单点方案得话要 op 给用户讲清楚就行,罗列功能吸引力不大了,尤其现在有 ai
    ikas
        7
    ikas  
       2 月 25 日
    看了首页的例子.没有看到怎么根据参数动态加条件的?

    比如我们用的:

    public interface PetDao {
    @SelectProvider(type = PetMapperSql.class)
    List<Pet> queryPet(@Param("param") PetQueryParam param);
    }


    public class PetMapperSql extends BaseMapperSql {
    public SelectModel queryPet(@Param("param") PetQueryParam param) {
    return select(Pet.id, Pet.name, Pet.petType, Pet.birthday, Pet.updateTime)
    .from(Pet)
    .where().and(Pet.name, isLikeWhenPresent(param.getName()).then(x -> "%" + x + "%"))
    .and(Pet.birthday, isGreaterThan(param.getBirthdayStart()).when(Objects::nonNull))
    .and(Pet.birthday, isLessThanWhenPresent(param.getBirthdayEnd()))
    .build();
    }

    }

    .and(Pet.birthday, isGreaterThan(param.getBirthdayStart()).when(Objects::nonNull))
    xuld
        8
    xuld  
       2 月 25 日
    初步看了下,和我的想法比较接近,有没有群可以深度交流下
    micean
        9
    micean  
       2 月 25 日
    这种有 jOOQ 就已经够了,稍微复杂一点脑子里还得转一遍 SQL 。
    如果能整一个嵌套 dsl 转 sql ,查询结果直接返回 json 还差不多,jimmer 实现的我觉得还不够完美友好
    null123456
        10
    null123456  
    OP
       3 月 1 日
    @a0210077 是的 所以推广起来很难
    null123456
        11
    null123456  
    OP
       3 月 1 日
    @Jackysunhp 只能看打印的 SQL ,和 xml 区别不是太大,因为基本都是按照 SQL 语义写的 DSL 代码
    null123456
        12
    null123456  
    OP
       3 月 1 日
    @bojue 确实,也可以做,适配下低代码平台,但我们毕竟都是打工的牛马,平常加班都累成了
    null123456
        13
    null123456  
    OP
       3 月 1 日
    @dcsuibian 是的 我后来也发现了,但是当时我并没有看 JOOQ ,事后觉得好的解决方案都是类似的,jooq 大而全,覆盖场景广,但是侵入太大,dynamic-sql2 小而美,比较有业务针对性,侵入极低
    null123456
        14
    null123456  
    OP
       3 月 1 日
    @xuld 有的,我也特别期盼向您这样志同道合的朋友,QQ 群:749973146
    null123456
        15
    null123456  
    OP
       3 月 1 日
    @ikas 您描述的这些功能都是有的,我还有些疑问,像:Pet.id, Pet.name, Pet.petType, Pet.birthday, Pet.updateTime 这些字段都是常量吗?还是普通字符串?
    null123456
        16
    null123456  
    OP
       3 月 1 日
    @micean 这个 toJSON 其实是变相支持的,因为 dynamic-sql2 可以直接返回原始 map ,调用方手动转下 JSON 就可以了。当然 dynamic-sql2 可以直接转 JSON 后输出,但是这会让它越来越臃肿,而且每个人喜欢的 json 格式化组件也不一样,所以目前来说,不计划直接引入该功能
    bojue
        17
    bojue  
       3 月 1 日
    @null123456 #12 这个就是我手上的一部分工作,在公司做的

    1. 我们 22-23 年做了一版本被被一个沙雕暂定了
    2. 最近有启动了一部分,前端 jsonSchame 配置作为开发,简单的就是传递一个表单作为 Entity,Form+Table JSON 化配置已经很成熟了,整个项目做了重构完成完全 cover80%-90%的任务
    3. 接下来把 JSON 配置抽象成 3 部分工程任务:
    a.将代码开发模版抽象成脚手架模版 b.将 json 配置表单化 c.集成拖拉拽的交互
    ikas
        18
    ikas  
       3 月 5 日
    @null123456 翻看测试用例看到用法了.不是字符串,是根据实体使用注解处理器生成的 table 与 column 结构
    null123456
        19
    null123456  
    OP
       17 天前 via Android
    @bojue 很棒,程序员就是需要不断的重构
    null123456
        20
    null123456  
    OP
       17 天前 via Android
    @ikas 是的,但是注解处理器加入后又移除了,因为负担太多,我的想法是尽量简洁
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     5409 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 78ms UTC 06:43 PVG 14:43 LAX 23:43 JFK 02:43
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86