项目中Hibernate与Mybatis如何共存

矫情吗；* 2023-06-07 03:16 6阅读 0赞

前段时间接触了一个新项目，里面比较臃肿，用的是hibernate的ORM框架。个人比较讨厌把sql写在代码里面。非常想把ORM框架换成mybatis，但是也不能影响现有流程，已有的hibernate不能动，那就只能考虑Hibernate与Mybatis如何共存的问题。于是就搜到了以下的文章。

**其实总体来说，Hibernate与Mybatis各自配置好各自的配置即可，他俩之间并不会互相影响。我主要是考虑他俩能否使用一套数据源，如果使用同一套数据源是否会产生问题。但是看了下面的文章后。我放心了，使用同一套数据源是没有问题的。**

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

![aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMNDI4TW5ZaWFYd2VNZWM0cDVtZkZXOHRlRzhmOElZN25iS3R4WGo3QU1KWTdna2RoeW5iTmd6dy82NDA_d3hfZm10PXBuZyZ0cD13ZWJwJnd4ZnJvbT01Jnd4X2xhenk9MSZ3eF9jbz0x][]

作为一个开发者，没有必要花费过多的时间去证明技术无用论，当你开始指责某个框架垃圾，另外一个框架最好时，隐性的暴露出你对某个框架没有深入的研究，无知的指责对于技术的提升没有任何的帮助。框架本身没有对错一说，只有适合和更适合项目的选择。任何框架都有自身的能力范围，就拿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文件中的配置如下（包含但不限于文中给出的依赖项）：

![aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMNUZEdEgza29QdlZlWnpWcW5pYTZHVHJNZFJUUDdTbUNxZ2lhNk1UeEdtNnpDSEF1SGp5bHlRd0EvNjQwP3d4X2ZtdD1wbmcmdHA9d2VicCZ3eGZyb209NSZ3eF9sYXp5PTEmd3hfY289MQ][]

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

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

![aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMOTZFYU9tOWVyampYaWNxOEdoR2xNbGRneGx3dmliODdMTnZPYXNGa01tUUZMNkV2TjJ4Q0hMQlEvNjQwP3d4X2ZtdD1wbmcmdHA9d2VicCZ3eGZyb209NSZ3eF9sYXp5PTEmd3hfY289MQ][]

> 说明：
> 
> 在本次演示的项目中，使用到了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类即可，代码如下：

![aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMNFpiNkkzdFFxZnBKaWNaeXZQZGliOTBsbGliQmxpYWZUa1Z5WndOb1JtbEtvNjlpYkQ2N3FSVllMWGcvNjQwP3d4X2ZtdD1wbmcmdHA9d2VicCZ3eGZyb209NSZ3eF9sYXp5PTEmd3hfY289MQ][]

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

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

![aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMaWFGTTNrbVhwZk5aNDI2MThORGs3bGNpY3BiVmg0aWNzVGszRGxLMzVabWlhRHVSZmVNTUpVSUlkQS82NDA_d3hfZm10PXBuZyZ0cD13ZWJwJnd4ZnJvbT01Jnd4X2xhenk9MSZ3eF9jbz0x][]

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

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

![aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMbXFDVXh1aWI5UWpQQUVqZmtoaWI4UVl5Z2RpYldkcWJqWDluOFdiV0ZHYmliUTNlcHBBTnZQTzhrZy82NDA_d3hfZm10PXBuZyZ0cD13ZWJwJnd4ZnJvbT01Jnd4X2xhenk9MSZ3eF9jbz0x][]

### 2-4、定义UserService ###

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

![aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMaWM2QVFWWm9QMFVOUXhZTjFzR1VLMG5MSmhINnBndWliTno1S2ppYzFsNjB2ajFtREMyMkFiWmZRLzY0MD93eF9mbXQ9cG5nJnRwPXdlYnAmd3hmcm9tPTUmd3hfbGF6eT0xJnd4X2NvPTE][]

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

![aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMRWJ4eHJ2UmRhSG1Mb3FtSkszN2FtOVQwVktITzd4N3BKS0o4NU1EaWJGeHFHTTNaT1A4T3J6dy82NDA_d3hfZm10PXBuZyZ0cD13ZWJwJnd4ZnJvbT01Jnd4X2xhenk9MSZ3eF9jbz0x][]

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

### 2-5、定义控制器 ###

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

![aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMRmIwMGNJekFqbnd2b1NRWnZNejJyRFFFRjV2TFpkRFRsazdFRmZhaHFyOThNaWFSSUU2b0lsUS82NDA_d3hfZm10PXBuZyZ0cD13ZWJwJnd4ZnJvbT01Jnd4X2xhenk9MSZ3eF9jbz0x][]

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

## 三、配置Hibernate和Mybatis ##

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

![aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMQzFYTGxrUE1IMHlBaWJRZUtIaWJHbThrRms3QjBYQXVjS3ZSR2ZDY3Z4eFdRSU5yUUlDYmhkencvNjQwP3d4X2ZtdD1wbmcmdHA9d2VicCZ3eGZyb209NSZ3eF9sYXp5PTEmd3hfY289MQ][]

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

## 四、测试 ##

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

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

1.  `{`
2.  `"username":"谭朝红",`
3.  `"alias":"ramostear",`
4.  `"age":28`
5.  `}`

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

![aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMMXRzWGNqcnJ5WUVRNjYxT2pYWDRBTjdON0tEZG14MGljVTVBWUdRM0RlWDByR0FmZGFwTkJ1QS82NDA_d3hfZm10PXBuZyZ0cD13ZWJwJnd4ZnJvbT01Jnd4X2xhenk9MSZ3eF9jbz0x][]

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

![aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMczlnTFVEZDdhbnE1OGh0UUZ3djJSQ0NFMHNCR2Jic3lXMWVDMUpuRnEwRVNuMjRxSjdtb2R3LzY0MD93eF9mbXQ9cG5nJnRwPXdlYnAmd3hmcm9tPTUmd3hfbGF6eT0xJnd4X2NvPTE][]

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

1.  `{`
2.  `"id": 3,`
3.  `"username": "谭朝红",`
4.  `"alias": "ramostear",`
5.  `"age": 28`
6.  `}`

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

## 五、总结 ##

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

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

[aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMNDI4TW5ZaWFYd2VNZWM0cDVtZkZXOHRlRzhmOElZN25iS3R4WGo3QU1KWTdna2RoeW5iTmd6dy82NDA_d3hfZm10PXBuZyZ0cD13ZWJwJnd4ZnJvbT01Jnd4X2xhenk9MSZ3eF9jbz0x]: /images/20230601/8c325cf825de491da16fc7f0ad52753d.png
[aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMNUZEdEgza29QdlZlWnpWcW5pYTZHVHJNZFJUUDdTbUNxZ2lhNk1UeEdtNnpDSEF1SGp5bHlRd0EvNjQwP3d4X2ZtdD1wbmcmdHA9d2VicCZ3eGZyb209NSZ3eF9sYXp5PTEmd3hfY289MQ]: /images/20230601/c58e17e92816467e892d30a5098f84b9.png
[aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMOTZFYU9tOWVyampYaWNxOEdoR2xNbGRneGx3dmliODdMTnZPYXNGa01tUUZMNkV2TjJ4Q0hMQlEvNjQwP3d4X2ZtdD1wbmcmdHA9d2VicCZ3eGZyb209NSZ3eF9sYXp5PTEmd3hfY289MQ]: /images/20230601/806b56d895384752b80329c4a62f886e.png
[aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMNFpiNkkzdFFxZnBKaWNaeXZQZGliOTBsbGliQmxpYWZUa1Z5WndOb1JtbEtvNjlpYkQ2N3FSVllMWGcvNjQwP3d4X2ZtdD1wbmcmdHA9d2VicCZ3eGZyb209NSZ3eF9sYXp5PTEmd3hfY289MQ]: /images/20230601/9e2fddd0618a4e8098b2ed4ab039f1a9.png
[aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMaWFGTTNrbVhwZk5aNDI2MThORGs3bGNpY3BiVmg0aWNzVGszRGxLMzVabWlhRHVSZmVNTUpVSUlkQS82NDA_d3hfZm10PXBuZyZ0cD13ZWJwJnd4ZnJvbT01Jnd4X2xhenk9MSZ3eF9jbz0x]: /images/20230601/463b21e2e4144ccbb7839a49af8cf2fd.png
[aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMbXFDVXh1aWI5UWpQQUVqZmtoaWI4UVl5Z2RpYldkcWJqWDluOFdiV0ZHYmliUTNlcHBBTnZQTzhrZy82NDA_d3hfZm10PXBuZyZ0cD13ZWJwJnd4ZnJvbT01Jnd4X2xhenk9MSZ3eF9jbz0x]: /images/20230601/59c1f525656040c5b6b3b25aef311a72.png
[aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMaWM2QVFWWm9QMFVOUXhZTjFzR1VLMG5MSmhINnBndWliTno1S2ppYzFsNjB2ajFtREMyMkFiWmZRLzY0MD93eF9mbXQ9cG5nJnRwPXdlYnAmd3hmcm9tPTUmd3hfbGF6eT0xJnd4X2NvPTE]: /images/20230601/37955b226ebd449180019784a38702e2.png
[aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMRWJ4eHJ2UmRhSG1Mb3FtSkszN2FtOVQwVktITzd4N3BKS0o4NU1EaWJGeHFHTTNaT1A4T3J6dy82NDA_d3hfZm10PXBuZyZ0cD13ZWJwJnd4ZnJvbT01Jnd4X2xhenk9MSZ3eF9jbz0x]: /images/20230601/4f91a9d0fc6d41969d04d757d27c6f07.png
[aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMRmIwMGNJekFqbnd2b1NRWnZNejJyRFFFRjV2TFpkRFRsazdFRmZhaHFyOThNaWFSSUU2b0lsUS82NDA_d3hfZm10PXBuZyZ0cD13ZWJwJnd4ZnJvbT01Jnd4X2xhenk9MSZ3eF9jbz0x]: /images/20230601/d43dc10e86d845128560e4a711127b43.png
[aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMQzFYTGxrUE1IMHlBaWJRZUtIaWJHbThrRms3QjBYQXVjS3ZSR2ZDY3Z4eFdRSU5yUUlDYmhkencvNjQwP3d4X2ZtdD1wbmcmdHA9d2VicCZ3eGZyb209NSZ3eF9sYXp5PTEmd3hfY289MQ]: /images/20230601/f8cdc3c453de4f719ad80b4675458d62.png
[aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMMXRzWGNqcnJ5WUVRNjYxT2pYWDRBTjdON0tEZG14MGljVTVBWUdRM0RlWDByR0FmZGFwTkJ1QS82NDA_d3hfZm10PXBuZyZ0cD13ZWJwJnd4ZnJvbT01Jnd4X2xhenk9MSZ3eF9jbz0x]: /images/20230601/424990275b0d492aa8cb139836e5f1be.png
[aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9Xd1BrVUNGWDR4NDJDNHJpYzJXQXNPaWJ4anZCYjl5RWdMczlnTFVEZDdhbnE1OGh0UUZ3djJSQ0NFMHNCR2Jic3lXMWVDMUpuRnEwRVNuMjRxSjdtb2R3LzY0MD93eF9mbXQ9cG5nJnRwPXdlYnAmd3hmcm9tPTUmd3hfbGF6eT0xJnd4X2NvPTE]: /images/20230601/23d153588f15463eaa2801b95d32a158.png