最近逛开源社区的时候，偶尔发现了一个 MyBatis 增强框架-MyBatis-Flex ，感觉挺不错的，集合了 MyBatis-Plus、Fluent-MyBatis 的优点。

MyBatis-Flex 的作者是一位技术大佬，还开源了知名 CMS 系统 JPress 以及微服务框架 JFinal。

个人认为这个框架还是挺有潜力的，准备后面在个人项目中试试。同时，也希望这个项目能够持续维护下去，不断完善。

MyBatis-Flex 介绍

根据官网介绍，MyBatis-Flex 是一个优雅的 MyBatis 增强框架，具备下面这些特点：

• 轻量：除了 MyBatis 本身，再无任何第三方依赖。
• 灵活且强大：提供了非常灵活的 QueryWrapper，支持关联查询、多表查询、多主键、逻辑删除、乐观锁更新、数据填充、数据脱敏、等等....。
• 性能高：性能比传统的 MyBatis 增强框架比如 MyBatis-Plus 要更优秀。

MyBatis-Flex 几乎支持所有主流的数据库，例如，MySQL、MariaDB、DB2、PostgreSQL、SQLite、达梦、人大金仓等等。并且，还可以通过自定义方言的方式，持续添加更多的数据库支持。

多提一点：QueryWrapper 是 MyBatis-Flex 的核心类，增删改、查询和分页都是借助 QueryWrapper 实现的。并且，QueryWrapper 可以被序列化通过 RPC 进行传输，因此，在微服务项目中，我们可以在客户端（网关、Controller 层等）构造出 QueryWrapper，传给 Provider 层进行查询返回数据。

MyBatis-Flex vs MyBatis-Plus

MyBatis-Flex 直接对标老牌 MyBatis 增强框架 MyBatis-Plus，根据官方文档显示，其在功能性和性能上都要更优秀一些。

MyBatis-Flex 和 MyBatis-Plus 的功能对比如下（数据来源于 MyBatis-Flex 官方文档）：

从上图可以看到，像数据填充、数据脱敏、字段权限等 MyBatis-Plus 收费才能使用的功能，MyBatis-Flex 直接可以免费使用。

MyBatis-Flex 和 Mybaits-Plus 的性能对比，大家可以直接看官方文档提供的数据即可（地址：https://mybatis-flex.com/zh/intro/benchmark.html）。根据官方提供的案例的测试结果显示，MyBatis-Flex 的综合性能表现大概是 MyBatis-Plus 的 5~10 倍左右。

• MyBatis-Flex 的查询单条数据的速度，大概是 MyBatis-Plus 的 5 ~ 10+ 倍。
• MyBatis-Flex 的查询 10 条数据的速度，大概是 MyBatis-Plus 的 5~10 倍左右。
• Mybatis-Flex 的分页查询速度，大概是 Mybatis-Plus 的 5~10 倍左右。
• Mybatis-Flex 的数据更新速度，大概是 Mybatis-Plus 的 5~10+ 倍。

测试源码在这里：https://gitee.com/mybatis-flex/mybatis-benchmark ，如果对数据存疑的话，可以自行本地测试一下。

下面再来简单对比一下 MyBatis-Flex 和 Mybaits-Plus 在写法上的区别。

1、基础查询

MyBatis-Flex：

QueryWrapper query = QueryWrapper.create()
        .where(EMPLOYEE.LAST_NAME.like(searchWord)) //条件为null时自动忽略
        .and(EMPLOYEE.GENDER.eq(1))
        .and(EMPLOYEE.AGE.gt(24));
List employees = employeeMapper.selectListByQuery(query);

MyBatis-Plus：

QueryWrapper queryWrapper = Wrappers.query()
        .like(searchWord != null, "last_name", searchWord)
        .eq("gender", 1)
        .gt("age", 24);
List employees = employeeMapper.selectList(queryWrapper);

或者 MyBatis-Plus 的 lambda 写法：

LambdaQueryWrapper queryWrapper = Wrappers.lambdaQuery()
        .like(StringUtils.isNotEmpty(searchWord), Employee::getUserName,"B")
        .eq(Employee::getGender, 1)
        .gt(Employee::getAge, 24);
List employees = employeeMapper.selectList(queryWrapper);

2、多表查询

MyBatis-Flex：

QueryWrapper query = QueryWrapper.create()
    .select().from(ACCOUNT)
    .leftJoin(ARTICLE).on(ACCOUNT.ID.eq(ARTICLE.ACCOUNT_ID))
    .where(ACCOUNT.AGE.ge(10));

List accounts = mapper.selectListByQuery(query);

MyBatis-Plus：

// 不支持~~~~

3、部分字段更新

MyBatis-Flex ：

Account account = UpdateEntity.of(Account.class);
account.setId(100); //设置主键
account.setUserName("michael");
account.setAge(18);
account.setBirthday(null);

