v6.7.0 (2026-02-15)
<dependency>
<groupId>net.hasor</groupId>
<artifactId>dbvisitor</artifactId>
<version>6.7.0</version>
</dependency>
主要看点
-
新增 jdbc-milvus 驱动模块和 VectorSqlDialect 接口,Lambda API 支持向量范围查询与排序查询,适配 PostgreSQL、Elastic7/8、Milvus 三类数据源。
-
通过 JulianDayTypeHandler、PgDateTypeHandler、PgVectorTypeHandler 三个 TypeHandler,扩展日期与向量类型处理能力。详细解读 →
-
新增 queryForPairs 方法,支持将查询结果两列直接映射为 Map<K, V>。详细解读 →
-
修复 AbstractDialect.fmtName() 标识符注入漏洞(Freedom 模式),统一所有方言的转义逻辑。
-
贯通 @Insert 注解和 XML 映射器的 useGeneratedKeys 执行路径,主键可正确回填。
影响范围
-
dbvisitor 核心模块:TypeHandler 扩展、Fluent API(向量查询)、动态 SQL 引擎、分页、DAO 代理、安全性修复。
-
dbvisitor-adapter 模块:新增 jdbc-milvus 驱动。
-
dbvisitor-driver 模块:JdbcResultSet Array 类型兼容性增强。
-
方言系统(Dialect):新增 Elastic8Dialect、VectorSqlDialect;PostgreSQL 方言新增序列支持、SQL 生成修复、标识符转义安全加固。
-
集成模块:新增 Spring Boot 4 兼容示例。
更新内容
-
新增
-
新增 jdbc-milvus 驱动模块,完成 Milvus 向量数据库适配(支持 DB/Index/Partition/Table 命令、DML 语句、Hint)。
-
新增 Elastic8Dialect 方言,支持 Elasticsearch 8.x。
-
新增 VectorSqlDialect 接口,Lambda API 支持向量范围查询和向量排序查询(适配 PostgreSQL、Elastic7/8、Milvus)。
-
新增 QueryCompare、QueryFunc 接口 6 种向量度量模式的细粒度向量查询支持。
-
新增 JulianDayTypeHandler,使用儒略日数统一存储公元前后日期,避免历法转换歧义。
-
新增 PgDateTypeHandler,利用 PostgreSQL 原生 BC 后缀格式处理公元前日期。
-
新增 PgVectorTypeHandler,处理 PostgreSQL pgvector 向量类型数据读写。详细解读 →
-
新增 GeneratedKeyHandler 接口 useGeneratedKeys 方法。
-
新增 QueryFunc 接口 queryForPairs、queryForPairsByName 方法,将查询结果两列直接映射为 Map<K, V>。
-
新增 JsonArrayList、JsonHashMap、JsonHashSet、JsonType 四个类型,用于 queryForObject 查询 JSON 数据类型时的结构转换。
-
新增 Spring Boot 4 兼容示例工程。
-
优化
-
优化 JdbcResultSet.getArray() 方法,自动适配 List/Set/Object[]/Primitive Array 为 java.sql.Array。
-
优化 #{field, typeHandler=...} 对 null 值的处理,自动推断 JDBC 类型,无需显式指定 jdbcType。
-
PostgreSQL 方言实现 SeqSqlDialect 接口,新增序列查询支持(selectSeq)。
-
修复
-
修复 @Insert 注解的 useGeneratedKeys 属性行为和 XML 映射器的 useGeneratedKeys 行为不一致问题。
-
修复 queryForMap 查询全 null 行时抛出 NPE 的问题。
-
修复 @Table 注解仅配置 ddlAuto 属性时无法被获取到的问题。
-
修复 JdbcTemplate.loadSplitSQL() 对注释开头的 SQL 片段被错误跳过的问题。
-
修复 @BindTypeHandler 注解的 Map 子类被误当作普通 Map 处理的问题。
-
修复 ArrayTypeHandler 对 PostgreSQL 空数组返回 null 的问题(补充内部类型名映射)。
-
修复 apply() 拼接原生 SQL 片段时缺少 AND/OR 连接符的问题。
-
修复 PostgreSqlDialect 的 insertIgnore(缺少 INTO)和 insertReplace(SET 子句无逗号)SQL 生成错误。
-
修复 usePage() 方法中分页偏移计算异常(调用顺序错误)。
-
修复 <where>/<set> 动态标签对大写前缀(AND/OR)剥离失败的问题。
-
修复 @{and}/@{or} 动态规则参数为 null 时条件未跳过的问题。
-
修复 useGeneratedKeys 生成的主键无法回填到参数 Map 的问题。
-
修复 DAO 代理接口方法查询为空时抛出 IndexOutOfBoundsException 的问题。
-
修复 queryStatement 底层返回 null 时被包装为 [null] 单元素列表的问题。
-
修复 BaseMapper.insert() 方法传入空集合时的处理逻辑。
-
修复 ColumnMapping.getKeyTpe() 方法名拼写错误,更正为 getKeyType()。
-
修复 AbstractDialect.fmtName() 标识符注入漏洞(Freedom 模式),统一转义逻辑到基类。