🔥 xbatis ORM 框架 1.9.1-正式发布，一款好用、简单、便捷的框架！！
1.9.1- 2025-10-22
- 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 批量修改支持
- 13: @ResultField 注解支持多列名映射
- 14：SQL 模板支持，特殊字符包裹（解决单引号的问题）
- 15：其他优化，增加更多条件开关方法
- 16：支持 PG distinct on (xxx) 排重功能
- 17：支持表、列名全部大小写设置
- 18：Mapper 方法拦截器支持官方自带方法拦截
- 19：对象转条件增加 NOT/NULL 空 / 非空的功能
- 20：增加计算字段注解 ResultCalcField，用于自动 select 计算字段，例如 count,sum 等等计算字段
- 21：优化原生 SQL 操作，支持动态 where 拼接
- 22：增加日期年月时分秒增减方法
- 23：增加启动时安全检查功能，针对 @ResultEnity @ConditionTarget @OrderByTarget 等非实体类的检测
-
24：其他优化
1.8.7 更新内容：
1：为了更好的 JAVA+XML 结合，query 和 where 增加 tableAs (实体类，别名) 方法，用于自定义表名别名
2：XbatisConfig 改为 XbatisGlobalConfig
3：增加逻辑删除拦截器
4：update delete 增加 原生 RETURNING (原生) 功能
5：增加原生 sql 查询方法和 update delete RETURNING 功能
6：增加了一个 Mapper 方法拦截器
通用 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();
还有很多很多超级方便有趣的写法，欢迎大家来使用 https://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 更简单更容易扩展，再也不怕被框架限制了
