读取

ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › 实体操作语言 (EML) › 使用 EML 访问业务对象的示例 › 读取

常规信息:READ

READ 语句提供对实体实例的读取访问权限,并返回请求的实例、字段和状态消息。此语句可用作基本操作,提供在后续业务逻辑中使用的必要数据。对于已启用草稿的业务对象,READ 返回属于实例的状态消息。

有关语法的详细信息,请参阅 READ ENTITY、ENTITIES(ABAP 关键字文档)。

有关实施合同的详细信息,请参阅实施合同:读取。

通过 IN LOCAL MODE 实施

仅当 EML 实施在其自己的行为池中使用 RAP BO 的实例时,才能实施 IN LOCAL MODE。附加项 IN LOCAL MODE 可确保在不检查访问控制、权限控制、功能控制或预检查的情况下直接访问 BO。有关语法的详细信息,请参阅 IN LOCAL MODE(ABAP 关键字文档)和 EML 操作数。

消耗

业务对象外部使用包括场景,例如单元测试,这些场景在独立于待测试业务对象的类中实施。其他场景是跨业务对象应用程序,其中业务对象使用彼此的操作在自定义 RAP 业务对象的行为池中实施其行为或使用已发布业务对象。在这些情况下,访问控制、权限控制和功能控制实施始终在请求期间触发,无法绕过。使用已发布业务对象时,自定义 RAP BO 的行为池中只能使用 BO(映射)的已发布部分。

示例:READ

以下语句读取由导入参数 keys 标识的差旅实例的开始日期、结束日期和语义标识。在参考业务对象的行为池中,此 READ 语句用于验证 validateDates 以提供要在后续检查中验证的数据。有关更多上下文信息以及此验证的完整代码,请参阅验证日期。

  READ ENTITIES OF /DMO/R_Travel_D IN LOCAL MODE
      ENTITY Travel
        FIELDS (  BeginDate EndDate TravelID )
        WITH CORRESPONDING #( keys )
      RESULT DATA(travels)
      FAILED DATA(failed)
      REPORTED DATA(reported).

READ 语句由关键字 READ ENTITIES OF 引入,后跟语句引用的业务对象的行为定义。

由于此语句包含在所引用业务对象的行为池中,因此使用关键字 IN LOCAL MODE。它们确保对返回所有数据集的基础 CDS 视图进行特权访问,即使访问控制在 DCL 中定义。

手头语句读取差旅实例的数据,因此指定了 ENTITY Travel。在此,我们使用为行为定义中的实体指定的别名。

下一行说明要在读取结果中包含其值的字段。

关键字 WITH CORRESPONDING #( keys ) 表示读取操作将对内部表中包含的主键的实例执行 keys。此内部表作为验证方法的导入参数提供。

关键字 RESULT 之后指定的内部表充当包含读取操作结果的响应参数。此响应参数的类型派生自指定的实体,以及框架触发的读取操作。

有关响应参数 FAILED 和 REPORTED 的信息,请参阅通用响应参数。

READ BY 关联

基本信息:READ BY 协会

READ BY association 语句使用 EML 语句中指定的实体的关联来读取关联实体的实例。

有关语法的详细信息,请参阅 READ ENTITY、ENTITIES(ABAP 关键字文档)。

有关实施合同的详细信息,请参阅实施合同:READ-BY-ASSOCIATION。

通过 IN LOCAL MODE 实施

仅当 EML 实施在其自己的行为池中使用 RAP BO 的实例时,才能实施 IN LOCAL MODE。附加项 IN LOCAL MODE 可确保在不检查访问控制、权限控制、功能控制或预检查的情况下直接访问 BO。有关语法的详细信息,请参阅 IN LOCAL MODE(ABAP 关键字文档)和 EML 操作数。

消耗

业务对象外部使用包括场景,例如单元测试,这些场景在独立于待测试业务对象的类中实施。其他场景是跨业务对象应用程序,其中业务对象使用彼此的操作在自定义 RAP 业务对象的行为池中实施其行为或使用已发布业务对象。在这些情况下,访问控制、权限控制和功能控制实施始终在请求期间触发,无法绕过。使用已发布业务对象时,自定义 RAP BO 的行为池中只能使用 BO(映射)的已发布部分。

示例:READ BY 关联

以下语句使用由导入参数 keys 标识的预订实例的 to parent-association 来读取其差旅实例的 UUID。在参考业务对象的行为池中,此 READ 语句用于预订实体的确定 calculateTotalPrice 以确定需要执行差旅价格重新计算的差旅 UUID。有关更多上下文信息以及此确定的完整代码,请参阅计算总价。

  READ ENTITIES OF /DMO/R_Travel_D IN LOCAL MODE
      ENTITY Booking BY \_Travel
        FIELDS ( TravelUUID  )
        WITH CORRESPONDING #(  keys  )
      RESULT DATA(travels)
 LINK DATA(link)
 FAILED DATA(failed)
 REPORTED DATA(reported).

读取语句由关键字 READ ENTITIES OF 引入,后跟语句引用的业务对象的行为定义。

由于此读取语句包含在所引用业务对象的行为池中,因此使用关键字 IN LOCAL MODE。它们确保对返回所有数据集的基础 CDS 视图进行特权访问,即使访问控制在 DCL 中定义。

现有语句读取差旅实例的数据,但使用为预订实体指定的关联。因此,指定了 ENTITY Booking。在此,我们使用为行为定义中的实体指定的别名。

要指示读取操作将由关联执行,请使用语法 BY \。之后,使用在相应 CDS 实体中指定的关联的名称。

下一行说明读取结果中仅包含字段 TravelUUID 的值。

关键字 WITH CORRESPONDING #( keys ) 表示将对内部表中包含的主键的实例执行读取操作 keys。此内部表作为确定方法的导入参数提供。

关键字 RESULT 之后指定的内部表充当包含读取操作结果的响应参数。此响应参数的类型派生自指定的实体,以及框架触发的读取操作。

在关键字 LINK 之后声明的内部表充当另一个响应参数。其中包含逐个读取操作中涉及的源实体实例和目标实体实例的主键。由于在这种情况下使用关联 _Travel,因此源为预订实例,目标是差旅实例。此响应参数的类型派生自指定的实体,以及框架触发的读取操作。响应参数 LINK 未在上述确定中使用。

有关响应参数 FAILED 和 REPORTED 的信息,请参阅通用响应参数。

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

← 使用 EML 访问业务对象的示例 · 修改 →