ASP.NET Core3.X 终端中间件转换为端点路由运行详解

【开篇引子】

在技术的海洋里，每一个新的更新与升级都是对过去知识的挑战和补充。最近，我参与了一个基础通用系统的升级工作，过程中涉及到了ASP.NET Core 3.X终端中间件的转变，特别是在将系统转换为端点路由运行时的一些深入体验。在此，我希望能与大家分享这个过程中的学习与心得，或许能为对这方面感兴趣的朋友们带来一些启示。

【故事启程】

在升级过程中，我面临了一个关于支付模块的问题。在移除旧模块并考虑如何引入新的支付SDK时，我意识到这需要直接将支付SDK引入到系统中，并有一系列与之相关的路由。那么，如何创建响应并指定到特定的地址呢？这引发了我对如何自定义中间件，实现指定功能的需求。我开始思考如何巧妙地将Use、Run和Map结合，以达到我的目标。

【路由的进阶】

路由在ASP.NET Core应用中扮演着至关重要的角色，它负责将请求URI映射到终结点并向这些终结点调度传入的请求。在ASP.NET Core 2.1及更早版本中，路由的实现主要依赖于IRouter接口来处理URL映射到处理程序的工作。随着版本的升级，ASP.NET Core引入了终结点路由作为新的路由机制。这一新机制简化了路由配置并提高了性能。

在早期的版本中，使用Map()方法可以在中间件管道中创建“分支”，针对具有特定前缀的传入路径有条件地执行某些中间件。例如：

【代码示例】

app.Map("/order", app => app.Run(async context => { await context.Response.WriteAsync("Order"); }));

在这种情况下，Run()方法作为一个终端中间件，它直接返回响应而不继续执行管道中的下一个中间件。从这个角度来看，整个Map分支都可以被视为应用程序的“端点”。

【自定义中间件的】

对于狼蚁网站的SEO优化以及长沙网络推广来说，我们可能需要自定义一个中间件来适应特定的需求。这个中间件可能需要在接收到特定请求时直接返回响应，而不继续执行管道中的下一个中间件。这种中间件的设计与实现对于提高系统性能和响应速度具有重要意义。我们可以借鉴终结点路由的思想，将其融入到我们的自定义中间件中，以实现更高效、更灵活的路由处理。

【总结与展望】

通过这次升级过程，我深刻体会到了ASP.NET Core 3.X终端中间件以及端点路由的魅力。它们为开发者提供了更强大、更灵活的路由处理能力，使得我们能够更好地应对复杂的业务需求。这也为我们自定义中间件提供了更多的可能性。在未来的工作中，我将继续深入这些新技术，以期为团队带来更多的价值。希望这篇文章能为对这方面感兴趣的朋友们带来一些启示和帮助。让我们一起在技术的道路上不断前行！在ASP.NET Core中，API端点中间件是一个重要的组成部分，它负责处理特定的HTTP请求并返回相应的响应。让我们深入一下这个中间件及其与端点路由的交互方式。

我们有一个简单的ApiEndpointMiddleware类，它设置HTTP响应的状态码为200，并返回字符串"Order"。这个中间件可以通过在Startup.cs文件中的Configure方法将其添加到中间件管道中。

在ASP.NET Core 2.x版本中，我们可以使用扩展方法将中间件添加到中间件管道中，并指定路由来访问它。例如，当我们访问"/order"或"/order/1"等路由时，都会触发这个自定义中间件的响应。

在ASP.NET Core 3.0及以后的版本中，我们采用了端点路由的方式。这意味着中间件管道中的路由步骤和端点的调用是分开的。实际上，我们有两个主要的中间件：EndpointRoutingMiddleware负责实际的路由，即计算将为指定的请求URL路径调用哪个端点；而EndpointMiddleware则负责调用所有已注册的端点。

在Configure方法中，我们使用UseRouting扩展方法将EndpointRoutingMiddleware添加到管道中，然后使用UseEndpoints扩展方法将EndpointMiddleware添加到管道中。我们可以在UseEndpoints中使用MapControllers方法来注册所有的MVC控制器端点。

要将我们的自定义中间件与端点路由结合使用，我们可以在MapControllers之后调用Map方法，并为我们的自定义中间件指定路径。例如，我们可以为"/order"路径注册我们的ApiEndpointMiddleware。这意味着当我们访问"/order"或"/order/123"等路径时，都会触发这个自定义中间件的响应。

我们还可以使用更复杂的路由模式，如"/order/{action}"，它可以匹配"/order/1"这样的路径，但不匹配"/order/status/1"。这使得路由系统更加强大和灵活。

通过理解ASP.NET Core的中间件管道和端点路由机制，我们可以更好地管理和组织我们的应用程序。我们可以根据需要自定义中间件，并使用端点路由将其与特定的URL路径关联起来。这样，我们可以创建高效、可维护的Web应用程序，为用户提供流畅的体验。在应用程序的构建过程中，我们深入配置了端点，确保安全性和功能性得到兼顾。通过app.UseEndpoints方法，我们对端点进行了细致的管理和配置。其中，特别针对订单API做了定制化的设置。

想象一下，你的应用程序是一个繁忙的交通枢纽，端点就像是通往不同目的地的通道。为了确保这些通道安全且高效，我们实施了CORS策略（AllowAllHosts），这意味着我们允许来自所有主机的请求访问我们的应用程序，同时确保了数据的隐私和安全。这就像是在交通枢纽设置了一套严格的安检流程，确保每一位访客都能得到妥善处理。

紧接着，我们应用了授权策略（AdminOnly）。这就好比在交通枢纽中设置了一个门禁系统，只有拥有管理员权限的人员才能进入特定的区域——在这个案例中，就是我们的订单API区域。这样的设置确保了只有特定的管理员能够执行关键任务，维护系统的安全性和稳定性。

通过endpoints.MapControllers和endpoints.Map方法，我们将这些策略准确地应用到了相应的端点上。例如，当请求到达"/order/{action}"这个端点时，ApiEndpointMiddleware中间件会被触发，执行相应的操作。这个过程就像是一个精细化的工作流程，确保每个请求都能得到正确的响应和处理。

我们对端点的配置和策略的实施，就像是为应用程序的交通枢纽设置了一套完善的安保系统，确保了数据的隐私和安全，同时也保证了应用程序的稳定运行。希望这篇文章能对大家的学习有所帮助，也请大家多多支持我们的狼蚁SEO。在您的应用中启用Cambrian渲染后，您将获得流畅、生动的用户体验。让我们共同这个充满活力和创新的世界！