Mybatis-Flex 1.0-rc1 发布，一个优雅的 Mybatis 增强框架

Mybatis-Flex 一个优雅的 Mybatis 增强框架

特征

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

开始

Maven 依赖
示例项目

hello world

第一步：编写 Entity 实体类

 @Table("tb_account") public class Account {      @Id(keyTYpe = KeyType.Auto)     private Long id;     private String userName;     private Date birthday;     private int sex;      //getter setter }

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

 public interface AccountMapper extends BaseMapper<Account> {     //只需定义 Mapper 接口即可，可以无任何内容。 }

第三步：开始查询数据

示例 1：查询 1 条数据

 class HelloWorld {     public static void main(String... args) {          HikariDataSource dataSource = new HikariDataSource();         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 条数据         Account account = MybatisFlexBootstrap.getInstance()                 .execute(AccountMapper.class, mapper ->                         mapper.selectOneById(100)                 );     } }

示例2：查询列表

 //示例2：通过 QueryWrapper 构建条件查询数据列表 QueryWrapper query=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 构建条件查询 QueryWrapper query=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,10         Page<Account> accounts=MybatisFlexBootstrap.getInstance()         .execute(AccountMapper.class,mapper->         mapper.paginate(5,10,query)         );

QueryWrapper 示例

select *

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

select columns

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

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

select functions

  QueryWrapper query=new QueryWrapper()         .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

 QueryWrapper queryWrapper=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  ?

exists, not exists

 public interface AccountMapper extends BaseMapper<Account> {     //只需定义 Mapper 接口即可，可以无任何内容。 } 0

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

 public interface AccountMapper extends BaseMapper<Account> {     //只需定义 Mapper 接口即可，可以无任何内容。 } 1

group by

 public interface AccountMapper extends BaseMapper<Account> {     //只需定义 Mapper 接口即可，可以无任何内容。 } 2

having

 public interface AccountMapper extends BaseMapper<Account> {     //只需定义 Mapper 接口即可，可以无任何内容。 } 3

orderBy

 public interface AccountMapper extends BaseMapper<Account> {     //只需定义 Mapper 接口即可，可以无任何内容。 } 4

join

 public interface AccountMapper extends BaseMapper<Account> {     //只需定义 Mapper 接口即可，可以无任何内容。 } 5

存在疑问？

疑问 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 的一些示例：

 public interface AccountMapper extends BaseMapper<Account> {     //只需定义 Mapper 接口即可，可以无任何内容。 } 6

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

具体参考： Db.java 。

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

Entity 部分字段更新

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

 public interface AccountMapper extends BaseMapper<Account> {     //只需定义 Mapper 接口即可，可以无任何内容。 } 7

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

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

 public interface AccountMapper extends BaseMapper<Account> {     //只需定义 Mapper 接口即可，可以无任何内容。 } 8

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

其生成的 sql 内容如下：

 public interface AccountMapper extends BaseMapper<Account> {     //只需定义 Mapper 接口即可，可以无任何内容。 } 9

多主键

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

 class HelloWorld {     public static void main(String... args) {          HikariDataSource dataSource = new HikariDataSource();         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 条数据         Account account = MybatisFlexBootstrap.getInstance()                 .execute(AccountMapper.class, mapper ->                         mapper.selectOneById(100)                 );     } } 0

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

自定义主键生成器

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

 class HelloWorld {     public static void main(String... args) {          HikariDataSource dataSource = new HikariDataSource();         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 条数据         Account account = MybatisFlexBootstrap.getInstance()                 .execute(AccountMapper.class, mapper ->                         mapper.selectOneById(100)                 );     } } 1

第 2 步：注册 UUIDKeyGenerator

 class HelloWorld {     public static void main(String... args) {          HikariDataSource dataSource = new HikariDataSource();         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 条数据         Account account = MybatisFlexBootstrap.getInstance()                 .execute(AccountMapper.class, mapper ->                         mapper.selectOneById(100)                 );     } } 2

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

 class HelloWorld {     public static void main(String... args) {          HikariDataSource dataSource = new HikariDataSource();         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 条数据         Account account = MybatisFlexBootstrap.getInstance()                 .execute(AccountMapper.class, mapper ->                         mapper.selectOneById(100)                 );     } } 3

使用数据库 Sequence 生成

 class HelloWorld {     public static void main(String... args) {          HikariDataSource dataSource = new HikariDataSource();         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 条数据         Account account = MybatisFlexBootstrap.getInstance()                 .execute(AccountMapper.class, mapper ->                         mapper.selectOneById(100)                 );     } } 4