All Products
Search

This Product

    ApsaraMQ for RocketMQ:Version guide

    Document Center

    ApsaraMQ for RocketMQ:Version guide

    Last Updated:Dec 03, 2025

    This topic describes the versions of the Apache RocketMQ 5.x software development kit (SDK) for Java. You can use this information to select a suitable Java SDK to send and receive messages.

    Note

    The Apache RocketMQ 5.x SDK for Java supports Java Development Kit (JDK) 1.8 or later.

    Recommended versions

    gRPC protocol SDK

    For optimal performance and user experience, use the Apache RocketMQ 5.x SDK that supports the gRPC v2 protocol. The following versions are recommended because they have been tested and verified by Alibaba Cloud engineers:

    • Add a direct dependency.

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

    • Add the RocketMQ-Spring dependency.

      <dependency>
    <groupId>org.apache.rocketmq</groupId>
    <artifactId>rocketmq-v5-client-spring-boot-starter</artifactId>
    <version>2.3.4</version>
</dependency>

    Remoting protocol SDK

    If you want to use the Remoting protocol, you can use the open source Apache RocketMQ SDK to access ApsaraMQ for RocketMQ. The recommended versions are:

    • Add a direct dependency.

      <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>

    • Add the RocketMQ-Spring dependency.

      <dependency>
    <groupId>org.apache.rocketmq</groupId>
    <artifactId>rocketmq-spring-boot-starter</artifactId>
    <version>2.3.4</version>
</dependency>
    Note

    • When you connect a new business system to ApsaraMQ for RocketMQ, we recommend using the gRPC protocol SDK for optimal performance and user experience. For more information about how to select an SDK, see SDK reference overview.

    • You can determine whether an SDK uses the Remoting protocol or the gRPC protocol based on its repository coordinate. If the repository coordinate is rocketmq-client, the SDK uses the Remoting protocol. If the repository coordinate is rocketmq-client-java, the SDK uses the gRPC protocol.

    Historical versions

    gRPC protocol SDK

    For more information about historical versions, see Releases.

    Remoting protocol SDK

    For more information about historical versions, see Releases.