FOR MODIFY
ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › RAP 业务对象供应 › 业务对象提供者 API › 处理器类 › FOR MODIFY
处理实体的所有更改操作。
FOR MODIFY 方法实施在行为定义中指定的标准操作创建、更新、删除和应用程序特定操作。
提示
FOR MODIFY方法可以在一个处理步骤中处理多个实体(根、项目、子项目)和多个操作。在某些情况下,将处理器实施拆分为单独的方法可能很有用。然后,可以定义多个行为处理程序,即一个全局行为池甚至多个全局行为池中的多个局部行为类。
<method> FOR MODIFY
<method> FOR MODIFY 的声明表示此方法所负责的更改操作。在极端情况下,这是根据行为定义可能的所有更改操作的总数。
modify_method FOR MODIFY 声明中的每个单独规范由操作与实体或实体部分的组合组成。要引用实体,请使用行为定义中给定的别名(如果有)。
每个操作类型都有一个用于传入实例数据 和 的导入参数 <operation>_import_parameter。其名称可自由选择。如果操作类型需要导出参数 action_export_parameter 则方法包括导出参数。例如,操作可以具有结果的导出参数。
CREATE、UPDATE 和 CREATE by association 的导入参数包括控制结构 %control 以识别哪些字段已由调用者填充。
您可以在单个 <method> FOR MODIFY 中声明所有操作:
METHODS modify_method FOR MODIFY
[IMPORTING]
create_import_parameter FOR CREATE entity
update_import_parameter FOR UPDATE entity
delete_import_parameter FOR DELETE entity
action_import_parameter FOR ACTION entity~action_name
[REQUEST requested-fields]
[RESULT action_export_parameter]
create_ba_import_parameter FOR CREATE entity\_association.
还可以为每个操作声明 <method> FOR MODIFY。在许多情况下,使用单独的方法实施单个 MODIFY 操作可能会有所帮助。如果相应操作的实施范围更广,则可能尤其如此。
METHODS:
create_entity_method FOR MODIFY
[IMPORTING] create_import_parameter FOR CREATE entity,
update_entity_method FOR MODIFY
[IMPORTING] update_import_parameter FOR UPDATE entity,
delete_entity_method FOR MODIFY
[IMPORTING] delete_import_parameter FOR DELETE entity,
action_method FOR MODIFY
[IMPORTING] action_import_parameter FOR ACTION entity~action_name
RESULT action_export_parameter,
create_by_association FOR MODIFY
[IMPORTING] create_ba_import_parameter FOR CREATE entity\_association.
为了提高可读性,可以在第一个导入参数之前指定关键字 IMPORTING。
参数也可以显式声明为 REFERENCE(...);但是,不允许以 VALUE(...) 形式进行声明,因此无法在方法中更改导入参数。
备注
ABAP 编译器隐式提供参数的数据类型是由行为定义生成的派生类型。根据 CDS 定义,甚至完整行类型,它们通常至少包含实例键值,以及在编号延迟的情况下由模型(操作参数)或业务对象的其他功能(例如
%pid)产生的其他组件。有关更多信息,请参阅派生数据类型。
方法 FOR MODIFY 具有三个隐式更改参数 failed 、 mapped 和 reported 。这些参数可以(但不需要)显式声明(开发人员可能会发现此显式声明有帮助),如下所示:
METHODS method_name FOR MODIFY
[IMPORTING]
create_import_parameter FOR CREATE entity
...
CHANGING failed TYPE DATA
mapped TYPE DATA
reported TYPE DATA.
由于派生类型也在此处起作用,因此无法显式记录它们。ABAP 编译器接受通用类型 DATA 并将其替换为行为定义产生的相应派生类型。
FAILED、MAPPED、REPORTED 中的每一个都是结构类型,行为定义中的每个实体都有一个组件(即业务对象中的每个实体)。组件的名称是在行为定义中定义的别名,否则是原始实体名称。
这些结构的所有参数和组件都是允许批量处理的表。结合在一个方法中捆绑多个操作,可以在单个 FOR MODIFY 方法调用中实施大型修改请求。
实施 <method> FOR MODIFY
何时调用 FOR MODIFY 方法?
业务对象框架处理包含 FOR MODIFY 中定义的至少一个操作的变更请求时,调用 method FOR MODIFY 方法。
FOR MODIFY 方法可以确定具体给定的操作,例如,通过以下方式提供:
... parameter IS [NOT] INITIAL.
示例
IF create_import_parameter IS NOT INITIAL.
... " code for creating entities
ENDIF.
单个工序的处理顺序
BO 框架不指定处理 FOR MODIFY 调用中单个操作的顺序。因此,假设应用程序层按有意义的顺序处理所有传递的单个工序。例如,在更新操作之前处理创建操作通常很有用。

正在从操作处理中检索结果
要使用定义的 RESULT 获取操作调用的输出,必须填充指定的导出参数 action_export_parameter。
对于所有其他操作,没有要填充的显式返回参数。但是,发生相应事件时必须填充三个返回结构 failed、reported 和 mapped。它们的构造会产生一个相当可读的模式,例如,报告失败的实例或存储实例的消息:
APPEND ... TO failed-Item.
APPEND ... TO reported-Root.
所有派生类型还包含不源自实体行类型的组件,并以字符 % 开头,以避免与原始组件发生命名冲突。例如,failed 表的行类型包含一个组件 %fail,用于存储失败实例的症状;另外,一个汇总实体主键字段的包含结构 %key。%key 是几乎所有派生类型(包括操作参数)的一部分。中提供所有派生类型的概览
因此,上述模式如下所示:
APPEND VALUE #( %KEY = <item>-%KEY %FAIL = IF_ABAP_BEHV=>CAUSE-... %CID = ...) TO failed-Item.