来自 ASP.Net 核心的 Swagger 设置参数属性

Question

我正在使用 Swagger 为 OpenApi 3.0 进行序列化。 详细地说，我尝试使用以下格式序列化输入查询参数数组

?myArray=1,2,3,4

我在 swagger 文档中知道如何实现这一点。只需设置 parameter.explode=false

parameters:
  - name: myArray
    in: query
    explode: false
    ...

但我不知道如何在我的控制器 ASP.Net Core 3.1 中设置此参数 属性 class 以正确生成我的 swagger 文档。 我尝试了几种方法，比如实现基于 IParameterFilter 的过滤器，但对我来说没有任何效果。

Answer 1

幸运的是我能够解决这个问题，因为我在 Swashbuckle.AspNetCore 中找到了关于 GitHub 的讨论。

实施自定义参数过滤器是正确的方法。

public class QueryArrayParameterFilter : IParameterFilter
{
    public void Apply(OpenApiParameter parameter, ParameterFilterContext context)
    {
        if (!parameter.In.HasValue || parameter.In.Value != ParameterLocation.Query) 
            return;

        if (parameter.Schema?.Type == "array" && parameter.Name.Equals("myArray"))
        {
            var value = null as IOpenApiExtension;                
            parameter.Extensions.TryGetValue("explode", out value);

            if (value == null)
                parameter.Extensions.Add("explode", new OpenApiBoolean(false));
        }
    }
}

过滤器必须应用于 ASP.Net 核心 Startup.cs

中的 swagger gen

services.AddSwaggerGen(c =>
{
    c.ParameterFilter<QueryArrayParameterFilter>();
}