简介
dbVisitor 是一个用于统一访问多种类型数据库的 Java 数据库操作框架，致力于让数据读写更直观、自然。它基于 JDBC 构建，对原始 JDBC 的底层接口进行了优化与封装，提供了更高层次的易用 API。整个项目由三大核心模块构成：
- dbvisitor-adapter：JDBC 驱动适配器集合，旨在为不支持 JDBC 协议的数据库提供 JDBC 接入能力，目前已涵盖 Redis、MongoDB 等非关系型数据库。
- dbvisitor-integration：集成模块，支持主流开发框架如 Spring、SpringBoot、Solon、Hasor 和 Guice，便于在各类应用中快速接入。
- dbvisitor：核心功能模块，提供标准化的数据库访问接口。
为何选择 dbVisitor？
在传统以关系型数据库为主的时代，已有众多成熟的基于 JDBC 的数据访问工具；然而，随着 Redis、MongoDB 等非关系型数据库广泛应用，数据存储形态日益多样化，对应的访问方式也愈加复杂。开发者常常需要在不同类型的数据库间切换，使用不同的 SDK 和编程范式，导致学习成本上升、代码风格割裂。
而现有的主流 ORM 或访问框架（如 Hibernate、MyBatis、JPA、Spring JDBC Template 等）大多聚焦于关系型数据库，在面对 NoSQL 存储时往往束手无策或需额外封装。dbVisitor 正是为此痛点而生——它通过统一的访问模型，实现了关系型与非关系型数据库的无缝融合。
其关键创新在于：借助驱动适配机制，dbVisitor 将 Redis、MongoDB 等非关系型数据库纳入 JDBC 体系，使开发者可以像操作传统数据库一样使用标准 JDBC 接口进行操作，从而消除多数据源之间的技术鸿沟，实现一致的编码体验。
版本更新亮点
- [新增] dbvisitor-driver 子项目，提供可扩展的 JDBC 驱动适配框架，屏蔽底层驱动差异，使得非关系型数据库也能通过请求-响应模式轻松对接 JDBC 应用。
- [新增] jdbc-redis 驱动适配器，支持通过标准 JDBC 接口和 SQL 类语法来操作 Redis，极大简化了 Redis 在 Java 中的集成难度。
功能特性
- 支持超过 140 条常用 Redis 命令，覆盖 DB 管理、服务信息、键操作、列表、集合、有序集合、字符串、哈希等完整命令集。
- 完整实现 JDBC 标准接口，包括
Connection、Statement、PreparedStatement、ResultSet等。 - 支持预编译语句中的占位符
?，可通过PreparedStatement动态设置参数值。 - 支持批量执行多个命令，并通过标准 JDBC 方法获取各命令的返回结果。
- 可配置
Statement的maxRows、fetchSize、timeoutSec等行为属性。 - 提供指令拦截器机制，可用于日志追踪、性能分析等场景。
- 支持灵活的结果类型转换，例如当结果为
LONG类型时，允许调用getInt()或getString()获取值。 - 支持以
BLOB、CLOB、NCLOB方式读取二进制或大文本数据。
技术架构
jdbc-redis 模块采用适配器设计模式，将标准 JDBC 调用映射到 Redis 原生命令体系。主要组成部分如下：
-
JedisConn：实现 JDBC 的
Connection接口，负责连接管理及命令调度，是适配层的核心入口。 - JedisCmd：封装 Jedis 客户端的所有操作接口，兼容单机与集群部署模式。
- JedisRequest：表示一条 Redis 命令请求对象，承载命令名与参数。
- ANTLR4 解析器：用于解析用户输入的 Redis 命令字符串，生成可执行的命令计划树。
执行流程说明
- 用户通过标准 JDBC 流程获取
Connection并创建Statement。 - 执行的 Redis 命令被
JedisConn接收，交由 ANTLR4 解析器进行语法分析。 - 解析后的命令结构传递给
JedisCmd，由底层 Jedis 客户端实际执行。 - 执行结果被包装成标准的
ResultSet或影响行数，返回至调用方。
依赖组件
- Jedis：Redis 官方推荐的 Java 客户端，当前适配版本为 6.1.0。
- ANTLR4：强大的词法与语法解析工具，用于构建 Redis 命令解析引擎。
- dbVisitor-driver：底层驱动框架，提供 JDBC 适配基础能力。
如何使用？
使用标准 JDBC URL 连接 Redis 实例：
String url = "jdbc:dbvisitor:jedis://server:port?database=0¶m1=value1¶m2=value2";
Properties props = new Properties();
props.setProperty("username", "user");
props.setProperty("password", "pass");
Connection conn = DriverManager.getConnection(url, props);详细驱动参数请参考文档。
示例：命令执行
// 创建连接
Connection conn = DriverManager.getConnection("jdbc:dbvisitor:jedis://localhost:6379");
// 执行命令
Statement stmt = conn.createStatement();
ResultSet rs = stmt.executeQuery("SET mykey hello");
// 处理结果
rs = stmt.executeQuery("GET mykey");
if (rs.next()) {
System.out.println(rs.getString(1)); // 输出: hello
}
// 参数化查询
PreparedStatement pstmt = conn.prepareStatement("HSET ? ? ?");
pstmt.setString(1, "myhash");
pstmt.setString(2, "field1");
pstmt.setString(3, "value1");
ResultSet rs = pstmt.executeQuery();源码地址：点击下载
