使用Socket实现的分布式事件总线,不依赖第三方MQ。
CodeWF.EventBus.Socket
是一个轻量级的、基于Socket的分布式事件总线系统,旨在简化分布式架构中的事件通信。它允许进程之间通过发布/订阅模式进行通信,无需依赖外部消息队列服务。
特性
轻量级:不依赖任何外部MQ服务,减少了系统复杂性和依赖。 高性能:基于Socket的直接通信,提供低延迟、高吞吐量的消息传递。 灵活性:支持自定义事件类型和消息处理器,易于集成到现有系统中。 可扩展性:支持多客户端连接,适用于分布式系统环境。
安装
通过NuGet
包管理器安装CodeWF.EventBus.Socket
:
Install-Package CodeWF.EventBus.Socket
服务端使用
运行事件服务
在服务端代码中,创建并启动EventServer
实例以监听客户端连接和事件。
using CodeWF.EventBus.Socket;
// 创建事件服务器实例
IEventServer eventServer = new EventServer();
// 启动事件服务器,监听指定IP和端口
eventServer.Start("127.0.0.1", 9100);
停止事件服务
当不再需要事件服务时,调用Stop
方法以优雅地关闭服务器。
eventServer.Stop();
客户端使用
连接事件服务
在客户端代码中,创建EventClient
实例并连接到事件服务器。
using CodeWF.EventBus.Socket;
// 创建事件客户端实例
IEventClient eventClient = new EventClient();
// 连接到事件服务器
if (eventClient.Connect("127.0.0.1", 9100, out var message))
{
Console.WriteLine("连接事件服务成功!");
}
else
{
Console.WriteLine($"连接事件服务失败:{message}");
}
订阅事件
订阅特定类型的事件,并指定事件处理函数。
eventClient.Subscribe<NewEmailNotification>("event.email.new", ReceiveNewEmail);
private void ReceiveNewEmail(NewEmailNotification message)
{
// 处理新邮件通知
Console.WriteLine($"收到新邮件,主题是{message.Subject}");
}
发布事件
发布事件到指定的主题,供已订阅的客户端处理。
// 发布新邮件通知事件
eventClient.Publish("event.email.new", new NewEmailNotification { Subject = "恭喜您中Github一等奖", Content = "我们很开心,您在2024年7月...", SendTime = new DateTime(2024, 7, 27) });
取消订阅事件
不再需要接收某类事件时,可以取消订阅。
eventClient.Unsubscribe<NewEmailNotification>("event.email.new", ReceiveNewEmail);
断开事件服务
完成事件处理或需要断开与服务器的连接时,调用Disconnect
方法。
eventClient.Disconnect();
Console.WriteLine("断开与事件服务的连接");
注意事项
确保服务端和客户端使用的地址和端口号一致,并且端口未被其他服务占用。 在生产环境中,服务端应配置为监听公共IP地址或适当的网络接口。 考虑到网络异常和服务重启等情况,客户端可能需要实现重连逻辑。 根据实际需求,可以扩展 EventServer
和EventClient
类以支持更复杂的功能,如消息加密、认证授权等。
项目地址
地址:https://github.com/dotnet9/CodeWF.EventBus.Socket 开源协议:MIT