跳到主要内容

介绍

dbVisitor 数据库数据库访问库，提供 Java 对多种不同类型数据库统一访问。让数据的读写更加自然。

dbVisitor 是建立在 JDBC 基础之上，它改进了 JDBC 低级接口提供更加自然的 API。主要包含如下三个部分：

  • dbvisitor-adapter，是 JDBC 驱动适配器集合，目的是使不具备 JDBC Driver 的数据库可以用过 JDBC 接口访问。支持 Redis、MongoDB 等非关系型数据库。
  • dbvisitor-integration，是 dbVisitor 与主流框架的集成模块。支持 Spring、SpringBoot、Solon、Hasor、Guice 等主流框架。
  • dbvisitor，是核心模块，提供统一的数据库访问 API。

dbVisitor 是方便 Java 访问数据库的库，虽然有些类似 ORM 但和真正意义上的 ORM 理念比起来还是有很多不同点。

dbVisitor 是简单的，它专注数据库的访问。任何带有具体业务含义的特定功能都不属于 dbVisitor 范畴。尽管如此你仍然可以利用 dbVisitor 巧妙的设计来满足特定业务的需要。

为什么使用它？​

过去关系型数据库占主导时，数据访问手段已趋多样并且涌现了大量基于 JDBC 的成熟工具；但随着非关系型数据库兴起，数据存储形式更加多元访问 API 也变得更加复杂。开发者需要在不同的 API 之间切换，增加了学习成本和使用难度。 而已有的数据访问技术如 Hibernate、MyBatis、Spring JDBC 以及 ActiveRecord、QueryWrapper、Row、Chain、JPA 等主要针对关系型数据库，在面对日益多样的非关系型存储时显现出局限性。

dbVisitor 的核心突破在于访问模式的无缝集成：开发者可以在同一项目中混合使用多种访问范式，并在关系型与非关系型存储之间获得统一体验。 借助 drivers 模块，dbVisitor 已不再局限于通过 JDBC 访问关系型数据库，而是通过适配器支持例如 Redis、MongoDB 等非关系型数据库， 从而解决了传统多框架并存时的兼容性问题（例如 JdbcTemplate 与 MyBatis 的风格差异），并统一不同存储类型的操作接口。

使用 dbVisitor​

  • dbVisitor 使用商业友好的 Apache 2.0 许可协议。
  • dbVisitor 只有 Cobble 一个依赖（cobble 是一个类似 Apache Commons 或 Guava 的工具包）
  • 所有 dbVisitor 模块以及依赖项都可以通过 Maven Central 获得。

JVM 兼容性​

dbVisitor 可在所有 Java 8 或更高版本上运行，所有版本均使用 Java 8 编译构建。

入门​

  • dbVisitor 支持通过原始 SQL 方式利用 编程式 API 来访问数据库。
  • dbVisitor 支持在接口上通过注解标记以 声明式 API 方式来访问数据库。
  • dbVisitor 支持通过 构造器 方式用同一种 API 来访问所有框架支持的数据库。
  • dbVisitor 支持通过 BaseMapper 中预定的方法对数据库进行常规操作，从而简化应用。
  • dbVisitor 支持使用 使用 Mapper XML 文件配置统一管理 SQL 语句。
  • dbVisitor 提供多种方式处理 参数传递，相信在各种特殊场景中总能找到一个适合的方式处理它们。
  • dbVisitor 提供了一种更加灵活和高效的 规则 机制，通过规则可以更加简洁的维护应用程序 SQL。
  • dbVisitor 内置多种 类型处理器，可以方便的处理绝大多数数据库类型。
  • dbVisitor 支持在多个不同方法调用之间使用 数据库事务。

框架整合​

版本事件​

  • 目前最新版本 v6.1.0 (2025-11-04)
  • 6.x 版本 是一次全新的升级，在继承了 5.x 的功能，并真对不同风格 API 的实现做了较大改进使其在各个方面的用法和行为保持统一。
  • 5.x 版本 dbVisitor 正式从 Hasor 框架中分离出来并提供 编程式 API、声明式 API、构造器 三种不同风格的 API 来访问数据库。
  • 4.x 及以前版本中没有自己独立的版本，其发布跟随 Hasor 框架发布。