/// <summary>
/// Calls <see cref="SwaggerDocsConfig.DescribeAllEnumsAsStrings(bool)"/>
/// | Make it compatible with owin branching
/// | Ignores CancellationToken parameter type
/// </summary>
public static SwaggerDocsConfig ApplyDefaultApiConfig(this SwaggerDocsConfig doc, HttpConfiguration webApiConfig)
{
doc.DescribeAllEnumsAsStrings();
doc.RootUrl(req => new Uri(req.RequestUri, req.GetOwinContext().Request.PathBase.Value).ToString());
doc.OperationFilter <OpenApiIgnoreParameterTypeOperationFilter <CancellationToken> >();
AppEnvironment appEnv = (AppEnvironment)webApiConfig.DependencyResolver.GetService(typeof(AppEnvironment));
doc.OperationFilter(() => new DefaultAuthorizationOperationFilter {
AppEnvironment = appEnv
});
doc.OperationFilter <SwaggerDefaultValuesOperationFilter>();
doc.OperationFilter <ExamplesOperationFilter>();
doc.OperationFilter <DescriptionOperationFilter>();
doc.SchemaId(type => $"{type.FullName}, {type.Assembly.GetName().Name}");
doc.OAuth2("oauth2")
.Flow("password")
.TokenUrl($"{appEnv.GetSsoUrl()}/connect/token")
.Scopes(scopes =>
{
if (!appEnv.Security.Scopes.SequenceEqual(new[] { "openid", "profile", "user_info" }))
{
foreach (string scope in appEnv.Security.Scopes)
{
scopes.Add(scope, scope);
}
}
});
return(doc);
}
/// <summary>
/// Calls <see cref="OpenApiExtensions.ApplyDefaultODataConfig(SwaggerDocsConfig, HttpConfiguration)"/>
/// | Ignores ODataQueryOptions parameter type
/// | Uses <see cref="ODataSwaggerProvider"/>
/// </summary>
public static SwaggerDocsConfig ApplyDefaultODataConfig(this SwaggerDocsConfig doc, HttpConfiguration webApiConfig)
{
doc.ApplyDefaultApiConfig(webApiConfig);
doc.OperationFilter <OpenApiIgnoreParameterTypeOperationFilter <ODataQueryOptions> >();
doc.CustomProvider(defaultProvider => new ODataSwaggerProvider(defaultProvider, doc, webApiConfig).Configure(odataConfig =>
{
odataConfig.EnableSwaggerRequestCaching();
odataConfig.IncludeNavigationProperties();
odataConfig.SetAssembliesResolver((System.Web.Http.Dispatcher.IAssembliesResolver)webApiConfig.DependencyResolver.GetService(typeof(System.Web.Http.Dispatcher.IAssembliesResolver)));
}));
doc.SchemaId(type => type.AssemblyQualifiedName);
doc.GroupActionsBy(apiDesc => $"[{((ODataRoute)apiDesc.Route).RoutePrefix}] {apiDesc.ActionDescriptor.ControllerDescriptor.ControllerName}");
return(doc);
}
