Sqltoy 5.6.42版本发布：优化分组查询与日志输出功能

项目简介

Sqltoy是一个高性能的Java ORM框架，专注于简化数据库操作并提升开发效率。它提供了丰富的SQL编写方式和强大的查询功能，支持多种数据库方言，能够帮助开发者快速构建稳定高效的数据库访问层。

版本亮点

Sqltoy 5.6.42版本带来了两个重要的功能改进和缺陷修复，进一步提升了框架的稳定性和易用性。

1. 分组查询功能修复

在之前的版本中，当使用<link>标签进行分组查询并指定结果类型为List或Set时，如果最后一组数据正好是查询结果的最后一条记录，框架会出现处理遗漏的情况。这个问题在5.6.42版本中得到了彻底修复。

问题场景

考虑以下SQL查询示例：

<sql id="common_resourceRoles" debug="false" dataSource="portalDataSource">
    <link id-columns="res_url" columns="role_code" distinct="true" result-type="SET"/>
    <value>
        <![CDATA[
            select
                t3.res_url,
                t2.role_code
            from SAG_ROLE_RESOURCES t1
            left join sag_resource t3 on t3.res_id=t1.res_id
            left join sag_role t2 on t2.role_id=t1.role_id
            where t3.res_url is not null and t3.NODE_LEVEL >= 3
            and t3.status=1
            and t1.status=1
            and t3.app_code=:appCode
            order by t3.res_url
        ]]>
    </value>
</sql>

这个查询的目的是按资源URL(res_url)分组，收集每个URL对应的所有角色代码(role_code)到一个Set集合中。在修复前，如果最后一组数据只有一条记录，这组数据会被框架忽略，导致结果不完整。

修复意义

这个修复确保了分组查询结果的完整性和准确性，特别是对于边缘情况（如最后一组只有一条记录）的处理更加可靠。开发者在处理权限、资源关联等场景时，可以完全信赖框架的分组功能。

2. 日志输出优化

5.6.42版本对SQL日志输出进行了重要优化，特别是对日期和时间类型参数的处理更加友好和准确。

改进内容

在之前的日志输出中，日期时间参数直接以原始值形式显示，这在实际调试时可能不够直观。新版本中，当日志输出包含日期或时间类型参数时，框架会自动添加相应的数据库转换函数，使日志中的SQL语句更接近实际执行的格式。

例如，一个包含日期参数的查询在日志中会显示为：

select * from table where create_time=to_date('2024-10-11 12:30:11.039','YYYY-MM-DD HH24:MI:SS.FF3')

而不是简单的：

select * from table where create_time='2024-10-11 12:30:11.039'

优化价值

这一改进带来了几个显著优势：

1. 调试友好：日志输出的SQL可以直接复制到数据库客户端执行，无需手动添加日期转换函数
2. 格式统一：不同数据库的日期格式差异被规范化处理
3. 精确性：毫秒级精度被明确保留，避免了隐式转换可能导致的精度损失

版本兼容性

Sqltoy 5.6.42版本提供了多种集成方式，满足不同技术栈的需求：

• 原生集成：使用sagacity-sqltoy核心库
• SpringBoot集成：使用sagacity-sqltoy-spring-starter
• Solon框架集成：使用sagacity-sqltoy-solon-plugin

对于仍在使用JDK8的用户，框架提供了专门的JRE8兼容版本（版本号后缀为.jre8）。

升级建议

对于正在使用Sqltoy的项目，特别是以下情况，建议升级到5.6.42版本：

1. 项目中大量使用<link>分组查询功能
2. 需要精确调试包含日期时间参数的SQL语句
3. 使用List或Set作为分组结果集合类型的场景

升级过程通常只需修改依赖版本号即可，无需额外配置或代码变更。

总结

Sqltoy 5.6.42版本虽然是一个小版本更新，但解决了一些实际开发中可能遇到的痛点问题。分组查询功能的修复确保了数据处理的完整性，日志输出的优化则提升了开发调试的效率。这些改进体现了Sqltoy框架对开发者体验的持续关注和对稳定性的不懈追求。