业务事件消耗
ABAP RESTful 应用程序编程模型 › 使用 RAP 业务对象和事件 › 业务事件消耗
RAP 业务对象引发的 RAP 业务事件可以在本地或远程使用。
备注
可以为审批合同审批事件。有关详细信息,请参阅已发布 API。
备注
使用 CDS 视图实体定义托管事件的有效负载。缺省情况下,RAP 框架使用
PRIVILEGED访问权限访问此视图实体。这意味着在读取有效负载数据时不执行权限检查。
本地使用
业务事件可以在引发时在同一系统中使用。此本地使用在事件处理器类的帮助下实施。事件处理器类设置为类池,类似于行为池。
要使用的事件需要在 C1 已发布的 RAP BO 接口中公开。
备注
对于业务事件的本地使用,不需要远程通信。因此,既不需要服务绑定,也不需要与事件交换基础架构的连接。
由于临时问题(如草稿实例上的锁定),本地事件可能无法执行。自动重试功能可以在框架中尝试重新启动本地事件执行(最多三次)来解决这些问题。要启用此功能,您可以创建继承自
CX_RAP_EVENT_HDLR_ERROR_RETRY的自定义异常。在事件处理器方法中引发这些异常,指定重试的延迟,以对任何阻止成功执行本地事件的问题做出反应。
创建事件处理器类
1.创建将用作事件处理器类的类。对于全局类的介绍语法,请使用关键字 FOR EVENTS OF ,后跟包含要使用的事件的行为定义的名称。
CLASS cl_local_event_consumption DEFINITION
PUBLIC
ABSTRACT
FINAL
FOR EVENTS OF root_entity.
2.在局部类型中包含的局部类的定义部分中,将 cl_abap_behavior_event_handler 作为要继承的父类包括在内。
CLASS lcl_local_event_consumption DEFINITION INHERITING FROM cl_abap_behavior_event_handler.
3.为每个要处理的事件定义方法。在方法签名中,指定导入参数、实体以及要使用的事件。
PRIVATE SECTION.
METHODS consume_event_1 FOR ENTITY EVENT importing_parameter_1 FOR my_entity~event_1.
METHODS consume_event_2 FOR ENTITY EVENT importing_parameter_2 FOR my_entity~event_2.
...ENDCLASS.
CLASS lcl_local_event_consumption IMPLEMENTATION.
METHOD consume_event_1.
CHECK importing_parameter_1 IS NOT INITIAL.
... ENDMETHOD.
METHOD consume_event_2.
CHECK importing_parameter_2 IS NOT INITIAL.
... ENDMETHOD.
ENDCLASS.
备注
在事件处理器类中,一个事件只能由一种方法处理。但是,可以跨多个处理器类进行方法处理。
事件处理器类的完整示例
在此示例中,每次创建业务对象时都会发送电子邮件。
展开以下代码示例以查看源代码。
全局类:
示例代码
CLASS cl_local_event_consumption DEFINITION
PUBLIC
ABSTRACT
FINAL
FOR EVENTS OF root_entity.
PUBLIC SECTION.
PROTECTED SECTION.
PRIVATE SECTION.
ENDCLASS.
CLASS cl_local_event_consumption IMPLEMENTATION.
ENDCLASS.
展开以下代码示例以查看源代码。
局部类型:
示例代码
CLASS lcl_abap_behv_event_handler DEFINITION INHERITING FROM cl_abap_behavior_event_handler.
PRIVATE SECTION.
METHODS consume_created FOR ENTITY EVENT created_instances FOR root_entity~created.
ENDCLASS.
CLASS lcl_abap_behv_event_handler IMPLEMENTATION.
METHOD consume_created.
LOOP AT created_instances INTO DATA(created_instance).
" Example for processing of table content
some_mail_api=>send_mail(
recipient = created_instance-recipient
message_body = |The instance { created_instance-id } was created|
).
ENDLOOP.
ENDMETHOD.
ENDCLASS.
远程使用
通过租用相应的消息传递队列,可以从 SAP Event Mesh 中使用远程系统中引发的业务事件。使用 SAP Event Mesh 的前提条件是为相应产品的入站和出站通信配置的通信安排。
有关 SAP Event Mesh 的详细信息,请参阅什么是 SAP Event Mesh?。
事件使用模型可以使用 RAP BO 发布的远程事件。
要使用的事件需要在 C2 发布的事件版本中公开。
来源:SAP Help Portal · 2025 FPS02 (Oct 2026) · 中文为 SAP 官方机器翻译
← OData 服务使用 · 重用 →