FOR READ
ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › RAP 业务对象供应 › 业务对象提供者 API › 处理器类 › FOR READ
实施用于处理读取请求的处理器。
FOR READ 方法用于从应用程序缓冲区返回数据。如果缓冲区为空,则从数据库读取数据(通常填充应用程序缓冲区)。
有关 FOR READ处理器方法的详细信息,请参阅 FOR READ, RAP 处理器方法(ABAP 关键字文档)
有两个选项可以从应用程序缓冲区读取数据:
READ,请参阅 <方法> 待读取声明。READ,请参阅按关联读取 <方法> 的声明。
<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 官方机器翻译