apache/rocketmq-clients

README

RocketMQ Clients - Collection of Client Bindings for Apache RocketMQ

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	✅	✅	✅	✅	✅	✅	✅	🚧
Push consumer with FIFO consume accelerator	✅	✅	✅	✅	✅	✅	✅	🚧
Priority Message	✅	✅	✅	✅	✅	✅	✅	🚧

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.

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