Mybatis-Flex 是一个优雅的 Mybatis 增强框架，它非常轻量、同时拥有极高的性能与灵活性。我们可以轻松的使用 Mybaits-Flex 链接任何数据库，其内置的 QueryWrapper 帮助我们极大的减少了 SQL 编写的工作的同时，减少出错的可能性。
总而言之，Mybatis-Flex 能够极大地提高我们的开发效率和开发体验，让我们有更多的时间专注于自己的事情。
MyBatis-Flex v1.3.3 主要是增强了多表查询的功能，假设有 tb_account 用户表和 tb_article 文章表，他们的字段分别如下：
CREATE TABLE IF NOT EXISTS `tb_account`
(
`id` INTEGER PRIMARY KEY auto_increment,
`user_name` VARCHAR(100),
`age` Integer,
`birthday` DATETIME
);
CREATE TABLE IF NOT EXISTS `tb_article`
(
`id` INTEGER PRIMARY KEY auto_increment,
`account_id` Integer,
`title` VARCHAR(100),
`content` text
);
MyBatis-Flex 提供了 3 中方式，可以进行关联查询：
方式 1
1、定义 ArticleDTO 类，ArticleDTO 里定义 tb_account 表的字段映射。
public class ArticleDTO {
private Long id;
private Long accountId;
private String title;
private String content;
//以下用户相关字段
private String userName;
private int age;
private Date birthday;
}
然后直接通过 QueryWrapper 查询，代码如下：
QueryWrapper query = QueryWrapper.create()
.select(ARTICLE.ALL_COLUMNS)
.select(ACCOUNT.USER_NAME,ACCOUNT.AGE,ACCOUNT.BIRTHDAY)
.from(ARTICLE)
.leftJoin(ACCOUNT).on(ARTICLE.ACCOUNT_ID.eq(ACCOUNT.ID));
List<ArticleDTO> results = mapper.selectListByQueryAs(query, ArticleDTO.class);
System.out.println(results);
方式 2
假设 ArticleDTO 定义的属性和 数据库字段不一致时，例如：
public class ArticleDTO {
private Long id;
private Long accountId;
private String title;
private String content;
//以下用户字段 和 用户表定义的列不一致，表定义的列为 user_name
private String authorName;
private int authorAge;
private Date birthday;
}
那么， QueryWrapper 需要添加 as，修改如下：
QueryWrapper query = QueryWrapper.create()
.select(ARTICLE.ALL_COLUMNS)
.select(ACCOUNT.USER_NAME.as(ArticleDTO::getAuthorName)
,ACCOUNT.AGE.as(ArticleDTO::getAuthorAge)
,ACCOUNT.BIRTHDAY
)
.from(ARTICLE)
.leftJoin(ACCOUNT).on(ARTICLE.ACCOUNT_ID.eq(ACCOUNT.ID));
List<ArticleDTO> results = mapper.selectListByQueryAs(query, ArticleDTO.class);
System.out.println(results);
方式 3
1、在 ArticleDTO 直接定义 Account 实体类属性。 例如：
public class ArticleDTO {
private Long id;
private Long accountId;
private String title;
private String content;
//直接定义 Account 对象
private Account account;
}
查询方式和方式1一样，使用 QueryWrapper 构建 left join 查询，查询结果通过 ArticleDTO 类型接收。
QueryWrapper query = QueryWrapper.create()
.select(ARTICLE.ALL_COLUMNS)
.select(ACCOUNT.USER_NAME,ACCOUNT.AGE,ACCOUNT.BIRTHDAY)
.from(ARTICLE)
.leftJoin(ACCOUNT).on(ARTICLE.ACCOUNT_ID.eq(ACCOUNT.ID));
List<ArticleDTO> results = mapper.selectListByQueryAs(query, ArticleDTO.class);
System.out.println(results);
一对多查询
在以上的例子中，一个作者可能有多篇文档，假设 Account 的属性定义如下：
public class Article {
private Long id;
private String userName;
private int age;
//一个作者有多篇文章
private List<Article> articles;
}
那么，查询代码如下：
QueryWrapper query = QueryWrapper.create()
.select().form(ACCOUNT);
List<Account> accounts = mapper.selectListByQuery(query
, fieldQueryBuilder -> fieldQueryBuilder
.field(Account::getArticles) // 或者 .field("articles")
.queryWrapper(account -> QueryWrapper.create()
.select().from(ARTICLE)
.where(ARTICLE.ACCOUNT_ID.eq(account.getId())
)
)
);
知识点
MyBatis-Flex 的关联子查询，和 JPA 等其他第三方框架有很大的差异，比如 JPA 是通过配置来构建查询 SQL，其构建生成的 SQL 对于用户来说是不透明的。 因此，用户几乎无法对 JPA 的注解生成 SQL 优化。
而 MyBatis-Flex 关联子查询的 SQL 完全是由用户构建的，因此会更加灵活，更加有利于我们进行 SQL 优化。在子查询中，有很多的场景，JPA 一对一、 一对多等等不同的场景给出了不同的注解、以及参数，导致用户的学习成本非常高。另外，在很多业务场景下， 比如多租户、逻辑删除、等等 MyBatis-Flex 都是内部自动处理，而 JPA 通过注解的实现则是非常麻烦。
对 MyBatis-Flex 来说，学习成本是非常低的，在构建子查询时，只需要明白为哪个字段、通过什么样的 SQL 查询就可以了，以下是示例：
因此，在 MyBatis-Flex 的设计中，无论是一对多、多对一、多对多... 还是其他任何一种场景，其逻辑都是一样的。更多的文档请参考：https://mybatis-flex.com/zh/base/field-query.html
MyBatis-Flex v1.3.3 更新如下：
- 新增：添加动态表名和动态 Schema 的支持 #I6VRMF:建议增加动态变动TableInfo schema的扩展和动态表名功能 #I6WS3E:多租户动态数据源是否考虑支持 #I72X21:是否有分表自定义实现？类似mybatis-plus的动态分表
- 新增：添加 @Table(schema=xxx) 配置的支持 #I6VD6U:@Table注解 schema设置不生效
- 新增：Left join 等关联查询时，支持直接赋值对象属性的功能
- 新增：添加 QueryWrapper.toDebugSQL() 方法，方便用于调试
- 优化：Entity 父子类定义了相同字段时，应已子类优先
- 优化：对逻辑删除定义的非 Number 和 Bool 类型的 SQL 构建优化
- 优化：升级 MyBatis 到 3.5.13 最新版本
- 优化：升级 MyBatis 后，删除冗余的 FlexXMLConfigBuilder 实现
- 优化：升级 solon 版本，以支持原生编译功能，感谢 @西东
- 修复：分页查询在 left join 优化是，错误移除的问题
- 文档：优化 多表查询 的相关文档
- 文档：添加枚举属性构建 QueryWrapper 的相关文档
- 文档：添加自定义 MyBatis 的 Configuration 的文档
进一步了解 MyBatis-Flex 框架，请参考一下链接：
- 1、快速开始：https://mybatis-flex.com/zh/intro/getting-started.html
- 2、多表关联查询：https://mybatis-flex.com/zh/base/query.html
- 3、一对多、多对一：https://mybatis-flex.com/zh/base/field-query.html
- 4、灵活的 QueryWrapper：https://mybatis-flex.com/zh/base/querywrapper.html
- 5、逻辑删除：https://mybatis-flex.com/zh/core/logic-delete.html
- 6、乐观锁：https://mybatis-flex.com/zh/core/version.html
- 7、数据填充：https://mybatis-flex.com/zh/core/fill.html
- 6、数据脱敏：https://mybatis-flex.com/zh/core/mask.html
- 7、SQL 审计：https://mybatis-flex.com/zh/core/audit.html
- 8、多数据源：https://mybatis-flex.com/zh/core/multi-datasource.htm
- 9、事务管理：https://mybatis-flex.com/zh/core/tx.html
- 10、数据权限：https://mybatis-flex.com/zh/core/data-permission.html
- 11、字段权限：https://mybatis-flex.com/zh/core/columns-permission.html
- 12、字段加密：https://mybatis-flex.com/zh/core/columns-encrypt.html
- 13、字典回写：https://mybatis-flex.com/zh/core/columns-dict.html
- 14、枚举属性：https://mybatis-flex.com/zh/core/enum-property.html
- 15、动态表名：https://mybatis-flex.com/zh/core/dynamic-table.html
- 16、多租户：https://mybatis-flex.com/zh/core/multi-tenancy.html
- 17、代码生成器：https://mybatis-flex.com/zh/others/codegen.html
- 18、更好用的功能正在路上：https://mybatis-flex.com
和其他框架对比请参考：
- 1、和
MyBatis-Plus、Fluent-Mybatis【功能】方面的对比：https://mybatis-flex.com/zh/intro/comparison.html - 2、和
MyBatis-Plus【性能】方面的对比：https://mybatis-flex.com/zh/intro/benchmark.html
感谢大家关注 MyBatis-Flex ，让我们一起携手，打造新一代的 MyBatis 增强框架。
