使用 socket 实现的分布式事件总线,支持 cqrs,不依赖第三方 mq
codewf.eventbus.socket 是一个轻量级的、基于 socket 的分布式事件总线系统,旨在简化分布式架构中的事件通信。它允许进程之间通过发布/订阅模式进行通信,无需依赖外部消息队列服务。
command

query

特性
轻量级:不依赖任何外部 mq 服务,减少了系统复杂性和依赖。
高性能:基于 socket 的直接通信,提供低延迟、高吞吐量的消息传递。
灵活性:支持自定义事件类型和消息处理器,易于集成到现有系统中。
可扩展性:支持多客户端连接,适用于分布式系统环境。
通信协议
通过 tcp 协议进行数据交互,协议包结构如下:

安装
通过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();
// 连接到事件服务器,使用eventclient.connectstatus检查连接状态
eventclient.connect("127.0.0.1", 9100));
订阅事件
订阅特定类型的事件,并指定事件处理函数:
eventclient.subscribe<newemailcommand>("event.email.new", receivenewemailcommand);
private void receivenewemail(newemailcommand command)
{
// 处理新邮件通知
console.writeline($"收到新邮件,主题是{message.subject}");
}
发布命令(command)
发布事件到指定的主题,供已订阅的客户端处理:
// 发布新邮件通知事件
eventclient.publish("event.email.new", new newemailcommand { subject = "恭喜您中github一等奖", content = "我们很开心,您在2024年7月...", sendtime = new datetime(2024, 7, 27) });
查询(query)
查询指定主题,需要有接收查询端订阅相同的主题(即生产者),收到请求后,再以相同的主题发布查询结果:
eventclient.subscribe<emailquery>("event.email.query", receiveemailquery);
private void receiveemailquery(emailquery query)
{
// 执行查询请求,准备查询结果
var response = new emailqueryresponse { emails = emailmanager.queryemail(request.subject) };
// 以相同的主题,发布查询结果
if (_eventclient!.publish("event.email.query", response,
out var errormessage))
{
logger.info($"response query result: {response}");
}
else
{
logger.error($"response query failed: {errormessage}");
}
}
其他端可使用相同的主题查询(即消费者):
var response = _eventclient!.query<emailquery, emailqueryresponse>("event.email.query",
new emailquery() { subject = "account" },
out var errormessage);
if (string.isnullorwhitespace(errormessage) && response != null)
{
logger.info($"query event.email.query, result: {response}");
}
else
{
logger.error(
$"query event.email.query failed: [{errormessage}]");
}
取消订阅事件
不再需要接收某类事件时,可以取消订阅:
eventclient.unsubscribe<newemailnotification>("event.email.new", receivenewemail);
断开事件服务
完成事件处理或需要断开与服务器的连接时,调用disconnect方法:
eventclient.disconnect();
console.writeline("断开与事件服务的连接");
注意事项
- 确保服务端和客户端使用的地址和端口号一致,并且端口未被其他服务占用。
- 在生产环境中,服务端应配置为监听公共 ip 地址或适当的网络接口。
- 考虑到网络异常和服务重启等情况,客户端可能需要实现重连逻辑。
- 根据实际需求,可以扩展
eventserver和eventclient类以支持更复杂的功能,如消息加密、认证授权等。
以上就是c#使用socket实现分布式事件总线的示例代码的详细内容,更多关于c# socket分布式事件总线的资料请关注代码网其它相关文章!
发表评论