asp.net - 使用 Swashbuckle 自定义生成模型文档

Question

我正在使用 Swashbuckle 为我正在编写的 ASP.NET 核心 API 生成 swagger 文档。在我的 API 中，我使用了很多自定义 Json 转换器，因此我接收和返回的 json 看起来并不完全像 C# 类的定义方式。例如，我可能有一个这样的类:

public class MyModel
{
    private MyClass complicatedField;
}

这将被序列化为

{
    "complicatedField": "String representation of the object"
}

但是，Swashbuckle 将其记录为

{
    "complicatedField": {/*Json object of all the fields MyClass has*/}
}

我如何告诉 Swashbuckle 我的模型是如何序列化和反序列化的？

Answer 1

您可以使用 MapType因为您正在将类型更改为原始类型。否则你会使用 SchemaFilter .

.Net 框架 在启动时的某个地方调用扩展方法，即。程序.cs

httpConfiguration.EnableSwagger(c =>
      {
          c.MapType<MyClass>(() => new Schema { type = "string" }); // add additional schema info here
          // other configs
      });

.Net核心放置在startup.cs中的配置服务方法中

services.AddSwaggerGen(c =>
     {
          c.MapType<MyClass>(() => new Schema { Type = "string" });// add additional schema info here
          // other configs
     });