小编点评

## OData 新版本支持新的终结点模式路由 本文介绍了 OData 7.4 新版本支持的新终结点模式路由。 **旧模式：endpoint 模式** 在 OData 7.4 版本之前，需要使用 **endpoint 模式**才能映射 API 路由到 OData 端点。但是，endpoint 模式现在默认使用 **endpoint 模式路由**，无需手动配置。 **新模式：endpoint 模式路由** 新模式允许您使用 `MapODataServiceRoute` 方法在 `endpoints` 中添加 OData 路由。这种方法接收两个参数：`routeBuilder` 和 `routeOptions`。`routeBuilder` 是一个路由构建器，用于创建 OData 路由的配置。`routeOptions` 是一个可选的选项对象，用于设置路由参数等。 **示例** ```csharp app.UseEndpoints(endpoints => { endpoints.MapControllers(); endpoints.Select().Filter().OrderBy().Count().MaxTop(10); endpoints.MapODataRoute("odata", "odata", GetEdmModel); }); ``` **与旧模式相比，新模式的优点是：** * 简化 API 配置 * 提高性能 * 减少 API 版本兼容性问题 **注意** * 新模式仅适用于 OData 7.4 版本。 * 您需要安装 `Microsoft.AspNetCore.OData` 包才能使用新模式。

正文

本文属于 OData 系列文章

Introduction

更新：
由于新版的 OData 已经默认使用了 endpoint 模式（Microsoft.AspNetCore.OData 8.0.0），不再需要额外配置，本文已经过时（asp.net core 3.1）。

最近看 OData 的 devblog，发现他们终于支持了新版的终结点（endpoint ）模式路由了，于是我就迫不及待地试了试。

MVC 模式

现在的 OData 配置还是需要禁用 EnableEndpointRouting，感觉和现在标准 ASP. NET CORE 套路格格不入。

public void ConfigureServices(IServiceCollection services)
{
	services.AddControllers(mvcOptions => 
		mvcOptions.EnableEndpointRouting = false);

	services.AddOData();
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
	if (env.IsDevelopment())
	{
		app.UseDeveloperExceptionPage();
	}

	app.UseHttpsRedirection();
	app.UseRouting();
	app.UseAuthorization();

	app.UseMvc(routeBuilder =>
	{
		routeBuilder.Select().Filter();
		routeBuilder.MapODataServiceRoute("odata", "odata", GetEdmModel());
	});

	//app.UseEndpoints(endpoints =>
	//{
	//    endpoints.MapControllers();
	//});
}

IEdmModel GetEdmModel()
{
	var odataBuilder = new ODataConventionModelBuilder();
	odataBuilder.EntitySet<Student>("Students");

	return odataBuilder.GetEdmModel();
}

总之就是对强迫症非常不友好。

Endpoint 模式

终于，从 7.4 开始支持默认的 ASP. NET CORE Endpoint 模式了，你需要安装 7.4 的 odata 包：

Install-Package Microsoft.AspNetCore.OData -Version 7.4.0-beta

配置代码如下：

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

        public IConfiguration Configuration { get; }

        public void ConfigureServices(IServiceCollection services)
        {
            services.AddControllers();
            services.AddOData();
        }

        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }

            app.UseHttpsRedirection();

            app.UseRouting();

            app.UseAuthorization();

            app.UseEndpoints(endpoints =>
            {
                endpoints.MapControllers();
                endpoints.Select().Filter().OrderBy().Count().MaxTop(10);
                endpoints.MapODataRoute("odata", "odata", GetEdmModel());
            });
        }

        private IEdmModel GetEdmModel()
        {
            var odataBuilder = new ODataConventionModelBuilder();
            odataBuilder.EntitySet<WeatherForecast>("WeatherForecast");

            return odataBuilder.GetEdmModel();
        }
    }

后面就不用在 MVC 模式与 Endpoint 模式之间反复横跳了，治愈了我的强迫症。