🔥新崛起 - orm 框架：xbatis，超好用！！！1.9.1-M8 发布

1.9.1-M8 - 2025-09-20

• 1：修复对象转条件多表条件配置报异常问题
• 2：优化exists条件方法，更优雅
• 3：增加对象动态排序
• 4：修复oracle-batchSave原生批量会去重的问题
• 5：兼容PageHelper支持配合xbatis-lambda分页
• 6：新增mapWithKeyAndValue方法
• 7：统一查询结果为空时的List Map为可修改的List和Map
• 8：修改@Conditions注解逻辑默认为OR
• 9：注解@Fetch 增加memoryLimit，采用内存limit前几条
• 10：新增cross join支持
• 11：动态默认值增加强制设置配置
• 12：增加Mapper支持原生update批量修改支持

---

1.8.7 更新内容：

1：为了更好的 JAVA+XML 结合，query 和 where 增加 tableAs (实体类，别名) 方法，用于自定义表名别名

2：XbatisConfig 改为 XbatisGlobalConfig

3：增加逻辑删除拦截器

4：update delete 增加 原生 RETURNING (原生) 功能

5：增加原生 sql 查询方法和 update delete RETURNING 功能

6：增加了一个 Mapper 方法拦截器

7：增加 exists/not exists 简易写法

通用 SQL 扩展：

//类型支持 实体类，VO和普通POJO SysUser user = sysUserMapper.select(SysUser.class, "select * from t_sys_user where id =?", 1); //支持增删改，且支持返回数据 String user_name = sysUserMapper.executeAndReturning(String.class, "update t_sys_user set user_name=? where id=1 RETURNING user_name", "xxx"); //ORM写法 删除并返回被删除的数据（数据库原生操作） List<SysUser> list = DeleteChain.of(sysUserMapper) .in(SysUser::getId, 1, 2) .returning(SysUser.class) .returnType(SysUser.class) .executeAndReturningList(); //ORM写法 修改并返回修改后的数据（数据库原生操作）适合金额加减操作返回剩余金额 SysUser sysUser = UpdateChain.of(sysUserMapper) .eq(SysUser::getId, 1) .set(SysUser::getUserName, "abc2") .returning(SysUser.class) .returnType(SysUser.class) .executeAndReturning();

分表配置

@Data @SplitTable(SysUserSplitter.class) public class SysUser { @TableId private Integer id; @SplitTableKey private Integer groupId; private String nickname; private String username; } public class SysUserSplitter implements TableSplitter { @Override public boolean support(Class<?> type) { return type == Integer.class || type == int.class; } @Override public String split(String sourceTableName, Object splitValue) { Integer groupId = (Integer) splitValue; //分成10个表 return sourceTableName + "_" + groupId % 10; } }

分表就是这么简单，其他操作和常规无异！！！

1.7.7 更新内容：

• 1：QueryChain,DeleteChain,InsertChain,UpdateChain 支持 BasicMapper 方法
• 2：支持通用 BasicMapper，可不需要创建多个实体类 Mapper；一个 BasicMapper 即可使用所有功能
• 3：正式支持单 Mapper (写一个 Mapper 即可)

为什么推荐 xbatis？：

xbatis 是一款超级强大的 ORM 框架

1：可多表 join（不再只能单表了）

2：代码分页，xml 还可以分页（可以不用 pagehelper 了）

3：良好的扩展能力：orm+sql 模板 （让 ORM 框架不再死板，扩展性极强）

4：强大的各种数据库适配，可在一套代码中 实现多个数据库适配；真正的 ORM hibernate 都做不到

6：极简的 api 设计，让开发者 不再迷糊

1. 单表 +@Fetch 注解 + fetchFilter 方法

@Data @ResultEntity(SysUser.class) public class SysUserVo { private Integer id; private String userName; private String password; private Integer roleId; private LocalDateTime create_time; @Fetch(source = SysUser.class, property = "roleId", target = SysRole.class, targetProperty = "id") private List<SysRoleVo> sysRoles; } List<SysUserVO> list = QueryChain.of(sysUserMapper) .from(SysUser.class) .fetchFilter(SysUserVO::getRoles,where->where.eq(SysRole::getStatus,1)) .returnType(SysUserVO.class) .list();

fetchFilter 方法是对 @Fetch 注解的增强，没有特殊要求一般，可忽略

2. 单表查询

SysUser sysUser = QueryChain.of(sysUserMapper) .eq(SysUser::getId, 1) .eq(SysUser::getUserName,'admin') .get();

3.VO 映射

@Data @ResultEntity(SysUser.class) public class SysUserVo { private Integer id; private String userName; //字段名字不一样时 @ResultEntityField(property = "password") private String pwd; } SysUserVO sysUserVO = QueryChain.of(sysUserMapper) .eq(SysUser::getId, 1) .eq(SysUser::getUserName,'admin') .returnType(SysUserVO.class) .list();

4. join 查询

@Data @ResultEntity(SysUser.class) public class SysUserVo { private Integer id; private String userName; //字段名字不一样时 @ResultEntityField(property = "password") private String pwd; //映射一个对象 1对1 @NestedResultEntity(target = SysRole.class) prviate SysRole sysRole; //映射多个对象 1对多 @NestedResultEntity(target = SysRole.class) prviate List<SysRole> sysRoles; } List<SysUserRoleVO> list = QueryChain.of(sysUserMapper) .from(SysUser.class) .join(SysUser.class, SysRole.class) .returnType(SysUserRoleVO.class) .list();

还有很多很多超级方便有趣的写法，欢迎大家来使用 xbatis.cn

例如：

1 . 多表 join A 内嵌 B B 内嵌 C 都可以

2 . 不使用 join 使用 @Fetch 注解 + fetchFilter 方法实现 将 A JOIN B 变成 query A + query B

3 . 使用 @Paging 注解 实现你的 xml 自动分页

4 . 使用 SQL 模板，让你 ORM 更简单更容易扩展，再也不怕被框架限制了

作者：Ai东
链接：https://juejin.cn/post/7551754641131225114
来源：稀土掘金
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。