ASP.NET Core 2.0 中间件初始化参数解析

本文档是关于ASP.NET Core 2.0 中使用带有初始参数的中间件的翻译，探讨了如何将参数传递给自定义中间件并实现动态配置。 在ASP.NET Core框架中，中间件是一种处理请求和响应的核心组件，它们按照一定的顺序执行。ASP.NET Core 2.0引入了一种方便的方式，允许我们在初始化中间件时传递参数，这使得中间件更加灵活和可配置。以下是如何在ASP.NET Core 2.0中实现这一功能的详细步骤： 1. 定义选项类（Option Class） 首先，我们需要创建一个公共类（POCO）来存储中间件所需的参数。例如，我们创建一个名为`GreetingOptions`的类，包含`GreetAt`和`GreetTo`两个属性，用于表示问候的时间和对象： ```csharp public class GreetingOptions { public string GreetAt { get; set; } public string GreetTo { get; set; } } ``` 2. 创建中间件类（Middleware Class） 接下来，我们定义中间件类`GreetingMiddleware`，它接收`RequestDelegate`和`GreetingOptions`作为构造函数参数。在`Invoke`方法中，我们可以使用这些参数来构建问候消息并写入响应： ```csharp public class GreetingMiddleware { private readonly RequestDelegate _next; private readonly GreetingOptions _options; public GreetingMiddleware(RequestDelegate next, GreetingOptions options) { _next = next; _options = options; } public async Task Invoke(HttpContext context) { var message = $"Good {_options.GreetAt} {_options.GreetTo}"; await context.Response.WriteAsync(message); } } ``` 3. 扩展方法配置中间件（Extension Method for Configuring Middleware） 为了方便地在`Configure`方法中使用中间件，我们需要编写一个扩展方法。这里有两个选择： 答案1：使用实例类型 创建一个扩展方法`UseGreetingMiddleware`，接收`IApplicationBuilder`和`GreetingOptions`实例作为参数，然后将`options`传递给中间件的构造函数： ```csharp public static IApplicationBuilder UseGreetingMiddleware(this IApplicationBuilder app, GreetingOptions options) { return app.UseMiddleware<GreetingMiddleware>(options); } ``` 在`Configure`方法中，可以直接使用这个扩展方法来配置中间件： ```csharp public void Configure(IApplicationBuilder app, IHostingEnvironment env) { app.UseGreetingMiddleware(new GreetingOptions { GreetAt = "Morning", GreetTo = "Tahir" }); } ``` 答案2：使用函数类型 另一种方法是提供一个接受`IApplicationBuilder`和`IServiceProvider`的委托，这样可以从依赖注入容器中获取选项： ```csharp public static IApplicationBuilder UseGreetingMiddlewareAction(this IApplicationBuilder app, Func<IServiceProvider, GreetingOptions> optionsFactory) { return app.UseMiddleware<GreetingMiddleware>(optionsFactory(app.ApplicationServices)); } ``` 在`Configure`方法中，你可以从依赖注入容器中解析`GreetingOptions`： ```csharp public void Configure(IApplicationBuilder app, IHostingEnvironment env, IOptions<GreetingOptions> greetingOptions) { app.UseGreetingMiddleware(options => greetingOptions.Value); } ``` 通过这两种方式，我们可以在ASP.NET Core 2.0中为中间件传递初始参数，实现更灵活和可配置的中间件处理逻辑。这种设计使得中间件可以根据不同的应用需求进行定制，而无需硬编码在代码中，提高了代码的可维护性和重用性。