Project Icon

watermill

Go语言消息流处理库 支持多种发布订阅模式

Watermill是一个Go语言消息流处理库,用于构建事件驱动应用、实现事件溯源和消息RPC。它支持Kafka、RabbitMQ等多种发布订阅实现,特点是易用、通用、高效和可靠。Watermill提供了丰富的示例和文档,适用于各种消息处理场景,可帮助开发者快速上手和深入学习。

Watermill

CI 状态 Go 参考 Go 报告卡 codecov

Watermill 是一个用于高效处理消息流的 Go 库。它旨在构建事件驱动的应用程序,支持事件溯源、基于消息的 RPC、saga 以及您能想到的其他功能。您可以使用传统的发布/订阅实现,如 Kafka 或 RabbitMQ,也可以根据需要使用 HTTP 或 MySQL binlog。

目标

  • 易于理解。
  • 通用 - 事件驱动架构、消息传递、流处理、CQRS - 根据您的需求使用。
  • 快速(参见基准测试)。
  • 通过中间件、插件和发布/订阅配置实现灵活性
  • 可靠 - 使用经过验证的技术并通过压力测试(参见稳定性)。

入门

选择您最喜欢的方式或按顺序进行:

  1. 遵循入门指南
  2. 查看以下示例。
  3. 阅读完整文档:https://watermill.io/

我们的在线实践培训

示例

背景

构建分布式和可扩展的服务并不像某些人所说的那么简单。编写这样的系统需要大量隐藏的知识。就像您不需要了解整个 TCP 堆栈就可以创建 HTTP REST 服务器一样,您也不应该需要学习所有这些知识就可以开始构建消息驱动的应用程序。

Watermill 的目标是使消息通信变得像使用 HTTP 路由器一样简单。它提供了开始使用事件驱动架构所需的工具,并允许您在使用过程中学习细节。

Watermill 的核心是一个简单的接口:

func(*Message) ([]*Message, error)

您的处理程序接收一条消息,并决定是发布新消息还是返回错误。接下来会发生什么取决于您选择的中间件。

您可以在我们的介绍 Watermill 博客文章中了解更多关于我们的动机。

发布/订阅

所有发布者和订阅者都必须实现一个接口:

type Publisher interface {
	Publish(topic string, messages ...*Message) error
	Close() error
}

type Subscriber interface {
	Subscribe(ctx context.Context, topic string) (<-chan *Message, error)
	Close() error
}

支持的发布/订阅系统:

所有发布/订阅实现的文档可以在文档中找到。

非官方库

找不到你喜欢的发布/订阅或库集成?查看Awesome Watermill

如果你知道其他库或者是其作者,请将其添加到列表中

贡献

请查看我们的贡献指南

稳定性

Watermill v1.0.0 已经发布并可用于生产环境。公共API是稳定的,不会在不改变主版本号的情况下进行更改。

为了确保所有发布/订阅系统都稳定且可安全地用于生产环境,我们创建了一套测试,每个实现在合并到主分支之前都需要通过这些测试。 所有测试还以压力模式执行 - 这意味着我们将所有测试并行运行20次

所有测试都在启用竞态条件检测器的情况下运行(测试中使用-race标志)。

有关调试测试的更多信息,你应该查看测试故障排除指南

基准测试

用于对发布/订阅系统进行基准测试的初始工具可以在watermill-benchmark中找到。

所有基准测试都在单个16 CPU的虚拟机实例上进行,在Docker Compose中运行一个二进制文件和依赖项。

这些数字旨在粗略估计不同发布/订阅系统可以处理消息的速度。 请记住,根据设置和配置的不同,结果可能会有很大差异(既可能低得多,也可能高得多)。

以下是消息大小为16字节时的简短版本。

发布/订阅发布(消息/秒)订阅(消息/秒)
GoChannel331,882118,943
Redis Streams61,64211,213
NATS Jetstream(16个订阅者)49,25533,009
Kafka(单节点)44,090108,285
SQL(MySQL)5,599167
SQL(PostgreSQL,批量大小=1)3,834455
Google Cloud 发布/订阅3,68930,229
AMQP2,70213,192

支持

如果你在文档中没有找到问题的答案,请随时直接询问我们!

请加入Three Dots Labs Discord上的#watermill频道。

我们非常欢迎并感谢每一条反馈。请使用调查问卷提交您的反馈。

为什么叫这个名字?

因为它处理流!

许可证

MIT 许可证

项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手,通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能,支持100+编程语言,与主流编辑器无缝集成,显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台,能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐,Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案,通过智能技术简化视频制作流程。无论是企业宣传还是个人分享,有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持,能够阅读和理解用户上传的文件内容,解析网页信息,并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题,Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术,为商家提供一键生成商品图和营销文案的服务,显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台,让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型,免费访问各种图像生成与AI训练工具,从Stable Diffusion等基础模型开始,轻松实现创新图像生成。体验前沿的AI技术,推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器,它将改变您观看视频的方式!SubCat结合了先进的人工智能技术,为您提供即时视频字幕翻译,无论是本地视频还是网络流媒体,让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台,利用前沿AI技术,为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图,再到文案生成,美间让创意设计更简单、更高效。

Project Cover

AIWritePaper论文写作

AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。

投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号