1.9.8-M3 - 2026-02-28

• 1：枚举接口优化，增加 isEqCode/isNotEqCode以及EnumUtil工具类
• 2：修复多个主键原生批量修改异常问题
• 3：修复在spring初始化bean是无法使用mapper的问题
• 4：@ModelEntityField 增加 强制修改的开关属性
• 5：自动化设置单mapper，简化单mapper
• 6: 修复单mapper下updateBatch方法强制指定修改字段的问题

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();