消息映射
ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › 消息 › 消息映射
在跨业务对象场景中,消息映射可确保外部业务对象报告的消息可以调整为您自己业务对象的消息上下文。
外部实体定义
为了能够将来自外部业务对象的消息映射到您自己的业务对象,您需要在行为定义的抬头中定义预期作为外部实体引发消息的实体。
…
foreign entity myForeignEntityA;
foreign entity myForeignEntityB;
…
define behavior …
这会将定义的外部实体添加到 reported 参数结构的派生类型。
有关外部实体语法的详细信息,请参阅 CDS BDL - 外部实体(ABAP 关键字文档)。
Map_Messages 处理器
map_messages 处理程序是从类 cl_abap_behavior_handler 继承的方法,可以在保护类中重新定义该方法。定义的外部实体引发的消息在此方法的更改参数 中报告。
使用映射消息处理器,将来自外部实体实例的消息分配到您自己业务对象的相应实体实例。然后,从报告结构的相应外部实体表中移除消息。例如,您还可以事先使用处理器根据分配的严重性过滤消息。
如果使用 map_messages 处理器将消息从外部实体分配到自有实体,则提供者需要确保外部实体实例与自有实体实例的消息关系在语义上正确。
备注
如果定义为外部实体的 RAP 业务对象在其各自保护程序类中报告的响应参数中返回 RAP 转换消息,则在 RAP 早期保存阶段调用 map_messages 处理器。请注意,在保存阶段无法映射 RAP 状态消息。
多个 Map_Messages 处理器
map_messages 处理器可以在业务对象的基础和投影层上实施。此外,消息报告中可以涉及来自不同业务对象的多个 map_message 处理器。扩展还可以将 map_messages 处理器添加到业务对象。由多个 map_messages 处理器处理的消息的结果取决于这些处理器执行的特定操作:
如果所有处理程序都删除相应报告的条目或清除其 %MSG 组件,则会删除消息。
如果至少一个处理器保持相应报告的条目不变,则会保留一条消息。空的 map_messages 处理器被视为保留所有消息的指令。
由不同处理器多次替换的消息会产生这些消息之一。未定义保留的消息。
处理程序可以通过清除相应的 %MSG 组件来表示对消息的中立。这样会使消息保持不变,但允许由其他处理器进行更改。如果清除消息,将忽略对同一实例键值(删除、保留或替换)的其他消息执行的操作。