在不同名称空间中使用相同名称的不同类不起作用

Question

我得到了（超过）两个Api POSTendpoint。每一个都需要一个json作为参数。但是当我在两个endpoint参数类中使用相同的类名负载时，Swagger就不起作用了。当我改变其中的一个，例如从有效载荷到有效载荷1时，它就不起作用了。当然，我在包装类中设置了正确的名称空间，以便它找到负载。但我希望每次都使用相同的名称“有效载荷”。如何使用相同的类名负载？在这两种情况下，我都可以保留json名称“payload”，只需为属性设置不同的名称（“payload1”、“payload2”）。它起作用了。但最好也有相同的属性名称,

endpointA

[HTTPPOST()]

namespace myProject.A
{
    public class JsonWrapperA
    {
        [JsonProperty("name", Required = Required.AllowNull)]
        public string Name { get; set; }

        [JsonProperty("payload", Required = Required.AllowNull)]
        public Payload Payload { get; set; }
    }

    public class Payload
    {
        [JsonProperty("value", Required = Required.AllowNull)]
        public double Value { get; set; }
    }
}

公共异步任务PostCompagn([FromBody]jsonWrapperB jsonWrapperB）

namespace myProject.B
{
    public class JsonWrapperB
    {
        [JsonProperty("compagny", Required = Required.AllowNull)]
        public string Compagny { get; set; }

        [JsonProperty("payload", Required = Required.AllowNull)]
        public Payload Payload { get; set; }
    }

    public class Payload
    {
        [JsonProperty("age", Required = Required.AllowNull)]
        public double Age{ get; set; }
    }
}

Answer 1

默认情况下，swagger将尝试为APIendpoint的返回类型或参数类型的对象构建模式ID，并将在文档的“模型”部分显示这些对象。它将根据对象的类名构建这些模式ID。

当您试图使两个或多个类命名相同时,即使它们位于不同的命名空间中,您也会得到冲突的schemaIds错误：

InvalidOperationException：冲突的架构：检测到类型NamespaceOne.MyClass和NamespaceTwo.MyClass的相同架构。有关解决方法，请参阅配置设置-“CustomSchemaids”

//add using statement for Swagger in Startup.cs
using Swashbuckle.AspNetCore.Swagger;

...

public void ConfigureServices(IServiceCollection services)
{
    services.AddSwaggerGen(config =>
    {
        //some swagger configuration code.

        //use fully qualified object names
        config.CustomSchemaIds(x => x.FullName);
    }
}