Awesome
RocketMQ Clients - Collection of Client Bindings for Apache RocketMQ
English | 简体中文 | RocketMQ Website
Overview
Client bindings for Apache RocketMQ, as known as RocketMQ 5.x SDK. All of them follow the specification of rocketmq-apis, replacing 4.x remoting-based counterparts. Clients in this repository are built on top of Protocol Buffers and gRPC.
Goal
Provide cloud-native and robust solutions for Java, C++, C#, Golang, Rust and all other mainstream programming languages.
Features and Status
- Ready - ✅
- Work in progress - 🚧
| Feature | Java | C/C++ | C# | Golang | Rust | Python | Node.js | PHP |
|---|---|---|---|---|---|---|---|---|
| Producer with standard messages | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 🚧 |
| Producer with FIFO messages | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 🚧 |
| Producer with timed/delay messages | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 🚧 |
| Producer with transactional messages | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 🚧 |
| Producer with recalling timed/delay messages | ✅ | 🚧 | 🚧 | 🚧 | 🚧 | 🚧 | 🚧 | 🚧 |
| Simple consumer | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 🚧 |
| Push consumer with concurrent message listener | ✅ | ✅ | 🚧 | 🚧 | ✅ | 🚧 | 🚧 | 🚧 |
| Push consumer with FIFO message listener | ✅ | ✅ | 🚧 | 🚧 | ✅ | 🚧 | 🚧 | 🚧 |
Prerequisite and Build
This project is organized as a monorepo, with each language's bindings containing specific instructions in their respective subdirectories for building the project. As the rocketmq-apis submodule is incorporated into the project and could be utilized by some bindings, we highly advise cloning the repository by executing the command below:
git clone --recursive git@github.com:apache/rocketmq-clients.git
Contributing
Similar to other projects of Apache RocketMQ, any attempt to make this project better is welcome, including but not limited to filing a bug report, correcting type error or document writing to complete feature implementation. Do not hesitate to make a pull request if this project catches your attention.
Related
- rocketmq: The implementation of server-side.
- rocketmq-apis: Common communication protocol between server and client.
- RIP-37: New and Unified APIs: RocketMQ proposal of new and unified APIs crossing different languages.
- RIP-39: Support gRPC protocol: RocketMQ proposal of gRPC protocol support.
License
Apache License, Version 2.0 Copyright (C) Apache Software Foundation