swagger-codegen - OpenApi Generator 在 YAML 文件规范中引用了一个外部 POJO

Question

我正在使用 OpenApi v3.3.4 (以前称为 Swagger CodeGen )Maven 插件通过 api.yml 生成我的休息 Controller 我在其中描述了我想要公开的所有操作的文件。
在我的用例中，我想公开一个方法 POST: handleNotification(@RequestBody SignatureNotification notification)它的请求正文的类型是通过 /targer 中的另一个 maven-plugin 生成的文件夹。
其实我在定义 SignatureNotification在 Components我的 .yml 文件的一部分:

...
requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SignatureNotification'
...

它由 OpenApi 插件生成，然后我将其映射到 SignatureNotification已经存在并具有相同属性的。
我对这个解决方案不是很满意，所以我想知道是否有办法告诉 OpenApi Generator 使用外部对象作为引用？

Answer 1

如果我正确理解您的需求，您只想告诉生成器不要再次生成您现有的类。
如果以上正确，那么您可以配置插件importMappings像这样:

<plugin>
  <groupId>org.openapitools</groupId>
  <artifactId>openapi-generator-maven-plugin</artifactId>
  <version>${openapi-generator-maven-plugin.version}</version>
  <configuration>
      ... excluded for simplicity
      <importMappings>
          <importMapping>SignatureNotification=path.to.your.SignatureNotification</importMapping>        
      </importMappings>
  </configuration>
</plugin>

使用此配置，openapi 生成器不会从 SignatureNotification 生成类定义，而是使用现有的定义。