.net-core - 如何配置 Swashbuckle 以从文档中省略模板/实体/架构

Question

我正在尝试为 Swashbuckle 构建一个过滤器，以在 API 文档中省略项目的模型/实体/架构，保留 Controller 。采用的技术是 Swashbuckle.AspNetCore v3.0.0/Swagger UI v3.17.1。我已经找到了在 Controller 中省略某个方法的方法，但我想省略文档中的模型。我发现了一个与我类似的问题，包括仅隐藏属性。

遵循过滤器代码

public void Apply(OpenApiSchema schema, SchemaFilterContext context)
{
    if (!(context.ApiModel is ApiObject))
    {
        return;
    }

    var model = context as ApiObject;

    if (schema?.Properties == null || model?.ApiProperties == null)
    {
        return;
    }

    var excludedProperties = model.Type
        .GetProperties()
        .Where(
            t => t.GetCustomAttribute<SwaggerExcludeAttribute>() != null
        );

    var excludedSchemaProperties = model.ApiProperties
        .Where(
            ap => excludedProperties.Any(
                pi => pi.Name == ap.MemberInfo.Name
            )
        );

    foreach (var propertyToExclude in excludedSchemaProperties)
    {
         schema.Properties.Remove(propertyToExclude.ApiName);
    }
}

报价: How to configure Swashbuckle to ignore property on model

有没有人有任何建议只隐藏文档中的模型/实体/模式，而不仅仅是它们的属性？如下图。

Answer 1

套装DefaultModelsExpandDepth在 Swashbuckle/Swagger UI 配置中设置为 -1:

app.UseSwaggerUI(c =>
{
    ...
    c.DefaultModelsExpandDepth(-1);
}