使Swashbuckle将引用类型属性描述为可为Null，或使NSwag将客户端修饰为默认值，而不是不允许为Null

Question

我有一个看起来像这样的DTO：

public class OrderDto{
  public CustomerDto Customer{get;set;}
  public ProductDto[] Products{get;set;}
}

当Swashuckle在OpenAPI 3规范中描述它时，这两个属性都不会出现在必需列表中，并且客户属性没有标记任何nullable，但产品属性标记为nullable： true。

"OrderDto": {
    "type": "object",
    "properties": {
      "customer": {
        "$ref": "#/components/schemas/CustomerDto"
      },
      "products": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/ProductDto"
        },
        "nullable": true
      }
    },
    "additionalProperties": false
  },

在客户端，如果我没有将客户设置为服务器端的某个内容，则会出现deser错误：

Newtonsoft. Json. JsonSerializationException：'必需属性'客户'期望一个非空值

来自服务器的JSON（顺便提一下，由System.Text.JSON提供服务，而不是Newtonsoft）如下所示：

{"customer":null,"products":[]}

NSwag用完整的存根类修饰客户端类，如下所示：

[System.CodeDom.Compiler.GeneratedCode("NJsonSchema", "10.5.2.0 (Newtonsoft.Json v11.0.0.0)")]
public partial class OrderDto
{    
    [Newtonsoft.Json.JsonProperty("customer", Required = Newtonsoft.Json.Required.DisallowNull, NullValueHandling = Newtonsoft.Json.NullValueHandling.Ignore)]
    public CustomerDto Customer { get; set; }

    [Newtonsoft.Json.JsonProperty("products", Required = Newtonsoft.Json.Required.Default, NullValueHandling = Newtonsoft.Json.NullValueHandling.Ignore)]
    public System.Collections.Generic.ICollection<ProductDto> Products { get; set; }
}

我现在正试图找出我需要改变什么，以及从哪里获得更宽容的行为：

最终，我希望能够不将客户端设置为服务器端的任何内容，将其发送给客户端，无论它是否为null或完全从JSON中丢失：

{
  customer: null,
  products: [ ... ]
}

{
  products: [ ... ]
}

我希望客户端（也是一个C#应用程序）对此进行验证，并给我一个Customer属性为null的对象（默认值）

根据所需的行为，哪个工具的行为正确？

我是否应该改变Swashback如何生成OA3规范（以及它是如何实现的？），或者我应该改变NSwag解释生成规范的方式吗？

Answer 1

我在启动配置中应用了这一点：

services.AddSwaggerGen(c =>
{
    ...
    c.UseAllOfToExtendReferenceSchemas();

这似乎有点生硬，但它使所有内容都可以为null，从而将参考类型的NSwag的“Required”生成从“DisallowFull”更改为“Default”