FOR READ

ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › RAP 业务对象供应 › 业务对象提供者 API › 处理器类 › FOR READ

实施用于处理读取请求的处理器。

FOR READ 方法用于从应用程序缓冲区返回数据。如果缓冲区为空,则从数据库读取数据(通常填充应用程序缓冲区)。

有关 FOR READ处理器方法的详细信息,请参阅 FOR READ, RAP 处理器方法(ABAP 关键字文档)在非 SAP 站点发布的信息

有两个选项可以从应用程序缓冲区读取数据:

<method> FOR READ

与 <method> FOR MODIFY 类似,还会实施处理器 <method> FOR READ 来处理批量请求。它还旨在捆绑多个操作。

 METHODS method_name FOR READ
        [IMPORTING] read_import_parameter FOR READ entity
        RESULT read_result_parameter.

同样,为了提高可读性,可以在导入参数之前指定关键字 IMPORTING。可自由选择导入参数 read_import_parameter 的名称。它导入要读取的实例实体的键值,并指示请求的元素。

占位符 entity 是指要从行为定义中读取或读取行为定义中定义的别名的实体(例如 CDS 视图)的名称。

参数 RESULT 是更改参数。可以自由选择其名称。

导入参数

导入表的行类型 read_import_parameter 提供以下内容:

  • 标识字段

    在相关 CDS 视图中指定为键值的所有元素。

  • %CONTROL

    控制结构反映使用者请求的元素。

导出参数

  • read_result_parameter

    返回成功读取的数据。

    此表的行类型提供在读取的 实体的元素列表中指定的所有元素。仅必须填充 %control 结构中指示的请求元素。

更改参数

除显式声明的 return 参数外, READ 方法还提供隐式 CHANGING 、 failed mapped 和 reported 参数。

  • failed 参数用于记录无法读取的条目。您可以为 READ 指定失败原因,例如 not_found。

  • mapped 实施中不得填充 READ 参数。

  • reported 实施中不得填充 READ 参数。

有关隐式声明的参数的详细信息,请参阅隐式响应参数。

<method> FOR READ 声明(按关联)

通过关联 READ 的语法与直接 READ 的语法类似。

 METHODS
      method_name   FOR READ
        [IMPORTING] read_ba_import_parameter FOR READ entity\_association
        FULL full_read_import_parameter
        RESULT read_result_parameter
        LINK read_link_parameter.

对于其他操作实施,可以选择显式指定关键字 IMPORTING。所有参数名称都可以自由选择。

导入参数 read_ba_import_parameter 导入应读取其关联实体实例的实体实例的键值。此外,还指示应从关联实体中读取哪些元素。

占位符 entity 是指实体的名称(例如 CDS 视图)或行为定义中定义的别名(关联源)。

占位符 association 是指要读取数据的关联,例如,如果要读取与一个差旅实例相关联的所有预订,则为 _booking。

参数 full_read_import_parameter 指示是必须填充 RESULT 参数还是仅必须填充 LINK 参数。它具有布尔值。

参数 RESULT 是导出参数。如果设置了 FULL 参数,则返回导入参数中指示的请求元素。

参数 LINK 也是导出参数。无论是否设置 FULL parameter,它都会返回源实体和目标实体的关键元素。

导入参数

  • 导入表的行类型 read_ba_import_parameter 提供以下数据:

    • 标识字段

      在相关 CDS 视图中指定为键值的所有元素。

    • %CONTROL

      控制结构反映使用者请求的关联实体的哪些元素。

  • 导入参数 full_read_import_parameter 的类型是具有布尔值的字符。

导出参数

  • read_result_parameter:如果设置了 FULL 参数,则返回从关联实体成功读取数据。

    此表的行类型提供在读取的 实体的元素列表中指定的所有元素。仅必须填充 %control 结构中指示的请求元素。

  • read_link_parameter:返回成功读取实体实例的源键值和目标键值。

更改参数

除显式声明的参数外,通过关联的 READ 方法还提供隐式 CHANGING 、 mapped 和 reported 参数 failed。

  • failed 参数用于记录无法读取的条目。您可以为 READ 指定失败原因,例如 not_found。

  • mapped 实施中不得填充 READ 参数。

  • reported 实施中不得填充 READ 参数。

有关隐式声明的参数的详细信息,请参阅隐式响应参数。

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

← FOR LOCK · 功能的 →