关于 RAP 可扩展性
ABAP RESTful 应用程序编程模型 › 扩展 › 关于 RAP 可扩展性
本主题概述了 RAP 可扩展性体系结构、扩展开发部件和所有可用的可扩展性功能。
可扩展性使应用程序使用者可以使用 RAP 扩展调整现有应用程序的业务需求和流程。RAP 中的可扩展性选项旨在实现生命周期稳定性,并分离原始业务对象及其扩展之间的关注点。扩展本身是自包含的,始终是为托管和非托管业务对象管理的 RAP。
缺省情况下,RAP 业务对象不可扩展,需要在原始业务对象提供者部分启用可扩展性以允许专用扩展点的扩展。可以在精细级别控制扩展点,以完全控制可以使用哪种扩展来扩展业务对象的哪些部分。
启用 RAP 业务对象以实现可扩展性后,扩展提供者可以添加不同类型的扩展以增强原始数据模型和行为。扩展提供者只能定义启用原始业务对象的扩展字段和行为。定义未启用原始业务对象的其他行为或字段类型会导致扩展 BDEF 和相应数据模型扩展对象中出现语法错误。
从使用者的角度来看,扩展完全集成到业务对象运行时和设计时中,并充当一个整体,即使扩展是独立的,并且只能专门为扩展元素和操作定义行为。无法为原始业务对象的任何元素重新定义任何行为。
有关体系结构概览,请参阅可扩展性体系结构概览。
原始业务对象和扩展之间的关系
扩展是自包含的,只能参考原始业务对象中的元素和扩展本身中定义的元素。所有派生类型和方法签名都会自动扩展,以在结构和方法签名中包含扩展元素。扩展从原始业务对象继承权限:如果原始 RAP BO 定义 authorization (global, instance),则扩展提供者随后可以在其中实施扩展元素的全局和实例权限,由扩展自动继承此权限。
示例
如果业务对象接口有多个扩展,
projection A可以引用BDEF extension B和BDEF extension C中的元素(如果两者都应用业务对象接口I_interface)。
扩展行为特征和操作的行为类似于在原始业务对象中的行为。例如,因此原始验证或运行时或设计时扩展验证之间没有区别。在这两种情况下,RAP 框架以相同方式管理已定义触发器条件的运行时编排。
有关所有可用可扩展性功能的概览,请参阅可扩展性功能概览。
从使用者的角度来看,扩展被视为相应 RAP 业务对象的实施详细信息。无法区分元素是原始 BO 还是扩展的一部分。业务对象始终作为整体使用,包括应用特定业务对象接口的所有扩展。从原始业务对象的角度来看,扩展充当外部使用者。RAP BO 运行时针对原始业务对象或扩展元素的元素区分 in local mode。
示例
如果
BDEF extension B包含名称为sampleAction (features:instance)的操作,则BDEF extension C无法定义具有相同名称的操作。此外,无法使用附加或不同行为在SampleAction (features:instance)中重新定义BDEF extension C。
有关详细信息,请参阅行为扩展。
可扩展性生命周期稳定性和相关性
RAP 扩展的生命周期稳定性与技术体系结构分离。扩展的稳定性通过在相应的语言版本中将专用开发对象发布为已发布的 API(所谓的发布合同)来实现。根据基础发布合同,相应的开发对象会进行额外的兼容性和一致性检查,以确保相关对象之间的生命周期稳定性。它们还对开发对象施加常规限制,以避免将来发生不兼容的更改。RAP BO 及其扩展的生命周期稳定性主要依赖于以下发布合同进行可扩展性启用和使用:
扩展 (C0):需要可见性为
Use in Cloud DevelopmentExtend的审批合同作为 RAP 堆栈中所有开发对象的可扩展性启用的基础。如果要审批Extend审批合同的数据库表、CDS 视图或行为定义,则必须为可扩展性启用相关开发对象作为前提条件。根据开发对象,必须满足附加技术要求才能定义稳定的扩展点。在内部使用系统 (C1):所有打算使用的开发对象都需要可见性为
Use in Cloud DevelopmentUse System-Internally (C1)的发布合同。只能在实施中访问为Use System-Internally (C1)发布的对象。访问未发布对象会导致语法错误。为此发布合同发布开发对象后,将对进一步更改施加限制和检查。例如,您无法删除扩展中使用的元素,也不能对实施进行添加,这将导致不兼容的更改和可能的升级问题。
发布合同的组合可确保扩展点和扩展在升级和生命周期更改期间保持稳定和一致。
有关详细信息,请参阅:
已发布业务对象的可扩展性
已发布的业务对象可用于构建满足客户特定需求的扩展。如果已发布 SAP RAP 业务对象以供使用和扩展,则业务对象接口始终随审批合同 C1 一起发布,以确保客户扩展的稳定性。因此,基于已发布业务对象接口构建的所有扩展都将继承 C1 发布合同及其对未来更改的相应限制。此外,行为扩展只能引用其实施中属于同一命名空间和/或软件组件的字段和关联。原始业务对象中的字段只能在字段本身未进行修改的上下文中使用,例如作为触发条件的一部分。
有关如何为已发布业务对象构建扩展的详细信息,请参阅 RAP 扩展。有关如何在行为实施中使用已发布业务对象的信息,请参阅使用 RAP 业务对象和事件。
扩展层
可以创建行为定义扩展,扩展在其他行为定义扩展中定义的行为。例如,这使客户能够为合作伙伴已添加到 SAP 业务对象的节点扩展构建行为扩展。扩展分层的其他用例包括:
扩展在行为扩展中定义的行为(确定操作和字段映射信息)
将节点扩展添加到节点扩展
行为定义扩展可以扩展在行为定义扩展中定义的行为,这些扩展位于不同的软件组件中。为原始业务对象定义的 C0 发布合同由其所有行为定义扩展自动继承。
基本过程
扩展行为定义扩展的行为遵循与扩展原始业务对象行为相同的原则:行为定义扩展使用关键字 extend behavior for 寻址其打算扩展的业务对象的实体节点。如果对节点扩展进行行为扩展,则需要提供扩展节点的名称。行为定义扩展中定义的行为扩展方式与原始业务对象中定义的行为相同。现有节点扩展的节点扩展的定义类似于原始业务对象节点的节点扩展。
创建实体节点的行为定义扩展后,会将其内部与原始业务对象中为该节点定义的所有行为合并。因此,尽管扩展分层支持扩展在其他行为定义扩展中定义的行为,但行为定义扩展始终扩展原始行为定义。
扩展分层提供了一种模块化实体节点行为的方法,同时防止所涉及部件之间的相关性。这有助于将行为从扩展移回原始业务对象,例如,移除功能切换时可能需要执行此操作。
来源:SAP Help Portal · 2025 FPS02 (Oct 2026) · 中文为 SAP 官方机器翻译