SuperAPI AI 工具集

bx-orm-event-system

通用与其它

查看项目

更新于 10-16 03:13

技能介绍

用途:bx-orm-event-system 是 BoxLang ORM 的事件系统,负责把 Hibernate 原生事件模型与 BoxLang 的拦截框架连接起来。它注册一个 Hibernate Integrator,挂接实体生命周期各阶段事件,并将其转换为 BoxLang 拦截公告和实体级事件处理器调用。

主要能力:EventListener 实现 Integrator 及多个 Hibernate 监听接口,在 integrate() 中通过 registry.prependListeners 注册 PRE_INSERT、POST_INSERT、PRE_DELETE、POST_DELETE、DELETE、PRE_UPDATE、POST_UPDATE、PRE_LOAD、POST_LOAD、AUTO_FLUSH、FLUSH、EVICT、CLEAR、DIRTY_CHECK 等事件类型。每个事件回调先构造 args 结构,再按需调用全局监听器,最后调用实体级处理器。全局监听器由 eventHandler 配置惰性实例化。TransactionManager 拦截 BoxLang 事务事件,映射为 Hibernate 会话事务操作,如 onTransactionBegin 对每个数据源执行 session.beginTransaction(),以及提交、回滚、保存点等。ApplicationListener 处理应用启动与关闭,调用 ormService.startupORMApplication 与 shutdownORMApplication。

使用方式:实体类可实现 preInsert、postLoad、preUpdate 等处理器方法,EventListener 会自动发现并调用。新增 Hibernate 事件类型需实现对应监听接口、在 integrate() 中注册并实现回调。分发前需先解包 BoxProxy,调用 getRunnable()。

限制:嵌套事务不支持;事件处理器不应抛出异常;requiresPostCommitHanding() 返回 false;全局监听器为惰性实例化;事务事件按数据源逐个触发。具体配置项与完整 API 以官方资料为准,部分细节暂未提供。