如何使用带有Swashback、Swagger和NSwag的定制模型活页夹？

Question

我有一个ASP。NET核心Web API，其中包含以下endpoint。

[HttpGet]
[Route("models/{ids}")]
[Produces(typeof(IEnumerable<Model>))]
public IActionResult Get
(
    [ModelBinder(typeof(CsvModelBinder<string>))] IEnumerable<string> ids
)
{
    // Get models

    return Ok(models);
}

此endpoint获取ID的CSV列表（例如/models/a、b、c），并返回相应模型对象的JSON数组<代码>CsvModelBinder

我现在尝试的是使用NSwag生成一个客户端库，但事实证明这是有问题的，因为Swashback生成的Swagger将ids参数描述为IEnumerable

选项A：有没有办法让Swashback将参数描述为字符串，而不是IEnumerable

选项B：有没有办法告诉NSwag这个IEnumerable




Answer 1

可以编写自定义操作过滤器（Swashback）或操作处理器（NSwag），将规范中的给定参数转换为普通字符串。

Answer 2

我想出来了。我需要在S中使用MapType（）创建一个自定义模型tartup.cs

public class Csv<T> : List<T> where T : IConvertible
{
    public Csv<T> Append(string delimitedValues)
    {
        var splitValues = delimitedValues
            .Split(',', StringSplitOptions.RemoveEmptyEntries)
            .Cast<string>();

        var convertedValues = splitValues
            .Select(str => Convert.ChangeType(str, typeof(T)))
            .Cast<T>();

        this.AddRange(convertedValues);

        return this;
    }

    public override string ToString()
    {
        return this.Aggregate("", (a,s) => $"{a},{s}").Trim(',');
    }
}

public void ConfigureServices(IServiceCollection services)
{
    services.AddMvc();

    services.AddSwaggerGen(c =>
    {
        c.IncludeXmlComments(() => new XPathDocument(new FileStream(Path.Combine(PlatformServices.Default.Application.ApplicationBasePath, "MyApi.xml"), FileMode.Open)));
        c.SwaggerDoc("v1", new Info { Title = "My API", Version = "v1"});
        c.MapType<Csv<string>>(() => new Schema { Type = "string", Format = "string" });

    });
}