ASP.NET Core 实用类库

随着 ASP.NET Core 的不断发展，它已经成为构建现代 Web 应用程序的主流框架。为了提高开发效率和代码质量，许多开发者使用各种实用类库来简化常见任务和增强应用程序功能。本文将介绍一些常用的 ASP.NET Core 实用类库，帮助你更高效地开发应用。

1. AutoMapper

AutoMapper 是一个对象-对象映射工具，它可以简化复杂对象之间的映射过程。在 ASP.NET Core 应用程序中，数据传输对象（DTO）和实体对象之间的转换是一个常见需求，而 AutoMapper 可以自动处理这些转换，减少手工编码的重复性。

安装方法：

dotnet add package AutoMapper
dotnet add package AutoMapper.Extensions.Microsoft.DependencyInjection

使用示例：

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        // 注册 AutoMapper 服务
        services.AddAutoMapper(typeof(Startup));
    }
}

// 定义源对象类
public class Source
{
    public int Value { get; set; }
}

// 定义目标对象类
public class Destination
{
    public int Value { get; set; }
}

// 定义映射配置
public class MappingProfile : Profile
{
    public MappingProfile()
    {
        // 配置 Source 到 Destination 的映射
        CreateMap<Source, Destination>();
    }
}

2. Serilog

Serilog 是一个灵活且功能强大的日志记录库。它支持结构化日志记录，使得日志信息更易于分析和查询。Serilog 还提供了多种日志输出（sinks），如文件、控制台、数据库等。

安装方法：

dotnet add package Serilog.AspNetCore
dotnet add package Serilog.Sinks.Console
dotnet add package Serilog.Sinks.File

使用示例：

public class Program
{
    public static void Main(string[] args)
    {
        // 配置 Serilog
        Log.Logger = new LoggerConfiguration()
            .WriteTo.Console() // 输出到控制台
            .WriteTo.File("logs/log-.txt", rollingInterval: RollingInterval.Day) // 输出到文件，每天滚动一次
            .CreateLogger();

        try
        {
            Log.Information("Starting web host"); // 记录信息日志
            CreateHostBuilder(args).Build().Run();
        }
        catch (Exception ex)
        {
            Log.Fatal(ex, "Host terminated unexpectedly"); // 记录致命错误日志
        }
        finally
        {
            Log.CloseAndFlush(); // 关闭并刷新日志
        }
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .UseSerilog() // 使用 Serilog
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.UseStartup<Startup>();
            });
}

3. MediatR

MediatR 是一个实现中介者模式的库，用于处理应用程序中的命令和查询。它通过将请求和处理逻辑分离，促进了代码的模块化和可维护性。在复杂业务逻辑中，MediatR 能显著简化事件驱动开发和依赖注入。

安装方法：

dotnet add package MediatR
dotnet add package MediatR.Extensions.Microsoft.DependencyInjection

使用示例：

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        // 注册 MediatR 服务
        services.AddMediatR(typeof(Startup));
    }
}

// 定义请求类
public class Ping : IRequest<string> { }

// 定义请求处理器
public class PingHandler : IRequestHandler<Ping, string>
{
    public Task<string> Handle(Ping request, CancellationToken cancellationToken)
    {
        // 处理请求并返回响应
        return Task.FromResult("Pong");
    }
}

// 定义控制器
public class MyController : ControllerBase
{
    private readonly IMediator _mediator;

    public MyController(IMediator mediator)
    {
        _mediator = mediator;
    }

    [HttpGet]
    public async Task<IActionResult> Get()
    {
        // 发送请求并获取响应
        var response = await _mediator.Send(new Ping());
        return Ok(response);
    }
}

4. FluentValidation

FluentValidation 是一个用于 .NET 的高级验证库，提供了流畅的接口来定义验证规则。在 ASP.NET Core 应用中，它可以与模型绑定无缝集成，简化数据验证过程。

安装方法：

dotnet add package FluentValidation
dotnet add package FluentValidation.AspNetCore

使用示例：

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        // 添加 FluentValidation 服务
        services.AddControllers().AddFluentValidation();
        // 注册模型验证器
        services.AddTransient<IValidator<MyModel>, MyModelValidator>();
    }
}

// 定义模型类
public class MyModel
{
    public string Name { get; set; }
    public int Age { get; set; }
}

// 定义模型验证器
public class MyModelValidator : AbstractValidator<MyModel>
{
    public MyModelValidator()
    {
        // 配置验证规则
        RuleFor(x => x.Name).NotEmpty().WithMessage("Name is required.");
        RuleFor(x => x.Age).InclusiveBetween(0, 120).WithMessage("Age must be between 0 and 120.");
    }
}

5. Polly

Polly 是一个弹性和瞬态故障处理库，用于处理重试、断路器、超时和回退等场景。在 ASP.NET Core 应用中，Polly 可以帮助你构建健壮的微服务架构，确保在出现瞬态故障时应用能够自动恢复。

安装方法：

dotnet add package Polly
dotnet add package Microsoft.Extensions.Http.Polly

使用示例：

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        // 配置 HttpClient 并添加重试策略
        services.AddHttpClient("MyClient")
            .AddTransientHttpErrorPolicy(policyBuilder =>
                policyBuilder.RetryAsync(3)); // 发生瞬态错误时重试 3 次
    }
}

结论

ASP.NET Core 的生态系统中有许多强大且实用的类库，这些类库可以显著提升开发效率和代码质量。通过合理地选用这些类库，你可以简化常见任务，增强应用的功能，并确保应用在面对复杂需求时保持灵活性和可维护性。