Map() fork the pipeline is called between EndpointRoutingMiddleware and EndpointMiddleware 是什么意思？

Question

https://source.dot.net/#Microsoft.AspNetCore.Routing/Builder/EndpointRoutingApplicationBuilderExtensions.cs,150

我正在阅读 EndpointRoutingApplicationBuilderExtensions 的源代码，它有以下方法：

private static void VerifyEndpointRoutingMiddlewareIsRegistered(IApplicationBuilder app, out IEndpointRouteBuilder endpointRouteBuilder) {
   if (!app.Properties.TryGetValue(EndpointRouteBuilder, out var obj)) {  // I can understand this part
       var message = "...";
       throw new InvalidOperationException(message);
   }
  
   endpointRouteBuilder = (IEndpointRouteBuilder)obj!;

   // This check handles the case where Map or something else that forks the pipeline is called between the two routing middleware 
   if (endpointRouteBuilder is DefaultEndpointRouteBuilder defaultRouteBuilder && !object.ReferenceEquals(app, defaultRouteBuilder.ApplicationBuilder)) {
      var message = $"The {nameof(EndpointRoutingMiddleware)} and {nameof(EndpointMiddleware)} must be added to the same {nameof(IApplicationBuilder)} instance. " +
          $"To use Endpoint Routing with 'Map(...)', make sure to call '{nameof(IApplicationBuilder)}.{nameof(UseRouting)}' before " +
          $"'{nameof(IApplicationBuilder)}.{nameof(UseEndpoints)}' for each branch of the middleware pipeline.";
      throw new InvalidOperationException(message);
   }
}

我不明白第二部分，是否意味着Map(...)在UseRouting()和UseEndpoints()之前被调用为：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env) {

   app.UseRouting();


   app.Map("/branch", app => {
      await context.Response.WriteAsync("branch detected");
   });


   app.UseEndpoints(endpoints => {
      endpoints.MapGet("routing", async context => {
         await context.Response.WriteAsync("Request Was Routed");
      });
   });


   app.Use(async (context, next) => {
      await context.Response.WriteAsync("Terminal Middleware Reached");
      await next();
   });
}

我看不出上面的代码有什么问题，那么源代码是什么意思，我怎样才能重现该方法显示的错误？

Answer 1

以下示例练习您突出显示的代码：

public void Configure(IApplicationBuilder app)
{
    app.UseRouting();

    app.Map("/branch", branchApp =>
    {
        branchApp.UseEndpoints(endpoints =>
        {
            // ...
        });
    });

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

如错误消息所示，这是为了确保中间件管道的每个分支都有一对匹配的 UseRouting 和 UseEndpoints。在我展示的示例中，缺少对 branchApp.UseRouting() 的调用，因此这会触发错误。

Map() fork the pipeline is called between EndpointRoutingMiddleware and EndpointMiddleware 是什么意思？

what does Map() fork the pipeline is called between the EndpointRoutingMiddleware and EndpointMiddleware mean?

c#

routes

asp.net-core