业务对象接口
ABAP RESTful 应用程序编程模型 › 学习 › 业务对象 › RAP 业务对象最佳实践 › 业务对象建模 › 业务对象接口
如果要发布业务对象,例如通过稳定性合同在其他软件组件中使用/可扩展性,则需要业务对象接口。如果不需要跨组件访问,则不需要业务对象接口。有关业务对象接口的稳定性合同的详细信息,请参阅什么是 RAP 业务对象接口?。
从技术角度来看,业务对象接口层由具有供方合同 transactional_interface 的 CDS 映射视图和抬头中含关键字 interface 的 Behavior Definition Interface 组成。RAP BO 接口是不含运行时处理器的特定 BDEF 类型,因此没有实施类和行为池,用于指定 RAP 基础业务对象中的元素子集。
接口层在基础 BO 层之上构建,作为基础 BO 的单一访问点:

每个 RAP 基础业务对象可以有多个接口 ([0,*]) 来遵守不同的消费者要求和用例,例如,一个业务对象接口公开草稿功能,另一个接口具有不公开草稿功能的同一 RAP 基础业务对象,并且仅允许访问活动实例。
有关语法的详细信息,请参阅 CDS DDL - DEFINE VIEW ENTITY AS PROJECTION ON,事务接口,有关供方合同的详细信息,请参阅 CDS DDL - PROVIDER CONTRACT transactional_interface(ABAP 关键字文档)。
什么是 RAP 业务对象接口?
RAP Business Object Interface 是一个投影层,从技术上将稳定消耗的需求与基础 RAP 基础 BO 的行为和数据模型分离。接口层从 RAP 基础业务对象(如字段或操作)明确指定元素或行为的子集。该接口确保 RAP BO 使用者的生命周期稳定使用:为确保生命周期稳定性,为特定 API 状态发布开发对象,例如 Use System-Internally (C1)。已发布的开发对象必须遵守特定的稳定性标准、更改和开发限制,以确保生命周期稳定性和升级安全。通过接口层,您可以避免对 RAP 基础业务对象进行不必要的开发限制。因此,为 Use System-Internally (C1) 发布业务对象接口时(例如,对于扩展),由 API 状态产生的限制仅适用于接口层中指定以供使用的元素。仅在 RAP 基础业务对象中包含的其他元素不受影响,可以在不影响通过 RAP BO 接口使用基础业务对象的应用程序的运行时的情况下进行更改。
由于 RAP 业务对象接口仅充当 RAP 基础业务对象的合并消耗视图,因此它没有自己的运行时处理器。因此,所有传入请求都将委托给基础 RAP 基础业务对象及其相应的行为池和实施。
您只能在 RAP 基础业务对象的元素接口层上新定义或重新定义静态功能控制。例如,当同一字段在基础基础业务对象中没有任何静态功能控件时,可以在业务对象接口中将字段定义为 readonly。除静态功能控件外,无法在接口级别引入新行为或更改现有行为。
有关如何实施 RAP BO 接口的示例,请参阅开发 API。
可在使用 RAP 业务对象和事件章节中找到业务对象及其接口的使用可能性的概览。
将 RAP 业务对象接口作为 API 发布
要使 RAP BO 接口可供其他软件组件中的使用者使用,您可以使用发布合同 Use System-Internally (C1) 和 visibilityUse in Cloud Development 发布该接口。
已发布的 SAP 接口下的层无法直接访问或使用,但必须始终通过 RAP 基础业务对象的已发布接口层访问。
业务对象接口和扩展
业务对象接口层是数据模型和行为扩展的基础。通过应用相应业务对象接口的每个行为扩展隐式扩展业务对象接口。
行为扩展和业务对象接口
BDEF 扩展始终基于 Business Object Interface(业务对象接口),通过该接口访问原始 RAP 业务对象的实施。对原始业务对象的 BDEF 扩展在技术上扩展了基本 BDEF,但在运行时通过业务对象接口使用。
有关扩展的详细信息,请参阅扩展。
注释传播
接口映射层用于将业务对象稳定消耗的需求与其基础数据模型和行为分离。关于注释,这意味着基础数据模型中的注释更改不得对接口投影层及更高层中的数据模型产生影响。因此,在接口投影视图的抬头部分中使用注释 @Metadata.ignorePropagatedAnnotations: true 是最佳实践。此注释可防止基础基础数据模型中的注释通过 CDS 视图堆栈进一步传播,因此可能会影响基于 RAP BO 接口构建的投影。应在接口投影视图中明确定义应在上级投影中有效的注释。
来源:SAP Help Portal · 2025 FPS02 (Oct 2026) · 中文为 SAP 官方机器翻译