OpenAPI Generator生成SAP Destination服务API代码缺失模型如何解决

可行修复方案 #

方案1：直接使用SAP Cloud SDK官方预置的Destination客户端（最推荐的长期方案） #

SAP Cloud SDK for Java 本身已经内置了 Destination 服务的官方封装客户端，不需要自行通过 OpenAPI 生成代码。你只需要在项目中引入 com.sap.cloud.sdk.cloudplatform:cloudplatform-connectivity 依赖，直接通过 DestinationAccessor、DestinationService 类提供的方法，就可以直接获取子账户、服务实例层级的所有 Destination 配置，适配多响应类型的逻辑官方已经做了兼容，不会出现类缺失报错。

方案2：调整 OpenAPI 生成器配置，开启多态模型生成支持 #

你遇到的 OneOfxxx 类缺失问题，本质是默认生成配置没有开启 oneOf 多态模型的生成开关。你可以在项目的 OpenAPI Generator 插件配置（Maven pom.xml 或 Gradle build.gradle）中添加以下配置项，无需修改原API规范即可生成缺失的多态模型类：

• Maven 配置示例：

<plugin>
  <groupId>org.openapitools</groupId>
  <artifactId>openapi-generator-maven-plugin</artifactId>
  <configuration>
    <!-- 开启oneOf/anyOf模型生成 -->
    <generateOneOfAnyOfClasses>true</generateOneOfAnyOfClasses>
    <openApiNullable>true</openApiNullable>
    <!-- 可选：开启多态接口生成 -->
    <useOneOfInterfaces>true</useOneOfInterfaces>
  </configuration>
</plugin>

• Gradle 配置对应添加同名参数即可。

方案3：配置生成器的类型/导入映射 #

如果调整多态配置后仍有异常，可以在生成器配置中添加自定义的类型映射和导入映射，将代码中引用的 OneOfDestinationNameOnly 映射到已生成的对应实体类，无需修改原API规范，配置可以存入项目版本控制，后续生成复用。

内容的提问来源于stack exchange，提问作者Jerry Zhang