MyBatis-Flex

MyBatis-Flex 简介

MyBatis-Flex 是一个基于 MyBatis 的轻量级、高性能、增强型 ORM（对象关系映射）框架，旨在简化数据库操作并提升开发效率。相比传统的 MyBatis，MyBatis-Flex 提供了更灵活的查询方式、更强大的动态 SQL 支持，以及更便捷的代码生成工具，特别适合现代 Java 应用开发，尤其是微服务和高并发场景。

核心特性

1. 灵活的查询方式
   • 支持 链式 API 构建复杂查询，无需手写 XML
   • 提供 Lambda 表达式 支持，避免硬编码字段名
   • 支持 多表关联查询，自动优化 SQL 执行
2. 强大的动态 SQL
   • 内置动态条件构造器（QueryWrapper），支持复杂条件拼接
   • 支持 逻辑删除、乐观锁、多租户 等企业级功能
   • 提供 SQL 审计，可拦截并优化 SQL 执行
3. 高性能与轻量级
   • 无侵入性设计，兼容原生 MyBatis
   • 智能缓存机制，减少重复 SQL 解析
   • 支持 分库分表，适用于大数据量场景
4. 代码生成工具
   • 提供 MyBatis-Flex Generator，一键生成 Entity、Mapper、Service 代码
   • 支持自定义模板，适配不同项目需求
5. 与 Spring/Spring Boot 深度集成
   • 无缝集成 Spring Boot 自动配置
   • 支持 Spring Transaction 事务管理

典型应用场景

• 企业级 CRUD 应用：快速开发后台管理系统
• 微服务架构：支持分布式数据库访问
• 高并发查询：优化复杂 SQL 执行效率
• 多租户 SaaS 系统：内置租户隔离方案

核心组件

1. FlexMapper
   • 增强版 Mapper 接口，支持链式查询
2. QueryWrapper
   • 动态 SQL 构造器，支持条件组合
3. BaseMapper
   • 内置通用 CRUD 方法，减少重复代码
4. MyBatis-Flex Generator
   • 代码生成工具，提升开发效率

使用示例

1. 链式查询（Lambda 方式）

List<User> users = userMapper.selectList()
    .where(User::getAge).ge(18)
    .and(User::getName).like("张%")
    .orderBy(User::getCreateTime.desc())
    .list();

2. 动态条件构造（QueryWrapper）

QueryWrapper query = QueryWrapper.create()
    .select()
    .from(USER)
    .where(USER.AGE.ge(18))
    .and(USER.NAME.like("张%"));
List<User> users = userMapper.selectListByQuery(query);

3. 逻辑删除 & 乐观锁

@Table("tb_user")
public class User {
    @Column(isLogicDelete = true) // 逻辑删除标记
    private Boolean deleted;
    
    @Version // 乐观锁
    private Integer version;
}

性能优化建议

1. 合理使用索引
   • 通过 @Table(indexes = {...}) 定义索引
2. 避免 N+1 查询
   • 使用 join 或 selectWithRelations 优化关联查询
3. 启用 SQL 缓存
   • 配置 mybatis-flex.configuration.cache-enabled=true