Swagger Swashbuckle多态性不适用于接口类型

xwbd5t1u  于 2023-10-18  发布在  其他
关注(0)|答案(2)|浏览(137)

在下面的代码中,我试图提到替代模式;它们与响应类型共享相同的接口。

Startup.cs

services.AddSwaggerGen(c =>
{
    c.UseOneOfForPolymorphism();
});

app.UseSwagger();
app.UseSwaggerUI(options =>
{
    options.SwaggerEndpoint("/swagger/v1/swagger.json", "v1");
});

型号

public interface IOutput
{
    string Discriminator { get; }
}

public class OutputA : IOutput
{
    public string Discriminator => GetType().Name;

    public string PropA { get; set; }
}

public class OutputB : IOutput
{
    public string Discriminator => GetType().Name;

    public string PropB { get; set; }
}

控制器

[HttpGet]
[ProducesResponseType(typeof(IOutput), StatusCodes.Status200OK)]
public IActionResult Get()
{
    return Ok();
}

我希望OutputAOutputB都被列为返回类型,但只提到了IOutput

或者,如果我将IOutputinterface更改为classabstract class,那么OutputAOutputB将被列为有效的返回类型:

这是否由于RESTFul/API标准而不受支持?
或者说,这能够实现吗?
这是一个.NET Core 2.2项目,使用Swashbuckle.AspNetCore v6.2.3

34gzjxbg

34gzjxbg1#

我遇到了swagger gen没有包含实现接口的类型的模式的问题(适用于抽象基类/记录)。我使用下面的解决方案,因为它比指定单个类型更通用。

builder.Services.AddSwaggerGen(opts => {    
    opts.UseOneOfForPolymorphism();
    //Needed to generate schema from derived types of an interface (base class/record already supported) 
    opts.SelectSubTypesUsing(baseT => {
        return Assembly.GetAssembly(typeof(<SomeTypeInTheLibYouwant>))?.GetTypes()
                        .Where(derivedT => baseT.IsAssignableFrom(derivedT));
    });
});
zysjyyx4

zysjyyx42#

分享我找到的解决方案,以防万一有人可能需要它。
我们的想法是通过SelectSubTypesUsing()显式地通过AddSwaggerGen()添加多态关系:

services.AddSwaggerGen(c =>
{
    c.UseOneOfForPolymorphism();
    c.SelectSubTypesUsing(baseType =>
    {
        if (baseType == typeof(IOutput))
        {
            return new[]
            {
                typeof(OutputA),
                typeof(OutputB)
            };
        }
        return Enumerable.Empty<Type>();
    });
});

相关问题