Fluent MyBatis

Fluent MyBatis 简介

Fluent MyBatis 是一个基于 MyBatis 的现代化、类型安全的 ORM（对象关系映射） 框架，旨在通过 Fluent API（流式 API） 和 代码生成 技术，显著提升 Java 开发者的数据库操作效率。相比传统的 MyBatis，Fluent MyBatis 提供了更直观的链式调用语法、更严格的编译期检查，以及更智能的 SQL 生成能力，特别适合需要复杂查询和高性能数据访问的应用场景。

核心特性

1. Fluent API（流式查询）
   • 支持链式方法调用，如 .where().and().orderBy()，使 SQL 构建更直观
   • 避免手写 XML 或注解 SQL，减少错误
2. 类型安全 & 编译期检查
   • 所有字段引用均通过 Lambda 表达式 或 实体属性，避免硬编码字段名
   • 编译期即可发现 SQL 语法错误，减少运行时异常
3. 动态 SQL 支持
   • 内置强大的条件构造器（Query / Update / Delete），支持复杂条件拼接
   • 支持动态表名、动态字段名（适用于分表场景）
4. 代码生成工具
   • 提供 Fluent MyBatis Generator，一键生成 Entity、Mapper、DAO 代码
   • 生成的代码包含完整的 Fluent API 支持，开箱即用
5. 与 MyBatis 生态兼容
   • 完全兼容原生 MyBatis 的 @Select / @Update 等注解
   • 支持与 PageHelper 等 MyBatis 插件集成
6. 性能优化
   • 智能缓存生成的 SQL，避免重复解析
   • 支持批量操作（batchInsert() / batchUpdate()）

典型应用场景

• 企业级 CRUD 系统：快速开发后台管理界面
• 复杂查询应用：如报表统计、多表关联分析
• 分库分表场景：动态表名支持
• 微服务架构：轻量级 ORM 方案，替代 JPA/Hibernate

核心组件

1. **FluentMyBatis**
   • 核心入口类，提供代码生成和配置管理
2. **Entity**
   • 生成的实体类，包含所有数据库字段的 Lambda 引用
3. **Mapper**
   • 自动生成的 Mapper 接口，支持 Fluent API
4. **Query / Update / Delete**
   • 动态 SQL 构造器，支持链式调用
5. **Wrapper**
   • 条件包装器，简化 WHERE / HAVING 等子句的编写

使用示例

1. 链式查询（Lambda 方式）

List<UserEntity> users = new UserQuery()
    .where.age().ge(18)
    .and.username().like("张%")
    .orderBy.createTime().desc()
    .execute(mapper);

2. 动态更新

int rows = new UserUpdate()
    .set.password("newPassword")
    .where.id().eq(1L)
    .and.isDeleted().eq(false)
    .execute(mapper);

3. 代码生成（Maven 插件）

<plugin>
    <groupId>com.github.fluentmybatis</groupId>
    <artifactId>fluent-mybatis-generator</artifactId>
    <version>1.8.0</version>
    <configuration>
        <jdbcUrl>jdbc:mysql://localhost:3306/test</jdbcUrl>
        <username>root</username>
        <password>123456</password>
    </configuration>
</plugin>

性能优化建议

1. 启用 SQL 缓存
   • 配置 fluent.mybatis.cache-enabled=true 减少 SQL 解析开销
2. 批量操作优化
   • 使用 batchInsert() 替代循环单条插入
3. 避免 N+1 查询
   • 通过 join() 或子查询优化关联查询
4. 合理使用索引
   • 在生成的 Entity 类中通过 @Table(indexes = {...}) 定义索引