easy-mybatis是一個(gè)對(duì)Mybatis的增強(qiáng)框架（插件）。在Spring集成Mybatis的基礎(chǔ)上，將項(xiàng)目開(kāi)發(fā)中對(duì)數(shù)據(jù)庫(kù)的常用操作統(tǒng)一化。使用本框架可以很便捷的對(duì)數(shù)據(jù)庫(kù)進(jìn)行操作，提高開(kāi)發(fā)效率，減少機(jī)械行為。

Maven依賴(lài)引入

<dependency>
    <groupId>top.zuoyu.mybatisgroupId>
    <artifactId>easy-mybatis-spring-boot-starterartifactId>
    <version>1.0.0version>
dependency>

Gradle依賴(lài)引入

// https://mvnrepository.com/artifact/top.zuoyu.mybatis/easy-mybatis-spring-boot-starter
implementation 'top.zuoyu.mybatis:easy-mybatis-spring-boot-starter:1.0.0'

框架特性

• 更便捷

摒棄傳統(tǒng)mybatis的model、xml、dao數(shù)據(jù)庫(kù)操作模式，避繁就簡(jiǎn)，快速開(kāi)發(fā)。

• 更高效

采用預(yù)編譯SQL，拒絕運(yùn)行期間反射生成SQL，性能更高效。

• 無(wú)侵入

只是對(duì)Mybatis-Spring的增強(qiáng)插件，對(duì)已有工程不做任何修改，仍可使用原生框架的功能，僅僅是簡(jiǎn)化了開(kāi)發(fā)階段對(duì)數(shù)據(jù)庫(kù)的操作。

• 統(tǒng)一操作接口

對(duì)數(shù)據(jù)庫(kù)的所有操作共用一個(gè)接口，降低使用門(mén)檻，輕松操作數(shù)據(jù)庫(kù)。

• 統(tǒng)一操作對(duì)象

使用JsonObject為數(shù)據(jù)對(duì)象，提供一系列操作方法，方便從持久化對(duì)象組裝為視圖對(duì)象。

• 易上手

整個(gè)框架只提供了一個(gè)接口、一個(gè)注解、兩個(gè)對(duì)象，僅僅一行配置便可完成對(duì)數(shù)據(jù)庫(kù)進(jìn)行常用操作。

• ...

安利

• 在mybatis-spring-boot環(huán)境下，使用該框架（插件），可以減少傳統(tǒng)Mybatis使用中對(duì)model、xml、dao的機(jī)械式開(kāi)發(fā)。

• 所有的數(shù)據(jù)庫(kù)操作均使用MapperRepository接口，通過(guò)注解@Magic("xxx")標(biāo)記接口的數(shù)據(jù)表歸屬，即可直接使用。

• 該框架（插件）不妨礙同時(shí)使用傳統(tǒng)Mybatis中model、xml、dao的數(shù)據(jù)庫(kù)開(kāi)發(fā)方式。

快速上手

這里以MySQL數(shù)據(jù)庫(kù)為例，Oracle數(shù)據(jù)庫(kù)配置請(qǐng)參考配置說(shuō)明

1. 配置spring-boot-jdbc數(shù)據(jù)庫(kù)

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

關(guān)于springBoot的配置，這里不多贅述，更多移步springBoot官網(wǎng)。

1. 配置easy-mybatis支持的表名（例子）

easy-mybatis:
  table-names: teacher, student

這里的table-names配置，表示需要easy-mybatis框架支持的數(shù)據(jù)表名，多個(gè)表名使用逗號(hào)隔開(kāi)。

即可使用easy-mybatis框架操作teacher和student兩個(gè)數(shù)據(jù)表，如果需要支持其他數(shù)據(jù)表，需要在此配置。

操作數(shù)據(jù)庫(kù)（例子）

@SpringBootTest
class DemoApplicationTests {

    // 表示該接口用來(lái)操作名稱(chēng)為'teacher'的數(shù)據(jù)表
    @Magic("teacher")
    private MapperRepository teacherRepository;

    // 表示該接口用來(lái)操作名稱(chēng)為'student'的數(shù)據(jù)表
    @Magic("student")
    private MapperRepository studentRepository;


    // 查詢(xún)teacher表下所有數(shù)據(jù)
    @Test
    void teacherTest() {
        teachertRepository.selectList().forEach(System.out::println);
    }

    // 查詢(xún)student表下符合特定條件的數(shù)據(jù)
    @Test
    void studentTest() {
        studentRepository.selectListByExample(
          new JsonObject().put("birthday", "2009/12/12 12:12:12")
          ).forEach(System.out::println);
    }

}

使用MapperRepository接口對(duì)數(shù)據(jù)庫(kù)進(jìn)行操作，需要使用@Magic("表名稱(chēng)")標(biāo)記該接口的數(shù)據(jù)表歸屬。

在本例中，@Magic("teacher")表示該MapperRepository為"teacher"數(shù)據(jù)表的操作接口，可以通過(guò)teacherRepository調(diào)用一系列方法完成對(duì)"teacher"數(shù)據(jù)表的操作。

?