ASP.NET Core中Startup类、Configure()方法及中间件详解

在 ASP.NET Core 中，Startup 类是应用程序的入口点，它负责配置应用程序的服务和中间件。Configure() 方法是 Startup 类中的一个方法，它用于配置应用程序的 HTTP 请求管道。本文将详细讲解 Startup 类、Configure() 方法及中间件的相关知识。

Startup 类

Startup 类是 ASP.NET Core 应用程序的入口点，它负责配置应用程序的服务和中间件。Startup 类必须包含一个名为 ConfigureServices() 的方法和一个名为 Configure() 的方法。

ConfigureServices() 方法用于配置应用程序的服务，例如数据库连接、身份验证、授权等。以下是一个示例：

public void ConfigureServices(IServiceCollection services)
{
    services.AddDbContext<ApplicationDbContext>(options =>
        options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection")));

    services.AddIdentity<ApplicationUser, IdentityRole>()
        .AddEntityFrameworkStores<ApplicationDbContext>()
        .AddDefaultTokenProviders();

    services.AddMvc();
}

在上面的示例中，我们使用 AddDbContext() 方法配置了数据库连接，使用 AddIdentity() 方法配置了身份验证和授权，使用 AddMvc() 方法配置了 MVC 服务。

Configure() 方法用于配置应用程序的 HTTP 请求管道。以下是一个示例：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }
    else
    {
        app.UseExceptionHandler("/Error");
        app.UseHsts();
    }

    app.UseHttpsRedirection();
    app.UseStaticFiles();

    app.UseRouting();

    app.UseAuthentication();
    app.UseAuthorization();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllerRoute(
            name: "default",
            pattern: "{controller=Home}/{action=Index}/{id?}");
    });
}

在上面的示例中，我们使用 UseDeveloperExceptionPage() 方法配置了开发环境下的异常处理页面，使用 UseExceptionHandler() 方法和 UseHsts() 方法配置了生产环境下的异常处理和 HTTPS 重定向，使用 UseStaticFiles() 方法配置了静态文件服务，使用 UseRouting() 方法配置了路由，使用 UseAuthentication() 方法和 UseAuthorization() 方法配置了身份验证和授权，使用 UseEndpoints() 方法配置了控制器路由。

中间件

中间件是 ASP.NET Core 应用程序的核心组件，它负责处理 HTTP 请求和响应。中间件可以是一个函数、一个类或者一个委托。中间件可以在 Configure() 方法中使用 Use() 方法添加到 HTTP 请求管道中。以下是一个示例：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    app.Use(async (context, next) =>
    {
        // 处理 HTTP 请求
        await next.Invoke();
        // 处理 HTTP 响应
    });
}

在上面的示例中，我们使用 Use() 方法添加了一个中间件，它处理 HTTP 请求和响应。

示例一：使用自定义中间件

以下是一个示例，演示如何使用自定义中间件：

public class MyMiddleware
{
    private readonly RequestDelegate _next;

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

    public async Task InvokeAsync(HttpContext context)
    {
        // 处理 HTTP 请求
        await _next(context);
        // 处理 HTTP 响应
    }
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    app.UseMiddleware<MyMiddleware>();
}

在上面的示例中，我们创建了一个名为 MyMiddleware 的自定义中间件，并在 Configure() 方法中使用 UseMiddleware() 方法添加到 HTTP 请求管道中。

示例二：使用第三方中间件

以下是一个示例，演示如何使用第三方中间件：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    app.UseSwagger();
    app.UseSwaggerUI(c =>
    {
        c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
    });
}

在上面的示例中，我们使用了 Swagger 中间件，它可以自动生成 API 文档和测试页面。我们使用 UseSwagger() 方法和 UseSwaggerUI() 方法配置了 Swagger 中间件。