Version information for the Apache RocketMQ 5.x SDK for Java-ApsaraMQ for RocketMQ(RocketMQ)-阿里云帮助中心

ApsaraMQ for RocketMQ provides two Java SDK options based on the Apache RocketMQ 5.x SDK. Use this guide to select the right SDK and version for sending and receiving messages.

Note

The Apache RocketMQ 5.x SDK for Java requires JDK 1.8 or later.

Choose a protocol

ApsaraMQ for RocketMQ supports two SDK protocols. Select the one that fits your project:

	gRPC protocol (recommended)	Remoting protocol
Artifact	`rocketmq-client-java`	`rocketmq-client`
Best for	New projects	Existing applications already on the Remoting protocol
Performance	Optimal performance and user experience	Uses the open-source Apache RocketMQ SDK
Spring Boot	Supported via `rocketmq-v5-client-spring-boot-starter`	Supported via `rocketmq-spring-boot-starter`

Note

Tip: To identify which protocol an SDK uses, check its artifact ID. rocketmq-client-java uses gRPC; rocketmq-client uses Remoting.
For new applications, use the gRPC v2 protocol SDK for optimal performance and user experience. For details on SDK selection, see SDK reference overview.

Recommended versions

gRPC protocol SDK

These versions support the gRPC v2 protocol and have been tested and verified by Alibaba Cloud engineers.

Direct dependency (Maven)

<dependency>
    <groupId>org.apache.rocketmq</groupId>
    <artifactId>rocketmq-client-java</artifactId>
    <version>5.0.7</version>
</dependency>

Direct dependency (Gradle Kotlin DSL)

implementation("org.apache.rocketmq:rocketmq-client-java:5.0.7")

RocketMQ-Spring dependency

<dependency>
    <groupId>org.apache.rocketmq</groupId>
    <artifactId>rocketmq-v5-client-spring-boot-starter</artifactId>
    <!-- We recommend version 2.3.6 (minimum 2.2.2). Earlier versions have message send/receive bugs. Upgrade as soon as possible. -->
    <version>2.3.6</version>
</dependency>

Remoting protocol SDK

Direct dependency (Maven)

Add both the client and ACL artifacts:

<dependency>
    <groupId>org.apache.rocketmq</groupId>
    <artifactId>rocketmq-client</artifactId>
    <version>5.3.1</version>
</dependency>
<dependency>
    <groupId>org.apache.rocketmq</groupId>
    <artifactId>rocketmq-acl</artifactId>
    <version>5.3.1</version>
</dependency>

Direct dependency (Gradle Kotlin DSL)

implementation("org.apache.rocketmq:rocketmq-client:5.3.1")
implementation("org.apache.rocketmq:rocketmq-acl:5.3.1")

RocketMQ-Spring dependency

<dependency>
    <groupId>org.apache.rocketmq</groupId>
    <artifactId>rocketmq-spring-boot-starter</artifactId>
    <!-- We recommend version 2.3.6 (minimum 2.2.2). Earlier versions have message send/receive bugs. Upgrade as soon as possible. -->
    <version>2.3.6</version>
</dependency>

Historical versions

To view all published versions, see the release pages on Maven Central:

gRPC protocol SDK: rocketmq-client-java releases
Remoting protocol SDK: rocketmq-client releases
RocketMQ Spring SDK: rocketmq-spring releases.