.NET 6 中的 OpenAPI 请求和响应示例

Question

有没有人成功地让复杂的 Swagger 请求和响应示例通过 .NET 6 中的 Swagger UI 呈现？

我在 .NET 6 RC 1 上尝试使用 Swashbuckle.AspNetCore 6.2.1 和 Swashbuckle.AspNetCore.Filters 7.0.2。 instructions 说“不要忘记启用 ExamplesOperationFilter”，但我什至找不到 ExamplesOperationFilter 的定义。它在哪里？

我已经看到了 XML <example> 标记的东西，但这对我的需要来说太简单了 - 我有嵌套的数组、列表和枚举以及我想要显示的各种东西。

Answer 1

好的，我开始了。不需要ExamplesOperationFilter。

在我需要的 Program.cs 中：

builder.Services.AddSwaggerExamplesFromAssemblyOf<MySampleRequest>();

在控制器中，我需要[SwaggerRequestExample(...)] 来处理请求。对于响应，[SwaggerResponse(Type=...)] 似乎就足够了。