全新 Logo，Mybatis-Flex v1.0 正式版发布

Mybatis-Flex v1.0 正式版发布了，意味着我们可以在我们的正式项目上开始使用 Mybatis-Flex， v1.0 正式版的推出，同时伴随出来的还有着大量的测试和文档，所以，放心使用。Mybatis-Flex 的目标是成为全网最好用的 Mybatis 增强框架，让 Mybatis 飞起来。这也是这个 LOGO 的含义。

特征

1、很轻量，整个框架只依赖 Mybatis 再无其他第三方依赖。 2、只增强，支持 Entity 的增删改查、及分页查询，但不丢失 Mybatis 原有功能 3、内置 Db + Row 工具，可以无需实体类对数据库进行增删改查 4、支持多种数据库类型，还可以通过方言持续扩展 5、支持多（联合）主键，以及不同的主键内容生成策略 6、支持逻辑删除设置、更新或插入的默认值配置以及大字段等设置 7、支持乐观锁字段配置，在数据更新时自动进行乐观锁检测 8、极其友好的 SQL 联动查询，IDE 自动提示不再担心出错 9、更多小惊喜

在第一点中，Mybatis-Flex 很轻，除了没有依赖任何第三方框架以外，Mybatis-Flex 的增强实现方式很轻，没有任何拦截器、没有任何改写 SQL 和 Sql parse，全部都是基于 Mybatis 官方推荐的 SqlProvider 的方式实现，所以在代码 调试、跟进都是显而易见的。

(资料图片仅供参考)

Mybatis-Flex 没有使用 Lambda 表达式，除了通过使用 “方法名称” 代表 “字段” 显得怪异以外，通过 Lambda 表达式推导出 “字段” 的代价也是巨大的。

开始

Maven 依赖 示例 1：Mybatis-Flex 原生（非 Spring） 示例 2：Mybatis-Flex with Spring 示例 3：Mybatis-Flex with Spring boot

hello world（原生）

第一步：编写 Entity 实体类

