ASP.NET Core 2.2中Endpoint路由的作用是什么

今天就跟大家聊聊有關ASP.NET Core 2.2中Endpoint路由的作用是什么，可能很多人都不太了解，為了讓大家更加了解，小編給大家總結了以下內容，希望大家根據這篇文章可以有所收獲。

Endpoint路由

在ASP.NET Core 2.2中，新增了一種路由，叫做 Endpoint （終結點）路由。本文將以往的路由系統稱為 傳統路由 。

本文通過源碼的方式介紹傳統路由和 Endpoint 路由部分核心功能和實現方法，具體功能上的差異見 官方文檔 。

在升級到ASP.NET Core 2.2后，會自動啟用 Endpoint 路由。如果要恢復以往的實現邏輯，需要加入以下代碼：

services.AddMvc(options => options.EnableEndpointRouting = false)
  .SetCompatibilityVersion(CompatibilityVersion.Version_2_2);

本文分析的源代碼基于ASP.NET Core 2.2.3版本的 源代碼 。

Endpoint作用

Endpoint 路由與傳統路由的區別在于，傳統路由 Url 與 Action 對應關系的處理是在 UseMvc 中做的。我們無法根據 Url 獲取對應的 Action 然后進行處理。

Endpoint 就是將 Url 與 Action 的映射關系從 Mvc 中拆離，作為獨立使用的中間件。

由此帶來的好處是我們可以在其他的中間件中使用 Controller 和 Action 上的一些信息，例如 Attruibute 。

框架也提供了 LinkGenerator 類來直接根據 Endpoint 生成鏈接，不再需要 HttpContext 的信息。

另外也提升了一些RPS(Requests per Second)。

不過目前 Endpoint 依然是在 UseMvc 中調用，更多開放的使用方式會在ASP.NET Core 3.0中實現。

啟用Endpoint路由

源代碼見 Github 。也可以獲取源代碼到本地看。

在 MvcApplicationBuilderExtensions.cs 文件72行的 UseMvc 方法中我們可以看到以下代碼：

var options = app.ApplicationServices.GetRequiredService<IOptions<MvcOptions>>();

if (options.Value.EnableEndpointRouting)
{
  ...
}
else
{
  ...
}

if 之中是 Endpoint 路由的邏輯， else 是傳統路由的邏輯。

而 MvcOptions 的構造方法如下所示， EnableEndpointRouting 是通過 CompatibilitySwitch 來控制默認值的，這就是 CompatibilityVersion.Version_2_2 啟用 Endpoint 路由的原因。

public MvcOptions()
{
  // ...
  _enableEndpointRouting = new CompatibilitySwitch<bool>(nameof(EnableEndpointRouting));
  // ...
}

Endpoint路由實現原理

在 MvcApplicationBuilderExtensions.cs 文件的92-123行的代碼是將所有的 Controller 中的 Action 轉換成 Endpoint 。

在129行的 UseEndpointRouting 中，添加了一個 EndpointRoutingMiddleware 的中間件，這個中間件就是從所有的 Endpoint 中找到當前路由對應的 Endpoint ，然后放到 Feature 集合中。

在132行的 UseEndpoint 中，添加了一個 EndpointMiddleware 中間件，這個中間件是將 EndpointRoutingMiddleware 中找到的 Endpoint 取出，根據其中的 MetaData 信息，找到對應的 Controller 和 Action ，并調用。

在 UseMvc 方法里， UseEndpointRouting 和 UseEndpoint 是連續的兩個中間件，而 UseEndpoint 是請求的結束，這意味著我們自定義的中間件無法取得 Endpoint 信息。

但是通過手動調用 UseEndpoint ，我們還是可以拿到 Endpoint 路由信息的。

使用示例

下面展示一個使用示例。

定義一個 LogAttribute 類，并包含一個 Message 屬性，在 Action 上聲明使用。

定義一個 EndpointTestMiddleware 中間件，輸出 LogAttribute 的 Message 屬性。

手動調用 UseEndpointRouting ，然后調用我們定義的 EndpointTestMiddleware 中間件。

// Startup.cs
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
  app.UseEndpointRouting();

  app.UseMiddleware<EndpointTestMiddleware>();

  app.UseMvc(routes =>
  {
    routes.MapRoute(
      name: "default",
      template: "{controller=Home}/{action=Index}/{id?}");
  });
}
// EndpointTestMiddleware.cs
public class EndpointTestMiddleware
{
  private RequestDelegate _next;

  public EndpointTestMiddleware(RequestDelegate next)
  {
    _next = next;
  }

  public async Task Invoke(HttpContext httpContext)
  {
    var endpoint = httpContext.Features.Get<IEndpointFeature>()?.Endpoint;
    if (endpoint == null)
    {
      await _next(httpContext);
      return;
    }
    var attruibutes = endpoint.Metadata.OfType<LogAttribute>();
    foreach (var attribute in attruibutes)
    {
      Debug.WriteLine("------------------------------------------------------------------------");
      Debug.WriteLine(attribute.Message);
      Debug.WriteLine("------------------------------------------------------------------------");
    }
    await _next(httpContext);
  }
}
// LogAttribute.cs
[AttributeUsage(AttributeTargets.Method, Inherited = false, AllowMultiple = true)]
public sealed class LogAttribute : Attribute
{
  public LogAttribute(string message)
  {
    Message = message;
  }

  public string Message { get; set; }
}
// HomeController.cs
public class HomeController : Controller
{
  [Log("Index")]
  public IActionResult Index()
  {
    return View();
  }

  [Log("Privacy")]
  public IActionResult Privacy()
  {
    return View();
  }
}

看完上述內容，你們對ASP.NET Core 2.2中Endpoint路由的作用是什么有進一步的了解嗎？如果還想了解更多知識或者相關內容，請關注億速云行業資訊頻道，感謝大家的支持。