鱼与熊掌得兼：Hibernate 与 Mybatis 共存

很长一段时间，网上有很多关于 Hibernate 与 Mybatis 孰优孰劣的争论，两个阵营的人谁也不能说服谁，每个人的理由都很有道理。今天，我分享的主题是：在一个项目中同时使用 Hibernate 和 Mybatis 两个 ORM 框架。

​ 作为一个开发者，没有必要花费过多的时间去证明技术无用论，当你开始指责某个框架垃圾，另外一个框架最好时，隐性的暴露出你对某个框架没有深入的研究，无知的指责对于技术的提升没有任何的帮助。框架本身没有对错一说，只有适合和更适合项目的选择。任何框架都有自身的能力范围，就拿 Hibernate 和 Mybatis 这两个 ORM 框架来说，Hibernate 封装了很多有用的 API 给开发者，降低了操作数据库的难度和复杂度，同时也减少了模板代码的数量，但 Hibernate 留给开发者可操作的空间相对 Mybatis 少了很多；Mybatis 框架使用起来很灵活，开发者可以自定义查询语句，但增加了模板代码的数量，看起来没有 Hibernate 那么便捷。两种框架在便捷与灵活两个指标上做出了取舍与妥协，这不能说是框架的错。对于一个框架而言，需要有自身专注的领域和设计愿景，不可能面面俱到。

​ 使用任何一种技术框架，都需要贴合现实的业务需求以及自身的技术能力。当你还没有深入的去了解一门技术或者当前业务需求无法与框架契合时，不要盲目的批判框架的好坏。今天，我不再去对比 Hibernate 与 Mybatis 两者之间的优劣，而是给出一个比较中庸的放方案，将两个 ORM 框架同时整合在一个项目中。

一、准备开发环境

​ 如果你想成功运行本文中的源代码，需要满足一下的几个条件：

• 1、JDK : JDK 1.8.x 及以上版本
• 2、Maven : Maven 3.x 或更高版本
• 3、Git：版本控制工具，选择一个你喜欢的
• 4、IDE : 选择你比较喜欢的一个代码编辑器，如 STS、IntelliJ IDEA。笔者使用的是 IntelliJ IDEA
• 5、Databases : 选择一个你熟练使用的数据库系统。笔者在本文中使用的是 MySQL 5.1.x 版本的数据库系统

如需获取本次分享内容的源代码进调试，可以到文章末尾找到源代码仓库连接

​

二、搭建项目

2-1、引入依赖

​ 为了快速构建项目，笔者采用 Spring Boot 来构建项目，同时使用加入 Spring Data JPA 和 Mybatis 两个 ORM 框架的依赖包。在此需要特别说明，Hibernate 是一个 JPA 标准的实现，尔 Spring Data JPA 是一个 JPA 数据访问抽象，通过 Spring Data JPA，可以轻松使用 Hibernate 框架。

​ 你可以通过 Spring Initializer 来初始化项目，也可以通过 IDEA 自带的 Spring Initializer 功能构建项目，项目构建完成之后，pom.xml 文件中的配置如下（包含但不限于文中给出的依赖项）：

2-2、定义实体类 -User.java

​ 为了演示同时使用 Hibernate 和 Mybatis 操作数据库，需要提供一个实体类 User.java，代码如下所示：

说明：

在本次演示的项目中，使用到了 Lombok 插件，它可以让开发者减少模板代码的书写，提高开发速度。@Data 注解可以自动生成类属性的 getter、setter 和 toString 方法。@NoArgsConstructor 会自动为类生成无参构造函数，@AllArgsConstructor 则会生成带全部属性的构造函数。

2-3、定义数据持久化接口

​ 在本次课程中，将使用 Spring Data JPA 来完成写操作，如新增、修改、删除；使用 Mybatis 来完成读操作，如根据用户 ID 查询、查询所有的用户等。Spring Data JPA 和 MyBatis 的持久化接口都位于 com.ramostear.hm.orm 包下，Spring Data JPA 的持久化接口相对比较简单，之间继承 JpaRepository 类即可，代码如下：

说明：因为 JPA 只负责写操作，所以直接继承并使用 JpaRepository 提供的 API 即可，不需要额外的定义其他的接口方法。

​ 下面是 Mybatis 的映射接口，定义了两个方法：根据 ID 查询用户信息和查询所有的用户信息。代码如下所示：

说明：

