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 的支持版本号#I6WS3E:多租户动态数据源是否考虑支持版本号#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 增强框架。