业务事件消耗

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 服务使用 · 重用 →