🚀 开篇：当MyBatis遇上"魔法"
还在为繁琐的SQL编写而烦恼吗？还在为多数据库兼容性而头疼吗？Xbatis来了！作为一款基于MyBatis的增强型ORM框架，Xbatis不仅保留了MyBatis的灵活性，更带来了前所未有的开发效率提升。 README.md:16-18
✨ 核心技术亮点
1. 流式DSL：让SQL编写如诗般优雅
告别字符串拼接的痛苦，Xbatis的流式API让代码既安全又优雅：
// 传统MyBatis需要复杂的XML或注解 // Xbatis一行搞定
List<SysUser> users = QueryChain.of(sysUserMapper)
.eq(SysUser::getId, 1)
.like(SysUser::getUserName, "admin")
.list();
README.md:625-637
2. 智能SQL优化：性能提升的"黑科技"
Xbatis内置的SQL优化器会自动：
- 移除冗余的LEFT JOIN
- 简化COUNT查询
- 优化分页SQL
- 智能ORDER BY处理
这意味着你写的代码越少，数据库执行效率反而越高！ README.md:19-20
3. 单Mapper模式：大型项目的架构革新
对于拥有数百个实体的项目，Xbatis的单Mapper模式让你只需一个BasicMapper就能搞定所有CRUD操作：
// 一个Mapper统治所有实体
@Autowired private MybatisBasicMapper mybatisBasicMapper;
// 通用CRUD
mybatisBasicMapper.save(new SysUser());
mybatisBasicMapper.deleteById(SysUser.class, 1);
README.md:492-508
4. 跨数据库兼容：一次编写，到处运行
支持MySQL、PostgreSQL、Oracle、SQL Server等12种主流数据库，通过dbAdapt轻松处理数据库差异： README.md:70-82
🏗️ 企业级特性开箱即用
多租户支持
@TenantId private String tenantId;
// 自动注入租户ID，查询自动过滤
TenantContext.registerTenantGetter(() -> getCurrentTenantId());
README.zh-CN.md:778-784
逻辑删除
@LogicDelete(beforeValue = "0", afterValue = "1")
private LocalDateTime deleteTime;
README.zh-CN.md:786-791
乐观锁
@Version private Integer version; // 自动处理并发冲突
README.zh-CN.md:803-806
🎯 与其他框架的差异化优势
| 特性 |
MyBatis |
Hibernate |
Xbatis |
| SQL控制 |
✅ 完全控制 |
❌ 黑盒 |
✅ 智能优化 |
| 学习曲线 |
⭐⭐⭐ |
⭐⭐⭐⭐ |
⭐⭐ |
| 性能 |
⭐⭐⭐⭐ |
⭐⭐⭐ |
⭐⭐⭐⭐⭐ |
| 多数据库 |
⭐⭐⭐ |
⭐⭐ |
⭐⭐⭐⭐⭐ |
| 企业特性 |
⭐⭐ |
⭐⭐⭐⭐ |
⭐⭐⭐⭐⭐ |
🚀 5分钟快速上手
1. 添加依赖
<dependency>
<groupId>cn.xbatis</groupId>
<artifactId>xbatis-spring-boot3-starter</artifactId>
<version>1.9.3</version>
</dependency>
README.md:70-76
2. 实体定义
@Table
public class SysUser {
@TableId private Integer id;
private String userName;
private String password;
}
README.md:186-214
3. Mapper接口
public interface SysUserMapper extends MybatisMapper<SysUser> {
}
4. 开始使用
@Service
public class UserService {
@Autowired private SysUserMapper userMapper;
public List<SysUser> searchUsers(String keyword) {
return QueryChain.of(userMapper)
.forSearch(true) // 自动忽略空值
.like(SysUser::getUserName, keyword)
.list();
}
}
🎪 真实应用场景
场景1：复杂报表查询
// 多表关联+聚合函数，一行搞定
List<UserRoleVO> report = QueryChain.of(userMapper)
.select(UserRoleVO.class)
.from(SysUser.class)
.join(SysUser::getRoleId, SysRole::getId)
.groupBy(SysRole::getId)
.having(c -> c.count(SysUser::getId).gt(5))
.list();
场景2：批量数据处理
// 批量插入+冲突处理
mapper.save(userList, strategy ->
strategy.onConflict(action ->
action.doUpdate(update -> update.overwrite(SysUser::getStatus))
)
);
README.md:586-594
场景3：分表查询
@SplitTable(UserTableSplitter.class)
public class SysUser {
@SplitTableKey
private String userId;
// ...
}
README.zh-CN.md:808-815
🔧 开发者友好特性
AI代码生成支持
Xbatis专门为AI代码生成优化，提供：
- 启动时POJO安全检查
- 智能代码补全提示
- 标准化代码模板 README.md:920-930
完善的代码生成器
GeneratorConfig config = new GeneratorConfig()
.setBasePackage("com.example")
.setMapperConfig(mapper -> mapper.enable(false).superClass(MybatisBasicMapper.class)
);
README.md:908-914
🌟 为什么选择Xbatis？
- 零学习成本：基于MyBatis，现有代码无缝迁移
- 性能卓越：接近原生SQL执行效率 README.md:27-29
- 功能完备：覆盖90%以上SQL场景 README.md:29-30
- 生产就绪：Apache 2.0开源，经过大量项目验证 pom.xml:40-44
🎊 总结
Xbatis不是要取代MyBatis，而是要让MyBatis变得更好。它像一位经验丰富的DBA，默默为你优化SQL；又像一位贴心的助手，帮你处理繁琐的样板代码。
在微服务、云原生时代，Xbatis为Java开发者提供了一个既灵活又高效的数据访问解决方案。无论你是个人开发者还是企业团队，Xbatis都能让你的数据访问层开发事半功倍！
立即体验：
加入我们，一起重新定义MyBatis开发体验！ 🚀
Notes
本文基于Xbatis 1.9.3版本编写，框架持续迭代中，最新特性请参考官方文档。Xbatis采用Apache 2.0开源协议，欢迎社区贡献和反馈。 pom.xml:25-27
Wiki pages you might want to explore:
