RAP 事务模型和 SAP LUW

ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › RAP BO 运行时 › RAP 事务模型和 SAP LUW

本主题介绍 RAP 如何支持受控制 SAP LUW 的事务模型。逻辑工作单元 (LUW) 是用于将数据从数据库的一致状态传输到另一个一致性状态的所有工序和工作进程的总和。

ABAP RESTful Application Programming Model (RAP) 不引入自己的 LUW 概念,而是使用 SAP LUW 的规则和概念。RAP 通过固有检查事务上下文严格遵守 SAP LUW 的规则,并且仅允许开发人员使用或调用与事务上下文匹配的实施。从这个意义上讲,受控的 SAP LUW 本质上内置在 RAP 中。有关 SAP LUW 期间事务一致性的详细信息,请参阅受控制 SAP LUW。

为确保应用程序和所有相关方(例如其他业务对象)工作一致并与所有 LUW 前提条件保持一致,高度复杂场景的事务建模可能会变得繁琐且无法预见。使用 RAP 进行开发时,缺省情况下可实现包括所有相关方的一致事务建模。通过遵守 RAP 提供的框架来确保这一点,该框架需要检查所有不同的用例,与受控的 SAP LUW 检查上下文完全相同。RAP 固有检查可确保应用程序一致且稳定,以及涉及多个业务对象时。

RAP 将 LUW 划分为交互阶段和**保存顺序。在交互阶段,可以在事务缓冲区中以不一致的状态更改和创建数据。保存顺序可确保数据的新状态一致,并准备好写入数据库。然后,在保存序列期间也会执行最终数据库提交。当成功执行数据库提交并清除事务缓冲区时,或者如果数据库提交不成功,LUW 将终止。在后一种情况下,必须完全回滚当前 LUW 的所有工作进程。这意味着,LUW 不得在任何数据库或事务缓冲区上留下任何遗留。对于业务对象外部程序也是如此。RAP 框架提供了触发此清理工作的选项。请参阅保存顺序。

RAP 事务模型无缝嵌入到 SAP LUW 中。用于终止 SAP LUW COMMIT WORK 和 ROLLBACK WORK 触发器 COMMIT ENTITIES 和 ROLLBACK ENTITIES 的语句,从而使用 RAP 过程终止 LUW。

备注

以下违反 SAP LUW 原则的行为将始终导致 RAP 上下文中出现运行时错误:

  • COMMIT WORK 或 ROLLBACK WORK 的显式使用。事务处理和数据库提交仅由 RAP 处理。

  • 在交互阶段或早期保存阶段调用后台任务 (bgPF) 中的更新。

仅当在面向云开发的 ABAP 中实施 RAP 行为定义并应用 strict(2)模式时,某些其他操作才会导致运行时错误:

  • 在保存顺序期间调用权限检查

  • 在交互阶段或早期保存阶段修改数据库操作。

  • 在交互阶段或提前保存阶段引发业务事件

  • (隐式或显式)保存阶段的主数据库连接数据库提交。

有关详细信息,请参阅常规 RAP 业务对象实施合同。

必须锁定一个 LUW 中涉及的每个业务对象实体实例,以避免访问冲突。锁定与 LUW 的生命周期紧密耦合。业务对象实体实例的锁持续到 LUW。每次提交数据库或回滚时,都会释放锁,并且可以在新的 LUW 中使用同一业务对象实例。有关 RAP 中锁定概念的详细信息,请参阅悲观并发控制(锁定)。

交互阶段

使用 RAP 业务对象的数据意味着操作数据库中的数据:您可以创建新数据,也可以修改现有数据。这两种方法都需要额外的内存区域来存储当前正在处理的数据。此区域称为事务缓冲区。在托管的业务对象中,事务缓冲区由托管的业务对象提供者完全处理。对于非托管业务对象,事务缓冲区由应用程序开发人员在非托管业务对象提供者内实施。新创建的数据,即在事务缓冲区中创建新的业务对象实例,并从此处进一步处理。从数据库中检索现有数据并将其加载到事务缓冲区以进行进一步处理,例如更改业务对象实例的值。在此期间,数据库中的数据保持一致状态。换句话说,当业务对象实例在数据库表中一致时,事务缓冲区中业务对象实例的状态可能会变得不一致。

下图显示如何从数据库表中检索数据,以及在事务缓冲区中修改数据。

交互阶段

在交互阶段,通过 RAP 操作对事务缓冲区进行数据修改,请参阅操作和确定。在此阶段,数据不必处于一致状态。

注意

交互阶段不进行一致性检查。这意味着,正在处理的数据始终可能不一致。因此,不允许在该阶段触发任何直接更改数据库数据的过程。这将基于可能不一致的数据状态,并且没有机制在保存之前检查数据。

如果交互阶段的任何工作进程失败,使用者将收到通知并可以重新启动请求。

草稿场景中的持久事务缓冲区

由于草稿场景的无状态方法,在此类场景中,逻辑 LUW 可以拆分为多个 ABAP 会话。从技术上讲,一个 LUW 将分为多个数据库 LUW。事务缓冲区的状态必须中间存储,并且必须存在在 ABAP 会话终止后仍然存在的持久锁。使用已启用草稿的业务对象时,事务缓冲区上的每个更改(即一个技术 LUW 中的更改集)都将保存到草稿数据库表中。这可确保草稿数据不会丢失。这样,不一致的数据可能会到达草稿数据库表。但是,此数据库表的内容与流程无关。将最新事务缓冲区写入草稿持久性是交互阶段的一部分,因此保存顺序与草稿持久性无关。有关事务缓冲区和草稿数据库表之间交互的详细信息,请参阅草稿运行时。

