BeetlSQL 3.37 发布，增加多对多自动 Fetch

　　发布于2026-08-25　阅读（0）

扫一扫，手机访问

BeetlSQL 从 2015 年就开始投入研发了，核心模块和周边生态组件全都自己动手实现，没有依赖任何第三方 ORM 的内核。它的设计目标很直白：让开发者用得顺手、维护起来轻松、运行起来高效。说白了，就是想要一个学习成本极低、适用场景广泛、还能高度定制化的数据库访问框架。

接下来看看这次版本更新带来的几个实用变化。

修复了 SQL Server 在某些场景下无法正确读取表元数据的问题
Fetch 功能新增了对多对多关系的自动加载支持
底层模板引擎 Beetl 升级到了最新的 3.20.1 版本

Fetch 这块新增了一个 @FetchMany2Many 注解，配套提供了 FetchMany2ManyAction 类（配合 @Builder 使用）。这样一来，通过中间表自动拉取多对多关联数据就变得非常自然。来看看注解的定义：

@Retention(RetentionPolicy.RUNTIME)
@Target(value = {ElementType.METHOD, ElementType.FIELD})
@Builder(FetchMany2ManyAction.class)
public @interface FetchMany2Many {
    Class tableClass();       // 中间表对应的实体类
    String fromAttr();        // 当前实体在中间表中的外键字段名
    String toAttr();          // 关联实体在中间表中的外键字段名
    String enableOn() default ""; // 启用条件表达式（可选）
}

实际使用的时候，代码非常简洁：

@Table(name="sys_user")
public class MyUser {
    @AutoID
    Integer id;
    String name;
    @FetchMany2Many(tableClass = UserRole.class, fromAttr = "userId", toAttr = "roleId")
    List roles;
}

BeetlSQL 核心模块说明

BeetlSQL 核心模块	功能
sql-core	基础核心包，封装 JDBC 调用、SQL 文件管理、注解解析等核心能力
sql-fetch	提供类似 Hibernate 的 `@Fetch`、`@FetchMany` 等懒加载/预加载注解支持
sql-mapper	Mapper 接口定义与扩展机制，支持用户自定义 Mapper 及其专属注解
sql-intergration	集成主流框架（如 Spring、Solon、JFinal）的适配器与完整示例
sql-query	Query 与 LambdaQuery 接口，支持通过 Ja va API 构建并执行 SQL
sql-mapping	单表/多表与 POJO 的双向映射能力，支持 JSON、XML 或约定优先等多种配置方式
sql-template	基于 Beetl 模板引擎实现 SQL 渲染，同时兼容其他模板语言扩展
sql-gen	代码生成抽象层，内置默认实现，可一键生成 DAO、SQL 文件、接口文档等
sql-db-support	覆盖 33+ 种数据库的兼容性测试与驱动验证
sql-samples	涵盖上百个典型业务场景的实战案例
sql-test	包含数百个高质量单元测试用例，保障稳定性与可靠性

BeetlSQL 官方扩展插件列表

BeetlSQL 扩展包	功能
sql-xml	仿 MyBatis XML 风格语法支持，适合习惯用 XML 编写 SQL 的开发者
sql-accelerator	性能增强插件，通过反射优化、缓存策略等手段，使性能提升 50%–200%，逼近手写 JDBC 效率
sql-firewall	SQL 防御模块，防止误操作导致的数据破坏或敏感信息泄露
sql-dynamic-table	动态表访问支持，让程序像操作静态表一样处理运行时创建的表结构
sql-bean-encrypt	字段级加解密支持，内置 `@MD5`、`@AES` 等常用加密注解
sql-rewrite	SQL 重写引擎，支持单表多租户、逻辑删除、数据权限控制等功能
SAGA（实验性）	基于 SAGA 模式的分布式事务实现，服务于微服务架构下的事务一致性需求

启用加速插件后的性能对比：最高可以跑到原生 JDBC 性能的一半左右。下面列出了各种常见操作的具体数据。

查询类型	测试场景	BeetlSQL (ops/ms)	纯 JDBC	MyBatis	JPA
beetlsqlExecuteJdbc	直接执行 JDBC 语句	318	678	/	64
beetlsqlExecuteTemplate	执行 Beetl SQL 模板	268	/	44	66
beetlsqlFile	SQL 统一存放于文件中管理	266	/	41	/
beetlsqlInsert	单条记录插入	129	248	43	59
beetlsqlGetAll	全量数据查询	13	40	4	5
beetlsqlLambdaQuery	使用 LambdaQuery 构建并执行查询	196	/	9	/
beetlsqlPageQuery	分页查询操作	159	/	17	59
beetlsqlSelectById	根据主键查询单条记录	259	670	43	61