accountMapper.update(account);

MyBatis-Plus：

UpdateWrapper updateWrapper = new UpdateWrapper<>();
updateWrapper.eq("id", 100);
updateWrapper.set("user_name", "michael");
updateWrapper.set("age", 18);
updateWrapper.set("birthday", null);

accountMapper.update(null, updateWrapper);

MyBatis-Flex 的核心功能

MyBatis-Flex 的核心功能非常多，这里挑选个别比较有意思的进行简单介绍，官方文档已经介绍的非常详细了。

数据脱敏

数据脱敏说的就是我们根据特定的规则对敏感信息数据进行变形，比如我们把手机号、身份证号某些位数使用 * 来代替。

MyBatis-Flex 提供了 @ColumnMask() 注解，以及内置的 9 种脱敏规则，开箱即用：

• 用户名脱敏
• 手机号脱敏
• 固定电话脱敏
• 身份证号脱敏
• 车牌号脱敏
• 地址脱敏
• 邮件脱敏
• 密码脱敏
• 银行卡号脱敏

/**
 * 内置的数据脱敏方式
 */
public class Masks {
    /**
     * 手机号脱敏
     */
    public static final String MOBILE = "mobile";
    /**
     * 固定电话脱敏
     */
    public static final String FIXED_PHONE = "fixed_phone";
    /**
     * 身份证号脱敏
     */
    public static final String ID_CARD_NUMBER = "id_card_number";
    /**
     * 中文名脱敏
     */
    public static final String CHINESE_NAME = "chinese_name";
    /**
     * 地址脱敏
     */
    public static final String ADDRESS = "address";
    /**
     * 邮件脱敏
     */
    public static final String EMAIL = "email";
    /**
     * 密码脱敏
     */
    public static final String PASSWORD = "password";
    /**
     * 车牌号脱敏
     */
    public static final String CAR_LICENSE = "car_license";
    /**
     * 银行卡号脱敏
     */
    public static final String BANK_CARD_NUMBER = "bank_card_number";
    //...
}

使用示例：

@Table("tb_account")
public class Account {

    @Id(keyType = KeyType.Auto)
    private Long id;

    @ColumnMask(Masks.CHINESE_NAME)
    private String userName;

    @ColumnMask(Masks.EMAIL)
    private String email;

}

如果这些内置的脱敏规则不满足你的要求的话，你还可以自定义脱敏规则。

多数据源

MyBaits-Flex 内置了功能完善的多数据源支持，无需借助其他第三方插件或者依赖，支持包括 druid、hikaricp、dbcp2、beecp 在内的任何数据源。

Spring 框架下的配置如下（无 Spring 框架的场景下，同样也可以编码的形式使用）：

mybatis-flex:
  datasource:
    ds1:
      type: druid
      url: jdbc:mysql://127.0.0.1:3306/db
      username: root
      password: 123456
      asyncInit: true
    ds2:
      type: com.your.datasource.type2
      url: jdbc:mysql://127.0.0.1:3306/db2
      username: root
      password: 123456

默认使用第一个配置的数据源，可以通过编码的方式其他的数据源。

List rows =  DataSourceKey.use("ds2"
    , () -> Db.selectAll("tb_account"));

在多租户等某些场景下，动态的添加新的数据源也是支持的。

FlexDataSource flexDataSource = (FlexDataSource) FlexGlobalConfig
        .getDefaultConfig().getConfiguration()
        .getEnvironment().getDataSource();

//新的数据源
HikariDataSource newDataSource = new HikariDataSource();

flexDataSource.addDataSource("newKey", newDataSource);

字段加密

字段加密指的是我们从数据库中取出数据的时候，对其中的一些字段进行加密，这样返回的内容为加密内容，而非明文内容。

字段加密的功能实现依赖于 MyBatis-Flex 实体类监听：

public class AccountOnSetListener implements SetListener {
    @Override
    public Object onSet(Object entity, String property, Object value) {

        if (value != null){
            //对字段内容进行加密
            value = encrypt(value);
        }

        return value;
    }
}

@Table(value = "tb_account", onSet = AccountOnSetListener.class)
public class Account {

    @Id(keyType = KeyType.Auto)
    private Long id;

    private String userName;

    private String password;

    //getter setter
}

除了字段加密之外，字典回写、字段权限、字段脱敏等功能的实现都依赖于实体类监听。

总结

这篇文章我们简单对比了 MyBatis-Flex 和 MyBatis-Plus ，并对 MyBatis-Flex 的个别核心功能进行了简单介绍。

更多关于 MyBatis-Flex 的介绍，大家可以去 MyBatis-Flex 的官网看看，地址：https://mybatis-flex.com/ 。

来源：https://mp.weixin.qq.com/s/wvk_twc-DCURiNiE5njFXA