下图显示了事务缓冲区在草稿表中的持久性。

事务缓冲区已保存到数据库表

保存顺序

在保存序列期间,交互阶段的数据更改将保存到持久数据库表。它通过 EML 请求 COMMIT ENTITIES 调用,可由 EML 使用者或 RAP 事务引擎调用,例如在处理 OData 更改集时。有关保存顺序及其阶段的更多详细信息,请参阅保存序列运行时。

保存顺序可确保事务缓冲区中所有涉及业务对象的业务对象实例处于一致状态,并准备保存到数据库。如果不是这种情况,保存序列的早期阶段(FINALIZE 或 CHECK_BEFORE_SAVE)将失败,并且 COMMIT ENTITIES 请求返回 sy-subrc=4。在这种情况下,为所有涉及的业务对象调用保护程序方法 CLEANUP_FINALIZE,确保清除当前 LUW 中涉及的所有业务对象的事务缓冲区。然后,保存序列将在没有任何数据库提交的情况下终止,并且可以进一步修改业务对象实例以达到一致状态。

如果早期保存阶段成功,则会触发实际保存到数据库,并且必须成功执行。负责的保护程序方法为 ADJUST_NUMBERS 和 SAVE。前者在延迟编号场景中获取最终编号。后一种方法最终保存数据并执行数据库提交。可通过 CONVERT_KEY 获取其他参考对象的数量。SAVE 成功终止了 SAP LUW。COMMIT ENTITIES 请求返回 sy-subrc=0。可以触发依赖于成功数据库提交的外部工作进程。

RAP 业务对象在延迟保存阶段也可能失败 (SAVE)。COMMIT ENTITIES 请求返回 sy-subrc=8。在这种情况下,当前 LUW 不一致,所有更改必须回滚到最后一个一致状态。因此,不允许在 LUW 的任何时间点(尤其是在延迟保存阶段)触发 ROLLBACK ENTITIES 无法撤销的任何过程。如果出现此类失败,可以使用 EML 的显式后续 ROLLBACK ENTITIES 解救 ABAP 会话,并将定期处理后续 OData 更改集。

RAP 中 SAP LUW 的事务阶段

SAP LUW 包含两个事务阶段:

  • 修改

  • 保存

有关详细信息,请参阅受控制的 SAP LUW。

这些阶段及其包含的检查也用于 RAP。但是,它们与 RAP 中的两个主要部分(交互阶段和保存序列)不一致。下表说明了 SAP LUW 到 RAP 的事务阶段映射。

事务阶段

事务阶段

RAP 中 SAP LUW 中的阶段

修改

RAP 交互阶段:

在 RAP 交互阶段,可以触发标准操作,例如创建、读取、更新、删除或其他操作。更改存储在事务缓冲区中。

早期保存阶段(作为 RAP 保存序列的一部分):

可以对事务缓冲区中的数据进行最终检查和更改。可能存在多个相关方实施业务对象,甚至涉及多个业务对象。因此,如果它们处于一致状态并且更改可以持久化,则所有这些都可以报告,这一点很重要。如果出现错误,可以返回到交互阶段,以便更正错误。例如,对于涉及最终用户的 UI 场景也是如此。预计在早期保存阶段后不会发生用户或业务相关错误。

保存

延迟保存阶段(作为 RAP 保存序列的一部分):

保存阶段延迟的主要任务是,将事务缓冲区中的一致数据保存到数据库。在 ABAP Cloud 中,这是通过使用 ABAP SQL 的直接数据库更新来完成的。在传统 ABAP 中,您还可以使用更新任务。

达到延迟保存阶段(如果早期保存阶段没有错误)会标记不返回点。与早期保存阶段不同,当您到达延迟保存阶段时,无法返回到交互阶段。延迟保存阶段以成功提交结束,或者更改回滚并发生运行时错误。保存延迟阶段之后是清除事务缓冲区的清理阶段。

SAP LUW 期间 RAP 中的信息流

有时,需要将与业务对象实例相关的信息从交互阶段传递到保存顺序,而无需与数据模型相关的信息。此类信息可用于评估是否必须在延迟保存阶段触发外部或异步流程。

示例

可能需要通知外部 RAP BO 使用者有关数据库更改的信息。此通知流程只能在将数据保存到数据库时触发,因为之前的任何步骤都可能会在 LUW 中失败,并且可能会通知使用者有关未有效发生的更改。因此,只能在实际保存步骤或保存顺序中的附加保存期间触发此类流程或通知。

要评估在保存序列的保存阶段是否必须触发此类流程,可以将辅助字段添加到 CDS 中的事务数据模型。此字段不需要在数据库中具有持久性,而是仅作为临时字段添加到 CDS 中(技术上由转型完成)。此辅助字段可以在交互阶段使用保存序列的保存阶段期间的相关信息填充,并在实际保存发生时进行评估。

注意

必须始终确保在延迟保存阶段触发的过程可以完全回滚,而无需当前 SAP LUW 中的任何余量。

SAP LUW 期间的 RAP 活动

下图显示了 RAP 中 SAP LUW 期间的活动。

RAP LUW 期间的活动

来源:SAP Help Portal · 2025 FPS02 (Oct 2026) · 中文为 SAP 官方机器翻译

← 操作运行时 · 保存序列运行时 →