再来看一下更全面的 JMH 基准测试结果（单位：ops/ms），涵盖了多个框架的对比：

Benchmark                                  Mode  Cnt     Score      Error   Units
Beetl.addEntity                           thrpt    5   133.190 ±   38.548  ops/ms
Beetl.complexMapping                      thrpt    5   236.289 ±  288.370  ops/ms
Beetl.executeJdbcSql                      thrpt    5   298.657 ±   80.480  ops/ms
Beetl.executeTemplateSql                  thrpt    5   251.418 ±   77.757  ops/ms
Beetl.getAll                              thrpt    5    14.531 ±    0.605  ops/ms
Beetl.getEntity                           thrpt    5   359.275 ±   85.099  ops/ms
Beetl.lambdaQuery                         thrpt    5   187.228 ±   59.697  ops/ms
Beetl.one2Many                            thrpt    5   178.041 ±  181.829  ops/ms
Beetl.pageQuery                           thrpt    5   148.982 ±   39.327  ops/ms
Beetl.sqlFile                             thrpt    5   249.206 ±  100.083  ops/ms
DBVisitor.addEntity                       thrpt    5    99.294 ±   33.564  ops/ms
DBVisitor.executeJdbcSql                  thrpt    5   185.177 ±   50.993  ops/ms
DBVisitor.executeTemplateSql              thrpt    5     3.189 ±    0.748  ops/ms
DBVisitor.getAll                          thrpt    5     3.163 ±    0.980  ops/ms
DBVisitor.getEntity                       thrpt    5   125.683 ±   44.190  ops/ms
DBVisitor.lambdaQuery                     thrpt    5    94.314 ±   38.499  ops/ms
DBVisitor.pageQuery                       thrpt    5    49.954 ±   18.254  ops/ms
EasyQuery.addEntity                       thrpt    5    98.904 ±   39.890  ops/ms
EasyQuery.complexMapping                  thrpt    5    67.397 ±   59.919  ops/ms
EasyQuery.executeJdbcSql                  thrpt    5   243.160 ±   48.080  ops/ms
EasyQuery.getAll                          thrpt    5    14.896 ±    2.219  ops/ms
EasyQuery.getEntity                       thrpt    5   134.370 ±   67.962  ops/ms
EasyQuery.lambdaQuery                     thrpt    5   137.292 ±   53.438  ops/ms
EasyQuery.one2Many                        thrpt    5    75.083 ±   53.738  ops/ms
EasyQuery.pageQuery                       thrpt    5    84.596 ±   46.942  ops/ms
Flex.addEntity                            thrpt    5    86.484 ±   40.022  ops/ms
Flex.getAll                               thrpt    5     2.926 ±    0.993  ops/ms
Flex.getEntity                            thrpt    5    73.445 ±   39.437  ops/ms
Flex.pageQuery                            thrpt    5    33.999 ±   26.776  ops/ms
Jdbc.addEntity                            thrpt    5   225.223 ±  304.585  ops/ms
Jdbc.executeJdbcSql                       thrpt    5   691.616 ±  145.280  ops/ms
Jdbc.getAll                               thrpt    5    35.827 ±    7.295  ops/ms
Jdbc.getEntity                            thrpt    5   678.791 ±  165.527  ops/ms
Jpa.addEntity                             thrpt    5    53.219 ±   78.543  ops/ms
Jpa.executeJdbcSql                        thrpt    5    60.734 ±   61.299  ops/ms
Jpa.executeTemplateSql                    thrpt    5    64.478 ±   48.688  ops/ms
Jpa.getAll                                thrpt    5     4.710 ±    2.062  ops/ms
Jpa.getEntity                             thrpt    5    56.325 ±   53.744  ops/ms
Jpa.one2Many                              thrpt    5    92.168 ±  111.591  ops/ms
Jpa.pageQuery                             thrpt    5    58.756 ±   48.056  ops/ms
MyBatis.addEntity                         thrpt    5    40.533 ±   12.461  ops/ms
MyBatis.complexMapping                    thrpt    5   106.348 ±   57.688  ops/ms
MyBatis.executeTemplateSql                thrpt    5    46.953 ±   13.541  ops/ms
MyBatis.getAll                            thrpt    5     5.394 ±    0.502  ops/ms
MyBatis.getEntity                         thrpt    5    45.303 ±   11.928  ops/ms
MyBatis.lambdaQuery                       thrpt    5    23.756 ±   13.613  ops/ms
MyBatis.pageQuery                         thrpt    5    16.190 ±    5.682  ops/ms
MyBatis.sqlFile                           thrpt    5    42.558 ±   18.025  ops/ms
SqlUtils.addEntity                        thrpt    5   232.501 ±  332.656  ops/ms
SqlUtils.executeJdbcSql                   thrpt    5   682.610 ±  171.506  ops/ms
SqlUtils.getAll                           thrpt    5    44.353 ±    4.346  ops/ms
SqlUtils.getEntity                        thrpt    5   643.873 ±  131.587  ops/ms
Wood.addEntity                            thrpt    5   105.097 ±   79.961  ops/ms
Wood.executeJdbcSql                       thrpt    5   127.020 ±   48.142  ops/ms
Wood.executeTemplateSql                   thrpt    5   129.193 ±   44.455  ops/ms
Wood.getAll                               thrpt    5     2.051 ±    0.524  ops/ms
Wood.getEntity                            thrpt    5   126.104 ±   41.976  ops/ms
Wood.lambdaQuery                          thrpt    5   125.013 ±   43.991  ops/ms
Wood.pageQuery                            thrpt    5   220.101 ±   90.028  ops/ms
Wood.sqlFile                              thrpt    5   132.431 ±   50.141  ops/ms

