消息
ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › 消息
本主题介绍了与 ABAP RESTful Application Programming Model 相关的基本消息概念。
关于消息
消息提供了一种重要的方法来指导和验证消费者和用户操作,并帮助避免和解决问题。因此,消息对于向消费者或用户传达问题很重要。设计良好的消息有助于识别、诊断和解决问题。因此,务必始终一致地使用消息并优化整体交互。因此,需要采取行动的错误和警告应明确说明并加以描述,以帮助快速有效地解决问题。建议为失败结构中的每个条目提供消息,以提供附加信息。
根据消息是参考业务对象实例的状态还是仅参考当前请求,存在不同类型的消息。状态消息参考业务对象实例,转换消息参考请求。状态消息必须始终绑定到业务对象实例(绑定),而转换消息可以绑定或取消绑定(与业务对象实例无关)。
备注
运行时因错误而终止必须始终根据失败结构中的条目实施,以指示失败原因。作为报告结构一部分的消息,仅提供相应情况的附加信息,但不是运行时终止的可靠指示。对于程序设计,始终建议考虑失败结构中的失败原因。
EML 中的消息
执行修改请求时,将在 failed 结构中返回失败实例的键值。相关失败实例的消息将以 reported 结构返回,其组件在运行时由编译器根据返回值派生。reported 结构的以下组件与消息处理相关:
REPORTED%CID:相关实例的标识%MSG:已填充消息包装器类的实例%ELEMENT:列出与消息相关的实体的所有字段或关联。%STATE_AREA:如果填充类型为String的此组件,则框架会将消息解释为状态消息。%OP:此组件指示与消息相关的已执行操作。此组件仅与转换消息相关。%OTHER:报告的结构包含定义的每个实体的表,此外%OTHER包含与实体无关的所有消息的表。当消息与业务对象实体无关时,使用消息包装器类的实例填充%OTHER组件(未绑定消息)%path(仅与子实体相关):路径组件将子实体映射到其父项。如果存在具有多个子实体的业务对象,则会扩展%PATH组件以将子实体映射到其父实体和业务对象根。
使用 %ELEMENT 组件,可以将消息分配到一个或多个目标字段。这些目标由客户端解释并改善用户体验,因为目标在消息和目标字段之间建立可见链接,如果有许多错误消息,也会启用导航。%STATE_AREA 组件确定是否将消息解释为状态消息。如果将此组件留空,则将消息解释为转换消息。如果填充组件,则将消息解释为状态消息。在为同一实例请求多个操作或操作时,组件 %OP 对于区分消息与哪个操作相关的操作非常重要。
有关 reported 和 failed 结构的更多常规信息,请参阅:
有关消息在 EML 中的行为方式的详细信息,请参阅 EML(实体操作语言)中的消息行为。