为什么openapi生成器会创建InlineObject？

Question

我正在使用

https://github.com/OpenAPITools/openapi-generator

为我的应用编程接口创建一个客户端。它基本上工作正常，但是生成器创建了许多InlineObject类型，这些类型封装了包括任何复杂性类型的参数，例如Dictional、IFormFile、Stream

例如

public async Task<ApiResponse<FileUploadResponseAPIModel>> MyApiClientMethod(InlineObject11 inlineObject11 = default(InlineObject11))
    {
    }

其中InlineObject11定义为

public partial class InlineObject11 : IEquatable<InlineObject11>, IValidatableObject
{
    
    [JsonConstructorAttribute]
    protected InlineObject11() { }
    
    public InlineObject11(Stream rebalanceTradeFile = default(Stream))
    {
        // to ensure "rebalanceTradeFile" is required (not null)
        this.RebalanceTradeFile = rebalanceTradeFile ?? throw new ArgumentNullException("rebalanceTradeFile is a required property for InlineObject11 and cannot be null");
    }

    [DataMember(Name = "RebalanceTradeFile", IsRequired = true, EmitDefaultValue = false)]
    public System.IO.Stream RebalanceTradeFile { get; set; }

这有什么意义？为什么生成的客户端不接受流再平衡贸易文件（Stream rebalanceTradeFile），而不是将其包装到一个内联对象（InlineObject）中？我该怎么修？这打破了我使用旧版本生成的客户端的一堆工具。

Answer 1

内联对象是从内联模式创建的，例如。https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator/src/test/resources/3_0/inline_model_resolver.yaml#L15-L24是一个模式，其中有两个属性是为MIME类型为application/json的负载内联定义的。

为了避免OpenAPI生成器为内联模式自动生成模型，可以单独定义模型（示例），并使用$ref：

        application/json:
          schema:
            $ref: '#/components/schemas/Pet'