easy-mybatis是一个对Mybatis的增强框架（插件）。在Spring集成Mybatis的基础上，将项目开发中对数据库的常用操作统一化。使用本框架可以很便捷的对数据库进行操作，提高开发效率，减少机械行为。

Maven依赖引入

<!-- https://mvnrepository.com/artifact/top.zuoyu.mybatis/easy-mybatis-spring-boot-starter -->

<dependency>

    <groupId>top.zuoyu.mybatis</groupId>

    <artifactId>easy-mybatis-spring-boot-starter</artifactId>

    <version>1.0.0</version>

</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数据库配置请参考配置说明

1. 配置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官网。

2. 配置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"数据表的操作。