FluentMediator 使用教程

FluentMediator 使用教程

FluentMediator:twisted_rightwards_arrows: FluentMediator is an unobtrusive library that allows developers to build custom pipelines for Commands, Queries and Events.项目地址:https://gitcode.com/gh_mirrors/fl/FluentMediator

1、项目介绍

FluentMediator 是一个非侵入式的库，允许开发者为命令、查询和事件构建自定义管道。它支持 .NET Core，并且通过依赖注入提供无缝集成。FluentMediator 的设计遵循中介者模式，使得消息处理流程清晰且易于扩展。

2、项目快速启动

安装

首先，通过 NuGet 安装 FluentMediator：

dotnet add package FluentMediator

配置

在 Startup.cs 或 Program.cs 中配置 FluentMediator：

public void ConfigureServices(IServiceCollection services)
{
    services.AddFluentMediator(builder =>
    {
        builder.On<PingRequest>().Pipeline()
            .Call<IPingHandler>((handler, request) => handler.MyMethod(request))
            .Call<IPingHandler>((handler, request) => handler.MyLongMethod(request))
            .Return<PingResponse, IPingHandler>((handler, request) => handler.GetResponse(request));
    });
}

使用

定义请求和处理程序：

public class PingRequest
{
    public string Message { get; set; }
}

public interface IPingHandler
{
    void MyMethod(PingRequest request);
    void MyLongMethod(PingRequest request);
    PingResponse GetResponse(PingRequest request);
}

public class PingHandler : IPingHandler
{
    public void MyMethod(PingRequest request)
    {
        Console.WriteLine($"Short handling: {request.Message}");
    }

    public void MyLongMethod(PingRequest request)
    {
        Console.WriteLine($"Long handling: {request.Message}");
    }

    public PingResponse GetResponse(PingRequest request)
    {
        return new PingResponse { Message = $"Response to: {request.Message}" };
    }
}

在控制器中使用：

public class PingController : ControllerBase
{
    private readonly IMediator _mediator;

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

    [HttpPost]
    public IActionResult Ping([FromBody] PingRequest request)
    {
        var response = _mediator.Send<PingResponse>(request);
        return Ok(response);
    }
}

3、应用案例和最佳实践

应用案例

FluentMediator 可以用于构建复杂的事件驱动系统，例如订单处理、消息通知等。通过定义清晰的事件和处理程序，可以有效地解耦业务逻辑。

最佳实践

• 模块化设计：将不同类型的事件和处理程序分组，便于管理和扩展。
• 依赖注入：使用依赖注入管理服务和处理程序的生命周期。
• 异步支持：利用异步方法和可取消的令牌参数，提高系统的响应性和可维护性。

4、典型生态项目

FluentMediator 可以与其他 .NET 生态项目结合使用，例如：

• MediatR：另一个流行的中介者库，可以与 FluentMediator 结合使用，提供更丰富的功能。
• ASP.NET Core：作为 Web 应用的后端框架，与 FluentMediator 无缝集成，提供强大的 Web API 支持。
• Entity Framework Core：用于数据持久化，与 FluentMediator 结合，实现数据操作和业务逻辑的分离。

通过这些生态项目的结合，可以构建出高效、可扩展的 .NET 应用。

FluentMediator:twisted_rightwards_arrows: FluentMediator is an unobtrusive library that allows developers to build custom pipelines for Commands, Queries and Events.项目地址:https://gitcode.com/gh_mirrors/fl/FluentMediator