首页
/ Ebean ORM 14.9.0版本发布:Kotlin支持增强与API清理

Ebean ORM 14.9.0版本发布:Kotlin支持增强与API清理

2025-07-01 15:37:05作者:裘旻烁

项目简介

Ebean ORM是一个轻量级的Java/Kotlin ORM框架,以其简单易用和性能优化著称。它提供了自动化的数据库操作、查询生成以及事务管理等功能,让开发者能够更专注于业务逻辑的实现。

版本亮点

14.9.0版本是Ebean ORM的一个重要更新,主要聚焦于Kotlin语言支持的改进以及API的清理优化工作。这个版本不仅修复了一些关键问题,还对一些过时的API进行了移除,为未来的发展奠定了基础。

核心变更解析

1. Kotlin查询Bean生成器修复

本次更新修复了Kotlin查询Bean生成器在使用@DbMap注解时的问题。@DbMap注解用于定义实体属性与数据库列的映射关系,在Kotlin环境下这个修复确保了类型安全的查询构建能够正常工作。

2. 无ID实体计数查询优化

对于没有@Id注解的实体类,Ebean现在能够正确处理findCount()操作。这个改进特别适用于视图实体或复杂查询场景,解决了某些数据库平台需要列别名的问题。

3. 事务API简化

14.9.0版本对事务相关的API进行了清理:

  • 移除了QueryBean中接收Transaction参数的构造函数,推荐使用query.usingTransaction()方法
  • 移除了query.update(txn)query.delete(txn)等过时方法,统一使用usingTransaction()方式

4. 查询API改进

  • 废弃的filterMany(String expressions, Object... params)方法被移除,这是查询构建API清理的一部分
  • 移除了order()方法,统一使用orderBy()方法,使API命名更加一致

5. 模块化支持增强

新增了对模块路径(module path)上@Transactional注解的支持,这是Java模块系统兼容性的重要改进,使Ebean在现代Java应用中能够更好地工作。

6. 方法句柄SPI扩展

引入了MethodHandles.Lookup SPI支持,这是一个底层但强大的功能,允许更灵活的方法访问控制,为框架扩展提供了更多可能性。

升级建议

对于现有项目升级到14.9.0版本,开发者需要注意以下几点:

  1. 检查是否使用了已被移除的API,如order()filterMany()等,并按照建议迁移到新API
  2. 如果项目中使用Kotlin并涉及@DbMap注解,这个版本修复了相关问题
  3. 事务相关代码可能需要调整,使用新的usingTransaction()方式
  4. 对于模块化Java应用,现在可以更安全地使用@Transactional注解

总结

Ebean ORM 14.9.0版本在保持框架轻量级特性的同时,通过API清理和Kotlin支持增强,进一步提升了开发体验和框架的现代化程度。这些改进不仅解决了现有问题,也为框架的未来发展奠定了更坚实的基础。对于追求简洁高效数据库访问层的Java/Kotlin项目来说,这个版本值得考虑升级。

登录后查看全文
热门项目推荐
相关项目推荐