自定义SwaggerDocument生成

Question

我已经编写了一个ASP.NET应用程序，该应用程序基于脚本动态生成RESTful Web服务。有一个根控制器（/ dataserver），之后的所有内容都取决于脚本。该脚本允许您指定自定义处理程序，例如从数据库获取数据的处理程序。

因此，api的结构不固定。只有一个控制器。我正在使用Swashbuckle.AspNet.Core，当它运行时，它只会为该控制器构建一个庞大的文档。我想做的是拦截swagger文档的生成，以便可以将Web服务的结构添加到文档中。

我花了一些时间看Swashbuckle，但是我无法弄清楚如何插入文档生成以便填充。谁能指出我正确的方向？

Answer 1

类似于我看到的唯一选择是使用IDocumentFilter修改生成的文档。

回购中有一些示例：

• https://github.com/domaindrivendev/Swashbuckle.AspNetCore/blob/b64b8fd6fbc7959849445be676f5e3d4a8e947bf/test/Swashbuckle.AspNetCore.SwaggerGen.Test/Fixtures/Extensions/VendorExtensionsDocumentFilter.cs
• https://github.com/domaindrivendev/Swashbuckle.AspNetCore/blob/e2f30e04f412b821a5a989338a186e422c776cc4/src/Swashbuckle.AspNetCore.Annotations/AnnotationsDocumentFilter.cs
• https://github.com/domaindrivendev/Swashbuckle.AspNetCore/blob/b64b8fd6fbc7959849445be676f5e3d4a8e947bf/src/Swashbuckle.AspNetCore.SwaggerGen/XmlComments/XmlCommentsDocumentFilter.cs

恐怕这些示例对于您要实现的目标来说太简单了...但希望它们能为您提供正确的方向]