ShortBus 开源项目教程

1. 项目介绍

ShortBus 是一个面向 .NET 平台的开源项目，提供了一个进程内中介者模式实现，具有低摩擦的 API。它支持多种依赖注入容器，包括 AutoFac、Ninject、Simple Injector、Structure Map、Unity 和 Windsor。ShortBus 通过中介者模式简化了命令和查询的处理，使得业务逻辑的测试更加容易，并且将业务概念作为一等公民。

2. 项目快速启动

首先，您需要安装 .NET SDK。然后，克隆项目仓库并安装依赖项。

git clone https://github.com/mhinze/ShortBus.git
cd ShortBus
dotnet restore

以下是使用 StructureMap 容器的一个快速启动示例：

public class DoSomething : ICommand { }

public class DoesSomething : ICommandHandler<DoSomething> {
    public void Handle(DoSomething command) {
        // 执行某些操作
    }
}

// 初始化 StructureMap 容器
ObjectFactory.Initialize(i => i.Scan(s =>
{
    s.AssemblyContainingType<IMediator>();
    s.TheCallingAssembly();
    s.WithDefaultConventions();
    s.AddAllTypesOf(typeof(IQueryHandler<,>));
    s.AddAllTypesOf(typeof(ICommandHandler<>));
}));

// 发送命令
_mediator.Send(new DoSomething());

public class AskAQuestion : IQuery<Answer> { }

public class Answerer : IQueryHandler<AskAQuestion, Answer> {
    public Answer Handle(AskAQuestion query) {
        return new Answer(); // 返回答案
    }
}

// 请求查询
var answer = _mediator.Request(new AskAQuestion());

确保您已经注册了相应的处理程序和中介者。

3. 应用案例和最佳实践

• 命令和查询分离：将命令和查询处理逻辑分离，可以提高代码的可测试性和可维护性。
• 依赖注入：ShortBus 支持多种依赖注入容器，这有助于实现控制反转，降低组件间的耦合。
• 业务逻辑封装：将业务逻辑封装在命令和查询处理程序中，使得业务概念成为一等公民，便于理解和维护。

4. 典型生态项目

• AutoFac：一个流行的依赖注入容器，与 ShortBus 配合使用，可以简化依赖管理。
• Ninject：另一个依赖注入框架，提供了灵活的绑定和注入策略。
• Simple Injector：一个简单且易用的依赖注入库，特别适合大型项目。

ShortBus 通过提供一个统一的接口，使得在不同依赖注入容器之间切换变得更加容易，从而可以更好地适应各种项目需求。