事件驱动的 RAP 副作用
ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › RAP 业务对象供应 › RAP 业务对象行为 › RAP 副作用 › 事件驱动的 RAP 副作用
您可以定义业务事件(以下简称“事件”)以在 RAP 业务对象中触发 RAP 副作用。每当应用服务器引发定义的事件时,都会触发 RAP 副作用并重新加载定义的目标。
使用事件驱动的 RAP 副作用的原因和时间
想象一下:两个或多个旅行社使用同一预订管理工具验证系统中的某些未完成预订。每当其中一个代理批准或拒绝预订时,应用程序服务器都会相应地触发用户界面的 RAP 副作用,该用户界面随后更新受影响的字段,即这种情况下差旅实体中的 Overall Status 字段。然后,在同一工具中工作的所有其他代理都可以看到预订的实际更新状态。因此,避免重复处理同一预订。
实施事件驱动的 RAP 副作用允许进行异步操作。在我们的场景中,首先,用户发起操作。完成该操作的处理后,服务器会在用户界面上更新受影响的数据值、权限或消息。因此,其他用户可以查看更新并收到所做更改的通知。
有关事件的详细信息,请参阅业务事件。
有关 RAP 副作用的详细信息,请参阅 RAP 副作用。
限制
执行以完整清单为目标的事件驱动副作用时,不会重新加载清单报表中新创建的项目。执行事件驱动的副作用后,只能更新清单报表中已存在的项目。
实施
RAP 负面影响的事件
在 RAP 业务对象的行为定义中定义事件驱动的 RAP 副作用。首先,必须使用关键字 event EventName 定义事件。定义事件后,必须在 RAP 副作用中将事件定义为触发器。使用语法 for side effects 指示此事件用于 RAP 副作用。
示例代码
event BookingProcessed for side effects;
RAP 副作用
向行为定义添加 RAP 副作用。使用语法 event 指示 RAP 副作用由事件触发。添加受影响的目标,例如字段。
示例代码
side effects
{
event BookingProcessed affects field ( OverallStatus );
}
如果您具有托管实施,则需要将 with additional save 或 with unmanaged save 添加到行为定义以引发 RAP 副作用的事件。只能在行为实施的延迟保存阶段引发该事件。
示例代码
managed
with additional save
implementation in class /dmo/bp_flight unique;
示例代码
managed
with additional save
implementation in class /dmo/bp_flight unique;
define behavior for /DMO/R_FLIGHT alias Bookings
persistent table /dmo/a_travel
draft table /dmo/d_travel
[...]
{
[...]
event BookingProcessed for side effects;
side effects
{
event BookingProcessed affects field ( OverallStatus );
}
投影
与行为定义中定义的其他行为一样,必须在每个投影行为定义和接口中公开事件驱动的 RAP 副作用以供使用。使用语法 use event 指示此事件应可用。添加 use side effects 以为投影启用 RAP 副作用。
限制
如果您在业务对象的同一服务绑定中同时公开了草稿实体和非草稿实体,则无法运行事件驱动的副作用。
示例代码
projection;
strict ( 2 );
use draft;
use side effects;
define behavior for /DMO/C_FLIGHT alias Bookings
[...]
use event BookingProcessed;
[...]
}
有关详细信息,请参阅 ABAP RESTful 应用程序编程模型的开发指南中的开发 RAP 负面影响部分和开发业务事件部分。