使用类型和控制映射
ABAP RESTful 应用程序编程模型 › 开发 › 开发单个业务对象功能 › 使用类型和控制映射
每当现有历史代码和数据类型在业务对象的行为池中重用时,您需要在 CDS 字段名称和类型以及相应的历史字段名称和类型之间执行映射。
用例
您可以在应用程序中使用此类映射,这些应用程序一方面包括基于 CDS 实体的非托管或托管业务对象,另一方面还包括通常较旧的历史数据类型(ABAP 字典类型)(和功能)。
这对于非托管实施类型尤为重要,该类型本质上代表现有旧功能的一种包装器。
此外,对于被管理实施类型,可能会出现以下情况:确定或验证的代码已存在,但基于“旧”(历史)数据类型。
访问历史代码时,开发人员通常必须在许多位置使用“与映射对应”以将输入派生类型 (type table for create, type table for action import) 映射到历史类型,反之亦然,以将历史结果映射到输出派生类型 (type table for action result, type table for read result, failed)。
此外,用于表示控制信息的类型在历史代码和当前 ABAP 编程模型中也可能明显不同:
在某些历史场景(尤其是使用 BAPI 的场景)中,除了与实体直接对应的字典类型外,还有另一个包含与该类型相同的字段的场景,但这些场景都具有类型 C(1)(与 BAPI 中的控制结构类似)。此类型与派生类型中的 %CONTROL 结构具有相同的功能,这表示通过操作(更新、读取等)访问的主结构中的字段(更新、读取等)此类类型对通常在 BAPI 中使用,例如 BAPIAD2VD/BAPIAD2VDX。控制数据元素为 BAPIUPDATE,类型为 C(1)。
现在,解决方案是在行为定义中引入集中声明映射,而不是许多单独的相应语句。这提高了应用程序源代码的可维护性。
在行为定义中定义类型和控制映射
映射设置与任何其他结构化 ABAP 字典类型(历史类型)相关的实体。它在非托管或托管实施类型的行为定义中引入,关键字为 mapping for。
语法:行为定义中的映射语句
[implementation] unmanaged|managed [implementation in class ABAP_ClASS [unique]];
define behavior for Entity [alias AliasedName]
...
{
mapping for ...
...
}
变式 1:字段映射
有关相应 的字段映射语法的详细信息,请参阅 CDS BDL - 类型映射(ABAP 关键字文档)
附加项 corresponding 会自动将同名字段映射到彼此。可以通过显式列出的字段对指定不同名称的相应字段。
也可以忽略 corresponding 附加项,通常不建议这样做,因为具有相同名称的字段的自动映射将丢失。
如果不需要重命名字段,则可以使用简写形式:
语法(短格式):
mapping for LegacyType corresponding;
备注
映射可以是部分映射(历史类型包含与 CDS 中的任何字段都不匹配的字段)。
变式 2:字段和控制类型映射
使用以下语法,可以同时为主字段类型 LegacyType 和控制类型 ControlType 进行映射定义:
语法:字段类型和相应控制映射
mapping for LegacyType control ControlType corresponding
{
EntityField1 = LegacyField1;
EntityField2 = LegacyField2;
...
}
如果不需要重命名字段,则可以使用简写形式:
语法(短格式):
mapping for LegacyType control ControlType corresponding;
通常,假设主类型和控件类型中的字段具有相同的名称。
{ … } 中的不同字段映射指定为:
EntityField = LegacyField control ControlField;
备注
对于所有控制类型字段,需要类型
C(1)或X(1)。
在 ABAP 中使用类型映射
在行为定义中定义的映射参考由 ABAP corresponding 运算符的某些特殊变式完成。
语法:输入映射(实体类型到历史类型)
data:
legacy_var type LegacyType,
entity_var type strucure|table for create|update|delete entity.
...
legacy_var = corresponding #( entity_var mapping from entity ).
附加项 from entity 根据行为定义中 entity_var 的映射定义将 LegacyType 字段智能分配到数据对象 legacy_var。
如果 entity_var 的类型是输入派生类型、实体类型本身或实体的表类型,则此映射运行正常。
语法:输出映射(从历史类型到实体类型)
data:
legacy_var type LegacyType,
entity_var type table for read result entity.
...
entity_var = corresponding #( legacy_var mapping to entity ).
附加项 to entity 根据行为定义中 entity_var 的映射定义将 legacy_var 字段智能分配到数据对象 LegacyType。
如果 entity_var 的类型是输出派生类型、实体类型本身或实体的表类型,则此映射运行正常。
在 ABAP 中使用控制类型映射
控制映射旨在支持 %control 字段的实际语义:它们指示哪些字段应由 update 更改或由 read 操作读取。
对于输入派生类型 (type table for create, type table for action import) 和目标结构之间的移动,这意味着仅应移动已设置相应控制字段的字段。
语法:使用控制
target = corresponding #( source using control ).
结构或表 source 必须是也包括 %control 结构的派生类型。
例如,如果 source 具有字段 amount,则 %control-amount 会决定是否将 amount 的值移动到 target 的相应字段 - 仅当相应 control 字段的值为非初始值时。
通过与上述附加 mapping from entity 组合,在行为定义中指定的字段映射也有效:
语法:通过字段映射使用控制
target = corresponding #( source mapping from entity using control ).
相反,还有一个附加项 changing control 允许根据相应字段是否为非初始值的条件从无 %control-source 结构中设置派生类型的 %control 字段。
语法:更改控制
target = corresponding #( source changing control ).