如何为 Asp.net core OData api 启用 swagger答案

【问题标题】：How enable swagger for Asp.net core OData api如何为 Asp.net core OData api 启用 swagger
【发布时间】：2019-12-05 18:21:54
【问题描述】：

我有一个 asp.net 核心 odata api。我想为此 api 启用招摇。 asp.net core版本为2.2，本项目依赖如下图：

启动配置如下：

public class Startup
{
    public Startup(IConfiguration configuration)
    {
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }

    // This method gets called by the runtime. Use this method to add services to the container.
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2);
        services.AddDbContext<SeeMiddleContext>(options =>
        {
            options.UseSqlServer(
                "Data Source = 192.168.1.1;Initial Catalog=Seem;persist security info=True;user id=Sas;password=Sas1");
        });
        services.AddOData();

        services.AddSwaggerGen(options =>
        {
            options.DescribeAllEnumsAsStrings();
            options.SwaggerDoc("v1", new Swashbuckle.AspNetCore.Swagger.Info { Title = "eShopOnContainers - Catalog HTTP API", Version = "v1", Description = "The Catalog Microservice HTTP API. This is a DataDriven/CRUD microservice sample", TermsOfService = "Terms Of Service" });
        });
    }

    // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
    public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        else
        {
            // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
            app.UseHsts();
        }

        app.UseHttpsRedirection();
        app.UseMvc(routeBuilder => {

            routeBuilder.EnableDependencyInjection();

            routeBuilder.Expand().Select().OrderBy().Filter().MaxTop(40);
        });
        app.UseSwagger();

        app.UseSwaggerUI(c =>
        {
            c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
        });
    }
}

当我运行 api 并在 url 中输入“/swagger”时，我会遇到下图所示的错误：

【问题讨论】：

标签： c# api asp.net-core swagger odata

【解决方案1】：

对我来说，经过上述所有操作，并在post 中进行了描述，我仍然没有 swagger-ui 页面中的 odata-endpoint。装饰者

[ApiExplorerSettings(IgnoreApi = false)]

我的控制器解决了这个问题

【讨论】：

【解决方案2】：

尝试在您的 ConfigureServices 方法中添加以下代码

 using Microsoft.AspNet.OData.Formatter;
 using Microsoft.Net.Http.Headers;

 public void ConfigureServices(IServiceCollection services)
 {
        // Workaround: https://github.com/OData/WebApi/issues/1177
        services.AddMvcCore(options =>
        {
            foreach (var outputFormatter in options.OutputFormatters.OfType<ODataOutputFormatter>().Where(_ => _.SupportedMediaTypes.Count == 0))
            {
                outputFormatter.SupportedMediaTypes.Add(new MediaTypeHeaderValue("application/prs.odatatestxx-odata"));
            }
            foreach (var inputFormatter in options.InputFormatters.OfType<ODataInputFormatter>().Where(_ => _.SupportedMediaTypes.Count == 0))
            {
                inputFormatter.SupportedMediaTypes.Add(new MediaTypeHeaderValue("application/prs.odatatestxx-odata"));
            }
        });
  }

更多详情可以参考https://stackoverflow.com/a/51599466/10201850

【讨论】：