easy-mybatis
是一个对Mybatis
的增强框架(插件)。在Spring
集成Mybatis
的基础上,将项目开发中对数据库的常用操作统一化。使用本框架可以很便捷的对数据库进行操作,提高开发效率,减少机械行为。
Maven依赖引入
<dependency>
<groupId>top.zuoyu.mybatisgroupId>
<artifactId>easy-mybatis-spring-boot-starterartifactId>
<version>1.0.0version>
dependency>
Gradle依赖引入
// https://mvnrepository.com/artifact/top.zuoyu.mybatis/easy-mybatis-spring-boot-starter
implementation 'top.zuoyu.mybatis:easy-mybatis-spring-boot-starter:1.0.0'
框架特性
- 更便捷
摒弃传统mybatis
的model
、xml
、dao
数据库操作模式,避繁就简,快速开发。
- 更高效
采用预编译SQL
,拒绝运行期间反射生成SQL
,性能更高效。
- 无侵入
只是对Mybatis-Spring的增强插件,对已有工程不做任何修改,仍可使用原生框架的功能,仅仅是简化了开发阶段对数据库的操作。
- 统一操作接口
对数据库的所有操作共用一个接口,降低使用门槛,轻松操作数据库。
- 统一操作对象
使用JsonObject
为数据对象,提供一系列操作方法,方便从持久化对象组装为视图对象。
- 易上手
整个框架只提供了一个接口、一个注解、两个对象,仅仅一行配置便可完成对数据库进行常用操作。
- ...
安利
-
在
mybatis-spring-boot
环境下,使用该框架(插件),可以减少传统Mybatis
使用中对model
、xml
、dao
的机械式开发。 -
所有的数据库操作均使用
MapperRepository
接口,通过注解@Magic("xxx")
标记接口的数据表归属,即可直接使用。 -
该框架(插件)不妨碍同时使用传统
Mybatis
中model
、xml
、dao
的数据库开发方式。
快速上手
这里以
MySQL
数据库为例,Oracle
数据库配置请参考配置说明
-
配置
spring-boot-jdbc
数据库
spring:
datasource:
type: com.zaxxer.hikari.HikariDataSource
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://172.0.0.1:3306/xxxx
username: xxxx
password: xxxx
关于springBoot
的配置,这里不多赘述,更多移步springBoot官网。
-
配置
easy-mybatis
支持的表名(例子)
easy-mybatis:
table-names: teacher, student
这里的table-names
配置,表示需要easy-mybatis
框架支持的数据表名,多个表名使用逗号隔开。
即可使用easy-mybatis
框架操作teacher
和student
两个数据表,如果需要支持其他数据表,需要在此配置。
操作数据库(例子)
@SpringBootTest
class DemoApplicationTests {
// 表示该接口用来操作名称为'teacher'的数据表
@Magic("teacher")
private MapperRepository teacherRepository;
// 表示该接口用来操作名称为'student'的数据表
@Magic("student")
private MapperRepository studentRepository;
// 查询teacher表下所有数据
@Test
void teacherTest() {
teachertRepository.selectList().forEach(System.out::println);
}
// 查询student表下符合特定条件的数据
@Test
void studentTest() {
studentRepository.selectListByExample(
new JsonObject().put("birthday", "2009/12/12 12:12:12")
).forEach(System.out::println);
}
}
使用MapperRepository
接口对数据库进行操作,需要使用@Magic("表名称")
标记该接口的数据表归属。
在本例中,@Magic("teacher")
表示该MapperRepository
为"teacher"
数据表的操作接口,可以通过teacherRepository
调用一系列方法完成对"teacher"
数据表的操作。