1.9.9 - 2026-04-13
- 1：增加 partialUpdate 精准 (局部) 修改方法
- 2：原生 updateBatch 修改增加 null / 默认值忽略设置方法
- 3：LambdaUtil 类增加 setter/getter Lambda 生成方法
- 4：@ResultCalcField 注解支持数据库函数
- 5：修复 exists/notExists 中子查询嵌套子查询时，别名一致导致无法上下级引用的问题
- 6：增加 join 子查询的简化写法
- 7：所有 Mp 开头的类 改为 Xbatis 开头
- 8：优化 selectIgnore 功能，不再要求先 select
- 9：增加 orderByAsc 方法，减少从 mybatis-plus 迁移到 xbatis 的工作量
- 10：优化底层代码
- 11：增加 resultmap 官方动态映射继承
- 12：所有查询完美兼容 pageHelper
- 13：对于顶级类的字段增加列为为字段名的 resultMap 映射
- 14：支持多列 in-notIn 操作
- 15：@Fetch 支持合并查询（从 2 层到 1 层转变，减少 VO 创建）
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和普通POJOSysUser 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 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();Java
代码解读 复制代码
展开代码 ▼
分表配置
@Data @SplitTable(SysUserSplitter.class)publicclassSysUser{ @TableIdprivateInteger id; @SplitTableKeyprivateInteger groupId;privateString nickname;privateString username; }Java
代码解读 复制代码
展开代码 ▼
publicclassSysUserSplitterimplementsTableSplitter{ @Overridepublicbooleansupport(Class type) {returntype == Integer.class ** type == int.class; } @OverridepublicStringsplit(String sourceTableName, Object splitValue) { Integer groupId = (Integer) splitValue;//分成10个表returnsourceTableName + "_" + groupId % 10; } }Java
代码解读 复制代码
展开代码 ▼
分表就是这么简单，其他操作和常规无异！！！
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)publicclassSysUserVo{privateInteger id;privateString userName;privateString password;privateInteger roleId;privateLocalDateTime create_time; @Fetch(source = SysUser.class, property = "roleId", target = SysRole.class, targetProperty = "id")privateList sysRoles; }Java
代码解读 复制代码
展开代码 ▼
List list = QueryChain.of(sysUserMapper) .from(SysUser.class) .fetchFilter(SysUserVO::getRoles,where->where.eq(SysRole::getStatus,1)) .returnType(SysUserVO.class) .list();Java
代码解读 复制代码
fetchFilter 方法是对 @Fetch 注解的增强，没有特殊要求一般，可忽略
2. 单表查询
SysUser sysUser = QueryChain.of(sysUserMapper) .eq(SysUser::getId, 1) .eq(SysUser::getUserName,'admin') .get();Java
代码解读 复制代码
3.VO 映射
@Data @ResultEntity(SysUser.class)publicclassSysUserVo{privateInteger id;privateString userName;//字段名字不一样时@ResultEntityField(property = "password")privateString pwd; }Java
代码解读 复制代码
展开代码 ▼
SysUserVO sysUserVO = QueryChain.of(sysUserMapper) .eq(SysUser::getId, 1) .eq(SysUser::getUserName,'admin') .returnType(SysUserVO.class) .list();Java
代码解读 复制代码
4. join 查询
@Data @ResultEntity(SysUser.class)publicclassSysUserVo{privateInteger id;privateString userName;//字段名字不一样时@ResultEntityField(property = "password")privateString pwd;//映射一个对象 1对1@NestedResultEntity(target = SysRole.class) prviate SysRole sysRole;//映射多个对象 1对多@NestedResultEntity(target = SysRole.class) prviate List sysRoles; }Java
代码解读 复制代码
展开代码 ▼
List list = QueryChain.of(sysUserMapper) .from(SysUser.class) .join(SysUser.class, SysRole.class) .returnType(SysUserRoleVO.class) .list();Java
代码解读 复制代码
还有很多很多超级方便有趣的写法，欢迎大家来使用 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 更简单更容易扩展，再也不怕被框架限制了
