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

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

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

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

1、准备开发环境

若是你想成功运行本文中的源代码，须要知足一下的几个条件：数据库

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

如需获取本次分享内容的源代码进调试，能够到文章末尾找到源代码仓库链接json

2、搭建项目

2-一、引入依赖

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

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

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

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

说明：app

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

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

在本次课程中，将使用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-四、定义UserService

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

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

说明：

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

2-五、定义控制器

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

说明：

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

3、配置Hibernate和Mybatis

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

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

4、测试

经过以上的几个步骤，整个项目已经搭建完毕，接下来将使用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共存的问题。

5、总结

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

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

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

github.com/ramostear/o…