@Table("tb_account")publicclassAccount{    @Id(keyTYpe = KeyType.Auto)    privateLongid;    privateStringuserName;    privateDatebirthday;    privateintsex;    //getter setter}

第二步，编写 Mapper 类，并继承 BaseMapper

publicinterfaceAccountMapperextendsBaseMapper<Account> {    //只需定义 Mapper 接口即可，可以无任何内容。}

第三步：开始查询数据

示例 1：查询 1 条数据

classHelloWorld{    publicstaticvoidmain(String... args) {        HikariDataSourcedataSource = newHikariDataSource();        dataSource.setJdbcUrl("jdbc:mysql://127.0.0.1:3306/mybatis-flex");        dataSource.setUsername("username");        dataSource.setPassword("password");        MybatisFlexBootstrap.getInstance()                .setDatasource(dataSource)                .addMapper(AccountMapper.class)                .start();        //示例1：查询 id=100 条数据        Accountaccount = MybatisFlexBootstrap.getInstance()                .execute(AccountMapper.class, mapper ->                        mapper.selectOneById(100)                );    }}

示例2：查询列表

//示例2：通过 QueryWrapper 构建条件查询数据列表QueryWrapperquery=QueryWrapper.create()    .select()    .from(ACCOUNT)    .where(ACCOUNT.ID.ge(100))    .and(ACCOUNT.USER_NAME.like("张").or(ACCOUNT.USER_NAME.like("李")));// 执行 SQL：// ELECT * FROM `tb_account`// WHERE `tb_account`.`id` >=  100// AND (`tb_account`.`user_name` LIKE "%张%" OR `tb_account`.`user_name` LIKE "%李%" )List<Account> accounts=MybatisFlexBootstrap.getInstance()    .execute(AccountMapper.class,mapper->        mapper.selectListByQuery(query)    );

示例3：分页查询

// 示例3：分页查询// 查询第 5 页，每页 10 条数据，通过 QueryWrapper 构建条件查询QueryWrapperquery=QueryWrapper.create()    .select()    .from(ACCOUNT)    .where(ACCOUNT.ID.ge(100))    .and(ACCOUNT.USER_NAME.like("张").or(ACCOUNT.USER_NAME.like("李")))    .orderBy(ACCOUNT.ID.desc());// 执行 SQL：// ELECT * FROM `tb_account`// WHERE `id` >=  100// AND (`user_name` LIKE "%张%" OR `user_name` LIKE "%李%" )// ORDER BY `id` DESC// LIMIT 40,10Page<Account> accounts=MybatisFlexBootstrap.getInstance().execute(AccountMapper.class,mapper->    mapper.paginate(5,10,query));

QueryWrapper 示例

select *

QueryWrapperquery=newQueryWrapper();query.select().from(ACCOUNT)// SQL: // SELECT * FROM tb_account

select columns

QueryWrapperquery=newQueryWrapper();query.select(ACCOUNT.ID,ACCOUNT.USER_NAME)    .from(ACCOUNT)// SQL: // SELECT id, user_name // FROM tb_account

QueryWrapperquery=newQueryWrapper();query.select(ACCOUNT.ALL_COLUMNS).from(ACCOUNT)// SQL: // SELECT id, user_name, birthday, sex, is_normal // FROM tb_account

select functions

QueryWrapperquery=newQueryWrapper()    .select(        ACCOUNT.ID,        ACCOUNT.USER_NAME,        max(ACCOUNT.BIRTHDAY),        avg(ACCOUNT.SEX).as("sex_avg")    ).from(ACCOUNT);// SQL: // SELECT id, user_name, // MAX(birthday), // AVG(sex) AS sex_avg // FROM tb_account

where

QueryWrapperqueryWrapper=QueryWrapper.create()    .select()    .from(ACCOUNT)    .where(ACCOUNT.ID.ge(100))    .and(ACCOUNT.USER_NAME.like("michael"));// SQL: // SELECT * FROM tb_account // WHERE id >=  ?  // AND user_name LIKE  ? 

where select

QueryWrapperqueryWrapper = QueryWrapper.create()    .select()    .from(ACCOUNT)    .where(ACCOUNT.ID.ge(       select(ARTICLE.ACCOUNT_ID).from(ARTICLE).where(ARTICLE.ID.ge(100))    ));// SQL: // SELECT * FROM `tb_account` // WHERE `id` >= // (SELECT `account_id` FROM `tb_article` WHERE `id` >=  ? )

exists, not exists

QueryWrapperqueryWrapper=QueryWrapper.create()    .select()    .from(ACCOUNT)    .where(ACCOUNT.ID.ge(100))    .and(        exist(            selectOne().from(ARTICLE).where(ARTICLE.ID.ge(100))        )    );// SQL: // SELECT * FROM tb_account // WHERE id >=  ?  // AND EXIST (//    SELECT 1 FROM tb_article WHERE id >=  ? // )

and (...) or (...)

QueryWrapperqueryWrapper=QueryWrapper.create()    .select()    .from(ACCOUNT)    .where(ACCOUNT.ID.ge(100))    .and(ACCOUNT.SEX.eq(1).or(ACCOUNT.SEX.eq(2)))    .or(ACCOUNT.AGE.in(18,19,20).and(ACCOUNT.USER_NAME.like("michael")));// SQL: // SELECT * FROM tb_account // WHERE id >=  ?  // AND (sex =  ? OR sex =  ? ) // OR (age IN (?,?,?) AND user_name LIKE ? )

group by

QueryWrapperqueryWrapper=QueryWrapper.create()    .select()    .from(ACCOUNT)    .groupBy(ACCOUNT.USER_NAME);// SQL: // SELECT * FROM tb_account // GROUP BY user_name

having

QueryWrapperqueryWrapper=QueryWrapper.create()    .select()    .from(ACCOUNT)    .groupBy(ACCOUNT.USER_NAME)    .having(ACCOUNT.AGE.between(18,25));// SQL: // SELECT * FROM tb_account // GROUP BY user_name // HAVING age BETWEEN  ? AND ?

orderBy

QueryWrapperqueryWrapper=QueryWrapper.create()    .select()    .from(ACCOUNT)    .orderBy(ACCOUNT.AGE.asc()        , ACCOUNT.USER_NAME.desc().nullsLast());// SQL: // SELECT * FROM `tb_account` // ORDER BY `age` ASC, `user_name` DESC NULLS LAST

join

QueryWrapperqueryWrapper=QueryWrapper.create()    .select()    .from(ACCOUNT)    .leftJoin(ARTICLE).on(ACCOUNT.ID.eq(ARTICLE.ACCOUNT_ID))    .innerJoin(ARTICLE).on(ACCOUNT.ID.eq(ARTICLE.ACCOUNT_ID))    .where(ACCOUNT.AGE.ge(10));// SQL: // SELECT * FROM tb_account // LEFT JOIN tb_article ON tb_account.id = tb_article.account_id // INNER JOIN tb_article ON tb_account.id = tb_article.account_id // WHERE tb_account.age >=  ?

limit... offset

QueryWrapperqueryWrapper = QueryWrapper.create()    .select()    .from(ACCOUNT)    .orderBy(ACCOUNT.ID.desc())    .limit(10)    .offset(20);// MySql: // SELECT * FROM `tb_account` ORDER BY `id` DESC LIMIT 20, 10// postgreSQL: // SELECT * FROM "tb_account" ORDER BY "id" DESC LIMIT 20 OFFSET 10// informix: // SELECT SKIP 20 FIRST 10 * FROM "tb_account" ORDER BY "id" DESC// oracle: // SELECT * FROM (SELECT TEMP_DATAS.*, //  ROWNUM RN FROM (//          SELECT * FROM "tb_account" ORDER BY "id" DESC) //      TEMP_DATAS WHERE  ROWNUM <=30) //  WHERE RN >20// db2: // SELECT * FROM "tb_account" ORDER BY "id" DESC // OFFSET 20 ROWS FETCH NEXT 10 ROWS ONLY// sybase: // SELECT TOP 10 START AT 21 * FROM "tb_account" ORDER BY "id" DESC// firebird: // SELECT * FROM "tb_account" ORDER BY "id" DESC ROWS 20 TO 30

在以上的 "limit... offset" 示例中，Mybatis-Flex 能够自动识别当前数据库，并生成不同的 SQL，用户也可以很轻易的通过DialectFactory注册（新增或改写）自己的实现方言。

存在疑问？

疑问 1：QueryWrapper 是否可以在分布式项目中通过 RPC 传输？

答：可以。

疑问 2：如何通过实体类 Account.java 生成 QueryWrapper 所需要的 "ACCOUNT" 类 ?

答：Mybatis-Flex 使用了 APT（Annotation Processing Tool）技术，在项目编译的时候，会自动根据 Entity 类定义的字段帮你生成 "ACCOUNT" 类， 通过开发工具构建项目（如下图），或者执行 maven 编译命令:mvn clean package都可以自动生成。这个原理和 lombok 一致。

更多关于 Mybatis-Flex APT 的配置，请点击这里。

Db + Row 工具类

Db + Row 工具类，提供了在 Entity 实体类之外的数据库操作能力。使用 Db + Row 时，无需对数据库表进行映射， Row 是一个 HashMap 的子类，相当于一个通用的 Entity。以下为 Db + Row 的一些示例：

//使用原生 SQL 插入数据Stringsql="insert into tb_account(id,name) value (?, ?)";Db.insertBySql(sql,1,"michael");//使用 Row 插入数据Rowaccount=newRow();account.set("id",100);account.set("name","Michael");Db.insertRow("tb_account",account);//根据主键查询数据Rowrow=Db.selectOneById("tb_account","id",1);//Row 可以直接转换为 Entity 实体类，且性能极高Accountaccount=row.toEntity(Account.class);//查询所有大于 18 岁的用户Stringlistsql="select * from tb_account where age > ?"List<Row> rows=Db.selectListBySql(sql,18);//分页查询：每页 10 条数据，查询第 3 页的年龄大于 18 的用户QueryWrapperquery=QueryWrapper.create().where(ACCOUNT.AGE.ge(18));Page<Row> rowPage=Db.paginate("tb_account",3,10,query);

Db 工具类还提供了更多 增、删、改、查和分页查询等方法。

具体参考：Db.java。

更多关于 Row 插入时的主键生成机制、以及Db 的事务管理等，请点击这里。

Entity 部分字段更新

相比市面上的其他框架，这部分的功能应该也算是 MyBatis-Flex 的亮点之一。在 BaseMapper 中，Mybatis-Flex 提供了如下的方法：

update(T entity,booleanignoreNulls)

第一个参数是 entity 的对象。 第二个参数是是否忽略 null 值。

有些场景下，我们可能希望只更新 几个 字段，而其中个别字段需要更新为 null。此时需要用到UpdateEntity工具类，以下是示例代码：

Accountaccount=UpdateEntity.of(Account.class);account.setId(100);account.setUserName(null);account.setSex(1);accountMapper.update(account,false);

以上的示例中，会把 id 为 100 这条数据中的 user_name 字段更新为 null，sex 字段更新为 1，其他字段不会被更新。也就是说，通过UpdateEntity创建的对象，只会更新调用了 setter 方法的字段，若不调用 setter 方法，不管这个对象里的属性的值是什么，都不会更新到数据库。

其生成的 sql 内容如下：

updatetb_accountsetuser_name = ?, sex = ? whereid = ? #params: null,1,100

多主键

Mybatis-Flex 多主键就是在 Entity 类里有多个@Id注解标识而已，比如：

@Table("tb_account")publicclassAccount{    @Id(keyType = KeyType.Auto)    privateLongid;    @Id(keyType = KeyType.Generator, value = "uuid")    privateStringotherId;    //getter setter}

当我们保存数据的时候，Account 的 id 主键为自增，而 otherId 主键则通过 uuid 生成。

自定义主键生成器

第 1 步：编写一个类，实现IKeyGenerator接口，例如：

publicclassUUIDKeyGeneratorimplementsIKeyGenerator{    @Override    publicObjectgenerate(Objectentity, StringkeyColumn) {        returnUUID.randomUUID().toString().replace("-", "");    }}

第 2 步：注册 UUIDKeyGenerator

KeyGeneratorFactory.register("myUUID",newUUIDKeyGenerator());

第 3 步：在 Entity 里使用 "myUUID" 生成器：

@Table("tb_account")publicclassAccount{    @Id(keyType = KeyType.Generator, value = "myUUID")    privateStringotherId;    //getter setter}

使用数据库 Sequence 生成

@Table("tb_account")publicclassAccount{    @Id(keyType = KeyType.Sequence, value = "select SEQ_USER_ID.nextval as id from dual")    privateLongid;}

更多关于主键的配置，请点击这里

更多文档

Maven依赖 主键设置 列的设置 逻辑删除 乐观锁 Db + Row APT