.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=...)] 似乎就足够了。