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數據庫配置請參考配置說明

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官網。

1. 配置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"數據表的操作。

?