本文转载于：https://www.php.cn/faq/2008655.html?uid=1246273 如有侵犯，请联系zhengruancom@outlook.com删除。
免责声明：正软商城发布此文仅为传递信息，不代表正软商城认同其观点或证实其描述。

上一篇：格力电器车用碳化硅芯片将量产

下一篇：告别超薄UTG？曝三星Wide Fold UTG或增厚至60微米

产品推荐

售后无忧
立即购买>

DAEMON Tools Lite 10

￥0.00
office旗舰店
售后无忧
立即购买>

DAEMON Tools Ultra 5

￥0.00
office旗舰店
售后无忧
立即购买>

DAEMON Tools Pro 8

￥0.00
office旗舰店
售后无忧
立即购买>

CorelDRAW X8 简体中文

￥0.00
office旗舰店

正版软件

A股异动丨PCB概念继续强势，生益电子、沪电股份、生益科技大面积个股创历史新高

6月17日，A股PCB概念板块强势爆发，多只个股涨停或创历史新高。直接催化剂是全球覆铜板龙头建滔积层板于6月16日宣布涨价15%，这反映出上游原材料供需失衡及生产成本持续高企，市场预期产业链传导效应将推动板块进一步走强。

8分钟前 0
正版软件

荣耀600和vivos60哪个值得买？性价比与体验取舍分析

荣耀600与vivoS60同为中端机型，但侧重点不同：vivoS60主打颜值、手感和影音娱乐，适合轻度社交与换机频繁的用户；荣耀600更重硬件堆料与综合性价比，暗光人像和前置防抖表现突出，适合追求全面实况影像的主力机需求。选购取决于个人使用周期与核心需求。

8分钟前 0
正版软件

荣耀600系列和vivos60系列哪个好？两条产品线详细比

荣耀600系列与vivoS60系列各有三款机型。前者主打综合配置与影像，电池容量大、防水等级高；后者突出快充、轻薄与运镜玩法。用户可根据对均衡耐久或轻快娱乐的需求选择，前者适合全面体验，后者适合便携拍摄。

8分钟前 0
正版软件

荣耀600和vivos60选哪个新手购机不踩坑指南

荣耀600与vivoS60价位相近但定位不同：vivoS60主打休闲娱乐与简约质感；荣耀600则为全能主力，支持全焦段4K、暗光人像、前置OIS防抖及8600mAh电池，综合体验更均衡，适合长期省心使用。

9分钟前 0
正版软件

目前最强拍照手机动态影像标杆荣耀600 Pro

荣耀600Pro凭借全焦段4K动态影像、智能补光体系及全天候稳定成像，打破传统手机静态强动态弱的局限，实现动静全能、光影可控，成为兼顾日常记录与专业创作的标杆级影像旗舰。

9分钟前 0

BeetlSQL 3.37 发布，增加多对多自动 Fetch

BeetlSQL 核心模块说明

BeetlSQL 官方扩展插件列表

产品推荐

最新发布

相关推荐

热门关注