与 Mybatis-plus 对比，Mybatis-Flex v1.0.9 发布
Mybatis-Flex 是一个优雅的 Mybatis 增强框架，它非常轻量、同时拥有极高的性能与灵活性。我们可以轻松的使用 Mybaits-Flex 链接任何数据库，其内置的 QueryWrapper 帮助我们极大的减少了 SQL 编写的工作的同时，减少出错的可能性。
总而言之，Mybatis-Flex 能够极大地提高我们的开发效率和开发体验，让我们有更多的时间专注于自己的事情。
Mybatis-Flex v1.0.9 主要是增加了多租户以及对 Solon 支持的功能，同时继续完善了许多文档，到目前为止，Mybatis-Flex 的文档字数可能要比 Mybatis-Flex 的代码量还要多，我们始终认为：文档大于代码。具体的多租户功能请移步文档：https://mybatis-flex.com/zh/multi-tenancy.html
Mybatis-Flex v1.0.9 具体更新内容如下：
- 新增：新增 多租户 使用的相关模块
- 新增：BaseMapper 添加 deleteByCondition 和 updateByCondition 方法
- 新增：添加 paginate 的更简单易用的相关方法
- 新增：QueryMethods 添加 column() 方法
- 新增：ConsoleMessageCollector 用于在控制台输出 SQL 及其执行时间
- 新增：QueryWrapper 添加 union 和 union all 的支持
- 新增：mybatis-flex-solon-plugin 插件，方便在 solon 框架下使用
- 修复：@Table(onSet) 配置在某些场景无法使用的问题
- 修复：Postgresql 的 limit offset 方言出错的问题
- 修复：多数据源的场景下，通过 @Table(dataSource) 配置无效的问题
- 优化：修改错别字 processer 为 processor
- 优化：优化 DbAutoConfiguration 未正确配置数据源时的错误信息
- 优化：Row 添加 getString()/getInt() 等等相关方法
- 优化：代码生成器通过 SqlServer 生成出错的问题
- 文档：优化 QueryWrapper 的相关文档
- 文档：优化 SQL 审计的相关文档
- 文档：添加 SQL 控制台打印输出的相关文档
- 文档：添加多租户的相关文档
- 文档：优化逻辑删除的相关文档
和其他框架对比
功能对比
MyBatis-Flex 主要是和 MyBatis-Plus 与 Fluent-Mybatis 对比，内容来源其官网、git 或者 网络文章，若有错误欢迎指正。
- MyBatis-Plus：老牌的 MyBatis 增强框架
- Fluent-Mybatis：阿里云开发的 Mybatis 增强框架（来至于阿里云·云效产品团队）
| 功能或特点 | MyBatis-Flex | MyBatis-Plus | Fluent-Mybatis |
|---|---|---|---|
| 对 entity 的基本增删改查 | ✅ | ✅ | ✅ |
| 分页查询 | ✅ | ✅ | ✅ |
| 分页查询之总量缓存 | ✅ | ❌ | ❌ |
| 分页查询无 SQL 解析设计（更轻量，及更高性能） | ✅ | ❌ | ✅ |
| 多表查询： from 多张表 | ✅ | ❌ | ❌ |
| 多表查询： left join、inner join 等等 | ✅ | ❌ | ✅ |
| 多表查询： union，union all | ✅ | ❌ | ✅ |
| 单主键配置 | ✅ | ✅ | ✅ |
| 多种 id 生成策略 | ✅ | ✅ | ✅ |
| 支持多主键、复合主键 | ✅ | ❌ | ❌ |
| 字段的 typeHandler 配置 | ✅ | ✅ | ✅ |
| 除了 Mybatis，无其他第三方依赖（更轻量） | ✅ | ❌ | ❌ |
| QueryWrapper 是否支持在微服务项目下进行 RPC 传输 | ✅ | ❌ | 未知 |
| 逻辑删除 | ✅ | ✅ | ✅ |
| 乐观锁 | ✅ | ✅ | ✅ |
| SQL 审计 | ✅ | ❌ | ❌ |
| 数据填充 | ✅ | ✔️ （收费） | ✅ |
| 数据脱敏 | ✅ | ✔️ （收费） | ❌ |
| 字段权限 | ✅ | ✔️ （收费） | ❌ |
| 字段加密 | ✅ | ✔️ （收费） | ❌ |
| 字典回显 | ✅ | ✔️ （收费） | ❌ |
| Db + Row | ✅ | ❌ | ❌ |
| Entity 监听 | ✅ | ❌ | ❌ |
| 多数据源支持 | ✅ | 借助其他框架或收费，不支持非Spring项目 | ❌ |
| 多租户 | ✅ | ✅ | ❌ |
以上内容来自第三方相关产品的官方文档或第三方平台，若有错误，欢迎纠正。
基础查询
MyBatis-Flex：
QueryCondition condition = EMPLOYEE.LAST_NAME.like("B")
.and(EMPLOYEE.GENDER.eq(1))
.and(EMPLOYEE.AGE.gt(24));
List<Employee> employees = employeeMapper.selectListByCondition(condition);
MyBatis-Plus：
QueryWrapper<Employee> queryWrapper = new QueryWrapper<>();
queryWrapper
.like("last_name","B")
.eq("gender",1)
.gt("age",24);
List<Employee> employees = employeeMapper.selectList(queryWrapper);
或者使用 MyBatis-Plus 的 LambdaQueryWrapper 写法：
LambdaQueryWrapper<Employee> queryWrapper = new LambdaQueryWrapper<>();
queryWrapper
.like(Employee::getUserName,"B")
.eq(Employee::getGender,1)
.gt(Employee::getAge,24);
List<Employee> employees = employeeMapper.selectList(queryWrapper);
Fluent-MyBatis：
EmployeeQuery query = new EmployeeQuery()
.where.lastName().like("B")
.and.gender().eq(1)
.and.age().gt(24)
.end();
List<Employee> employees = employeeMapper.listEntity(query);
查询集合函数
MyBatis-Flex：
QueryWrapper query = new QueryWrapper()
.select(
ACCOUNT.ID,
ACCOUNT.USER_NAME,
max(ACCOUNT.BIRTHDAY),
avg(ACCOUNT.SEX).as("sex_avg")
);
List<Employee> employees = employeeMapper.selectListByQuery(query);
MyBatis-Plus：
QueryWrapper<Employee> queryWrapper = new QueryWrapper<>();
queryWrapper
.select(
"id"
,"user_name"
,"max(birthday)"
,"avg(birthday) as sex_avg"
);
List<Employee> employees = employeeMapper.selectList(queryWrapper);
Fluent-MyBatis：
EmployeeQuery query = new EmployeeQuery()
.select
.id()
.userName()
.max.birthday()
.avg.sex("sex_avg")
.end()
List<Employee> employees = employeeMapper.listEntity(query);
and(...) 和 or(...)
假设我们要构建如下的 SQL 进行查询（需要在 SQL 中添加括号）。
SELECT * FROM tb_account
WHERE id >= 100
AND (sex = 1 OR sex = 2)
OR (age IN (18,19,20) AND user_name LIKE "%michael%" )
MyBatis-Flex：
QueryWrapper query = QueryWrapper.create()
.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")));
MyBatis-Plus：
QueryWrapper<Employee> query = new QueryWrapper<>();
queryWrapper.ge("id",100)
.and(i->i.eq("sex",1).or(x->x.eq("sex",2)))
.or(i->i.in("age",{18,19,20}).like("user_name","michael"));
Fluent-Mybatis：
AccountQuery query = new AccountQuery()
.where.id().ge(100)
.and(
new AccountQuery().where.sex().eq(1).or(
new AccountQuery().where.sex().eq(2).end()
).end())
.or(
new AccountQuery().where.age.in(18,19,20)
.and.userName().like("michael").end()
)
.end();
多表查询 1
MyBatis-Flex：
QueryWrapper query = QueryWrapper.create()
.select().from(ACCOUNT)
.leftJoin(ARTICLE).on(ACCOUNT.ID.eq(ARTICLE.ACCOUNT_ID))
.where(ACCOUNT.AGE.ge(10));
List<Account> accounts = mapper.selectListByQuery(query);
MyBatis-Plus：
// 不支持~~~~
Fluent-MyBatis：
StudentQuery leftQuery = new StudentQuery("a1").selectAll()
.where.age().eq(34)
.end();
HomeAddressQuery rightQuery = new HomeAddressQuery("a2")
.where.address().like("address")
.end();
IQuery query = leftQuery
.join(rightQuery)
.on(l -> l.where.homeAddressId(), r -> r.where.id()).endJoin()
.build();
List<StudentEntity> entities = this.mapper.listEntity(query);
多表查询 2
假设查询的 SQL 如下：
SELECT a.id, a.user_name, b.id AS articleId, b.title
FROM tb_account AS a, tb_article AS b
WHERE a.id = b.account_id
MyBatis-Flex：
QueryWrapper query = new QueryWrapper()
.select(
ACCOUNT.ID
, ACCOUNT.USER_NAME
, ARTICLE.ID.as("articleId")
, ARTICLE.TITLE)
.from(ACCOUNT.as("a"), ARTICLE.as("b"))
.where(ACCOUNT.ID.eq(ARTICLE.ACCOUNT_ID));
MyBatis-Plus：
// 不支持~~~~
Fluent-MyBatis：
// 不支持~~~~
PS：也有可能是我自己不知道如何支持，而非 Fluent-MyBatis 原因，有知道的同学可以给下示例代码。
部分字段更新
假设一个实体类 Account 中，我们要更新其内容如下：
userName为 "michael"age为 "18"birthday为 null
其他字段保持数据库原有内容不变，要求执行的 SQL 如下：
update tb_account
set user_name = "michael", age = 18, birthday = null
where id = 100
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<Account> updateWrapper = new UpdateWrapper<>();
updateWrapper.eq("id", 100);
updateWrapper.set("user_name", "michael");
updateWrapper.set("age", 18);
updateWrapper.set("birthday", null);
accountMapper.update(null, updateWrapper);
Fluent-Mybatis 代码如下：
AccountUpdate update = new AccountUpdate()
.update.userName().is("michael")
.age().is(18)
.birthday().is(null)
.end()
.where.id().eq(100)
.end();
accountMapper.updateBy(update);
进一步了解 MyBatis-Flex 框架，请参考一下链接：
- 1、快速开始：https://mybatis-flex.com/zh/getting-started.html
- 2、强大的 QueryWrapper：https://mybatis-flex.com/zh/querywrapper.html
- 3、逻辑删除：https://mybatis-flex.com/zh/logic_delete.html
- 4、乐观锁：https://mybatis-flex.com/zh/version.html
- 5、数据填充：https://mybatis-flex.com/zh/fill.html
- 6、数据脱敏：https://mybatis-flex.com/zh/mask.html
- 7、SQL 审计：https://mybatis-flex.com/zh/audit.html
- 8、多数据源：https://mybatis-flex.com/zh/multi-datasource.html
- 9、多租户：https://mybatis-flex.com/zh/multi-tenancy.html
- 10、更多企业级的功能正在路上：https://mybatis-flex.com
