使用类型和控制映射

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 ).