此接口需要注意的地方是 @Component 和 @Mapper 注解，@Component 注解标注此接口后，Spring 会自动扫描并配置此类；@Mapper 注解是把这个 mapper 的 DAO 交由 Spring 进行管理。

定义完 Mybatis 映射接口后，需要提供一个进行数据库查询的 xml 配置文件。该文件位于 resources/mapper 文件夹中，UserMapper.xml 完整代码如下：

2-4、定义 UserService

​ 在 UserService 接口中，提供三个方法：保存用户信息、根据 ID 查询用户、查询所有的用户。UserService 接口代码如下：

在 UserService 接口的实现类中，需要同时注入 UserRepository 和 UserMapper 两个依赖。我们使用构造函数的方式来注入这两个依赖。代码如下：

说明：

@Transactional 注解用于设置每个方法的事务控制方式。@Service 注解声明该类是一个服务提供类，且设置了该类被 Spring 初始化时 Bean 对象的名称为“userService”。

2-5、定义控制器

​ 最后，提供一个控制器，用于处理客户端的相关请求。在控制器中，提供了三个请求处理方法，分别处理客户端新增用户、根据 ID 查询用户和查询所有用户的请求。控制器代码如下：

说明：

在本次教程中，为了编码 IDEA 报警告，所有的依赖注入都采用构造函数的方式注入相关的依赖。

三、配置 Hibernate 和 Mybatis

​ 网络上有很多关于在 Spring Boot 项目中配置 Hibernate 和 Mybatis 的教程，但同时配置 Hibernate 和 Mybatis 的文章很少，有一些是通过 Java 代码的方式对这两个 ORM 框架进行配置，采用的是多数据源的方法来整合两个框架。其实整合这两个框架没有想象中的那么难，只需要在 application.yml 或者 application.properties 配置文件中加入几行代码，就可以完成两个框架的整合。以 application.yml 配置文件为例，配置代码如下：

是不是很简单，并为没有太多复杂的配置，这是一种较为简单的整合方式。Hibernate 和 Mybatis 共用一个数据源，如果是 JPA 的忠实粉丝，现在想要使用 Mybatis，只需要额外加入 mybatis 的配置即可。

四、测试

​ 通过以上的几个步骤，整个项目已经搭建完毕，接下来将使用 Postman 测试工具对 Controller 的三个方法进行测试，验证两个 ORM 框架在同一个项目中是否能共存。

​ 首先测试 POST http://localhost/users，验证 Hibernate 是否能够成功将用户信息持久化。打开 Postman 工具，在地址栏输入 http://localhost/users 请求地址，请求方式选择 POST, 在 Body 栏输入如下的信息：

{
    "username":"谭朝红",
    "alias":"ramostear",
    "age":28
}

点击“Send”按钮发送请求，观察服务端响应信息，测试结果如下图所示：

可以看到，服务端成功返回用户信息，且用户 ID=3。接下来，我们请求 GET http://localhost/users/3 , 验证 Mybatis 是否能够成功查询出用户信息，测试结果如下：

通过测试，服务端成功返回了用户 ID= 3 的用户信息：

{
  "id": 3,
  "username": "谭朝红",
  "alias": "ramostear",
  "age": 28
}

由此证明，在同一个项目中，Hibernate 和 Mybatis 均能正常工作，整合方案有效，解决了在同一项目中 Hibernate 与 Mybatis 共存的问题。

五、总结

​ 本次课程验证了同时使用 Hibernate 和 Mybatis 两个 ORM 框架的方案可行，且采用了一种比较简单的方式来整合两个框架，摒弃了多数据源的复杂配置，快速实现两个框架并用的需求。

​ 在一个项目中同时使用两个 ORM 框架有没有实际的意义呢？我的答案是肯定的。同时使用两个 ORM 框架，两者之间可以相互弥补自身的不足，以达到灵活性和便捷性同时兼顾，另外一方面，在单独使用 Mybatis 时，开发者需要手动或者借助其他的工具生成数据库表信息，而采用本文的整合方案，Mybatis 可以借助 JPA 自动生成数据库表的能力，从而简化使用 Mybatis 的步骤。最后，对于一些读多于写的系统，完全可以将这两个框架同时使用，写操作少的模块，可以使用 Spring Data JPA 快速完成相关功能的实现，对于读操作部分，则可以利用 Mybatis 来优化查询语句。两者之间的优势互补，能进一步的提升开发效率和系统性能。

本次分享内容的源代码仓库地址：

https://github.com/ramostear/…