2026 最好用的 ORM 框架：xbatis 1.9.7 正式发布，基于 mybatis 的 ORM 框架

夏涛酱_5510

发布时间：2026-01-20 19:16:07

1232人浏览过

来源于php中文网

原创

1.9.7 版本更新日志

1：VO 字段注解现支持通过 set 方法上的注解覆盖默认行为
2：数据库类型适配能力增强，新增对自定义 DbType 的全面支持
3：getById 方法扩展，新增 getOptionalById 方法，返回 Optional<t></t> 类型结果
4：QueryChain 新增 Optional 相关方法，与 get() 方法形成配套支持
5：内置 UUIDv7 主键生成策略，满足高性能、时序安全的主键需求

1.8.7 版本更新日志：

1：为提升 java 与 xml 协同开发体验，query 和 where 模块新增 tableas(实体类, 别名) 方法，支持灵活指定表别名

2：配置类 XbatisConfig 已重命名为 XbatisGlobalConfig，语义更清晰、结构更统一

3：新增逻辑删除全局拦截器，开箱即用，无需手动编写删除标记逻辑

4：update 与 delete 操作支持原生 RETURNING 子句（数据库原生语法），直接获取变更数据

5：新增原生 SQL 查询接口，并同步支持 update/delete RETURNING 功能

6：引入通用 Mapper 方法拦截器机制，便于统一处理执行前/后逻辑

WordPress API Pro

生产级WordPress REST API集成，用于管理文章、页面、媒体、WooCommerce产品、Elementor内容、SEO元数据、ACF及JetEngine字段

下载

7：简化 exists / not exists 场景写法，提供更直观的链式调用支持

通用 SQL 扩展能力：

// 支持任意类型：实体类、VO 或普通 POJO  
SysUser user = sysUserMapper.select(SysUser.class, "select * from t_sys_user where id =?", 1);  
<p>// 支持增删改操作，并可返回指定字段值（如更新后的新用户名）<br />
String user_name = sysUserMapper.executeAndReturning(String.class, "update t_sys_user set user_name=? where id=1 RETURNING user_name", "xxx");  </p><p>// ORM 风格：删除并返回被删记录（基于数据库原生 RETURNING）<br />
List<SysUser> list = DeleteChain.of(sysUserMapper)<br />
.in(SysUser::getId, 1, 2)<br />
.returning(SysUser.class)<br />
.returnType(SysUser.class)<br />
.executeAndReturningList();  </p><p>// ORM 风格：更新并返回更新后的完整对象（适用于金额加减等需确认结果场景）<br />
SysUser sysUser = UpdateChain.of(sysUserMapper)<br />
.eq(SysUser::getId, 1)<br />
.set(SysUser::getUserName, "abc2")<br />
.returning(SysUser.class)<br />
.returnType(SysUser.class)<br />
.executeAndReturning();

分表配置示例：

@Data<br />
@SplitTable(SysUserSplitter.class)<br />
public class SysUser {<br />
@TableId<br />
private Integer id;<br />
@SplitTableKey<br />
private Integer groupId;<br />
private String nickname;<br />
private String username;<br />
}

public class SysUserSplitter implements TableSplitter {<br />
@Override<br />
public boolean support(Class<?> type) {<br />
return type == Integer.class || type == int.class;<br />
}  </p><pre class="brush:php;toolbar:false;">@Override  
public String split(String sourceTableName, Object splitValue) {  
    Integer groupId = (Integer) splitValue;  
    // 按 groupId 取模分 10 张子表  
    return sourceTableName + "_" + (groupId % 10);  
}

}

分表逻辑简洁明了，其余 CRUD 操作完全透明，与单表无异！！！

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：深度数据库兼容能力：同一套代码可无缝切换多种数据库（连 Hibernate 都难以做到的跨库一致性） 6：API 设计极度精简，上手零门槛，开发者无需反复查阅文档

单表 + @Fetch 注解 + fetchFilter 方法

@Data<br />
@ResultEntity(SysUser.class)<br />
public class SysUserVo {<br />
private Integer id;<br />
private String userName;<br />
private String password;<br />
private Integer roleId;<br />
private LocalDateTime create_time;<br />
@Fetch(source = SysUser.class, property = "roleId", target = SysRole.class, targetProperty = "id")<br />
private List<SysRoleVo> sysRoles;<br />
}

List<SysUserVo> list = QueryChain.of(sysUserMapper)<br />
.from(SysUser.class)<br />
.fetchFilter(SysUserVO::getRoles, where -> where.eq(SysRole::getStatus, 1))<br />
.returnType(SysUserVO.class)<br />
.list();

fetchFilter 是对 @Fetch 的增强补充，常规场景下可忽略使用

单表查询示例

SysUser sysUser = QueryChain.of(sysUserMapper)<br />
.eq(SysUser::getId, 1)<br />
.eq(SysUser::getUserName, "admin")<br />
.get();

VO 映射能力

@Data<br />
@ResultEntity(SysUser.class)<br />
public class SysUserVo {<br />
private Integer id;<br />
private String userName;<br />
// 字段名不一致时通过注解映射<br />
@ResultEntityField(property = "password")<br />
private String pwd;<br />
}

SysUserVO sysUserVO = QueryChain.of(sysUserMapper)<br />
.eq(SysUser::getId, 1)<br />
.eq(SysUser::getUserName, "admin")<br />
.returnType(SysUserVO.class)<br />
.get();

JOIN 查询支持

@Data<br />
@ResultEntity(SysUser.class)<br />
public class SysUserVo {<br />
private Integer id;<br />
private String userName;<br />
// 字段名不一致时映射<br />
@ResultEntityField(property = "password")<br />
private String pwd;  </p><pre class="brush:php;toolbar:false;">// 一对一嵌套映射  
@NestedResultEntity(target = SysRole.class)  
private SysRole sysRole;  

// 一对多嵌套映射  
@NestedResultEntity(target = SysRole.class)  
private List<SysRole> sysRoles;

}

List<SysUserRoleVO> list = QueryChain.of(sysUserMapper)<br />
.from(SysUser.class)<br />
.join(SysUser.class, SysRole.class)<br />
.returnType(SysUserRoleVO.class)<br />
.list();