This topic describes the release notes for Message Queue for Apache RocketMQ SDK for Java and provides the release date, download links, and updates of each release. This helps you choose an appropriate version of the SDK for Java to send and consume messages based on your business requirements.

Note We recommend that you update the SDK for Java to the latest version.

ons-client v1.8.8.1.Final

Release date Version Download link Download link (including exactly-once delivery semantics)
2021-08-24 1.8.8.1.Final ons-client-1.8.8.1.Final ons-client-ext-1.8.8.1.Final

Optimized features

  • The issue that occurs during retries for ordered messages is fixed.
  • The issue is fixed where multiple duplicate messages are generated when the client retries to send a message that fails to be consumed in special scenarios.

ons-client v1.8.8.Final

Release date Version Download link Download link (including exactly-once delivery semantics)
2021-04-02 1.8.8.Final ons-client-1.8.8.Final ons-client-ext-1.8.8.Final

Optimized features

  • The heartbeat sending logic is optimized.
  • The issue is fixed where the SDK overuses the memory.
  • The issue is fixed where a message is sent back if the consumption fails.
  • The issue is fixed where the message cache limit for topics does not take effect.

ons-client v1.8.7.4.Final

Release date Version Download link Download link (including exactly-once delivery semantics)
2021-02-08 1.8.7.4.Final ons-client-1.8.7.4.Final ons-client-ext-1.8.7.4.Final

Optimized features

  • The issue is fixed where the consumption of ordered messages is delayed in special scenarios.
    Note If you use the SDK for Java v1.8.7.1.Finalor later to consume ordered messages, we recommend that you update the SDK client to the latest version.
  • The issue is fixed where ports are occupied for liveness detection at the message sender.

ons-client v1.8.7.3.Final

Release date Version Download link Download link (including exactly-once delivery semantics)
2021-01-05 1.8.7.3.Final ons-client-1.8.7.3.Final ons-client-ext-1.8.7.3.Final

New features

Optimized features

  • The issue is fixed where a large number of duplicate messages may be generated if an exception such as a network exception occurs.

ons-client v1.8.7.1.Final

Release date Version Download link Download link (including exactly-once delivery semantics)
2020-07-09 1.8.7.1.Final ons-client-1.8.7.1.Final ons-client-ext-1.8.7.1.Final

New features

  • The Ordered Message 2.0 feature is supported by Enterprise Platinum Edition instances. This feature provides globally ordered messages that are highly available and scalable and partitionally ordered messages that support secondary hash.
  • The use methods of instances that have namespaces and that have no namespaces are unified.

Optimized features

  • The retry logic upon failure and the server circuit breaking mechanism are optimized. This way, service availability can be improved and the impacts caused by service upgrades, Elastic Compute Service (ECS) downtime, and virtual IP address (VIP) jitter on your business can be reduced.

ons-client v1.8.5.Final

Release date Version Download link Download link (including exactly-once delivery semantics)
2020-05-10 1.8.5.Final ons-client-1.8.5.Final ons-client-ext-1.8.5.Final

New features

  • The pull mode is added.
    Notice To use the pull mode, make sure that your Message Queue for Apache RocketMQ instance is an Enterprise Platinum Edition instance.

ons-client v1.8.4.Final

Release date Version Download link Download link (including exactly-once delivery semantics)
2019-09-27 1.8.4.Final ons-client-1.8.4.Final ons-client-ext-1.8.4.Final

New features

  • JDK 1.6 is supported.
  • Asynchronous resending is supported.
  • Synchronous resending is supported in scenarios where brokers are busy.

ons-client v1.8.0.Final

Release date Version Download link Download link (including exactly-once delivery semantics)
2019-02-21 1.8.0.Final ons-client-1.8.0.Final ons-client-ext-1.8.0.Final

Fixed issues

  • The automatic retry logic is fixed. By default, a maximum of three retries are allowed. This logic is applicable to scenarios where a message fails to be synchronously sent from a producer to a topic in an instance.

ons-client v1.7.8.Final

Release date Version Download link
2018-07-06 1.7.8.Final ons-client-1.7.8.Final

New features

  • Security Token Service (STS) tokens can be dynamically renewed.

Fixed issues

  • The default size of a single log file is changed from 1 GB to 64 MB.
  • The issue is fixed where two copies of logs are generated.

Earlier versions

ons-client v1.7.7.Final

Release date Version Download link
2018-04-25 1.7.7.Final ons-client-1.7.7.Final

Fixed issues

  • The issue is fixed where message traces cannot be sent when multiple consumer or producer instances are initialized in one process. Versions 1.7.5 and 1.7.6 have this issue. We recommend that you update your client.

ons-client v1.7.6.Final

Release date Version Download link
2018-04-04 1.7.6.Final ons-client-1.7.6.Final

New features

  • All log frameworks are supported.

Fixed issues

  • Log4j2 is supported.
  • The issue is fixed where the client is abnormally shut down when it fetches name servers.
  • The Fastjson version is updated to 1.2.48.

ons-client v1.7.5.Final

Release date Version Download link
2018-03-23 1.7.5.Final ons-client-1.7.5.Final

Fixed issues

  • The issue is fixed where internal dependencies of Alibaba are introduced.

ons-client v1.7.4.Final

Release date Version Download link
2018-03-02 1.7.4.Final ons-client-1.7.4.Final

New features

  • Access to Message Queue for Apache RocketMQ by using STS tokens is supported.
  • Priorities can be set for Message Queue for Apache RocketMQ brokers to which message trace data is sent. By default, the message trace data is preferentially sent to Message Queue for Apache RocketMQ brokers of the current cluster.

Fixed issues

  • The JDK 1.6 incompatibility issue is fixed.

ons-client v1.7.2.Final

Release date Version Download link
2018-01-25 1.7.2.Final ons-client-1.7.2.Final

New features

  • Encryption in transit is supported in the process of generating a signature by using the AccessKey ID and AccessKey secret in Enterprise Platinum Edition instances. This feature improves data security.
  • SQL attribute filtering is supported for consumers in Enterprise Platinum Edition instances. This ensures more efficient message subscription.
  • The client can be configured to automatically detect name server changes. This facilitates O&M and switchover and ensures the high availability of the client.
  • The exact version of a client that is newly connected is reported to the broker.

ons-client v1.7.1.Final

Release date Version Download link
2017-12-19 1.7.1.Final ons-client-1.7.1.Final

New features

  • A custom callback thread pool can be configured for the operation to asynchronously send messages.
  • The JVM -D parameter Dclient.callback.executor.thread.nums is added to the operation for asynchronously sending messages. This parameter is used to control the number of threads in the public thread pool. For example, you can set this parameter to 10.

Fixed issues

  • The issue is fixed where the cache count is not deducted when a message is sent back upon consumption timeout.
  • The issue of the premature release of asynchronous signals is fixed.

ons-client v1.7.0.Final

Release date Version Download link
2017-10-23 1.7.0.Final ons-client-1.7.0.Final

New features

  • The client message cache policies are adjusted in two dimensions: message count and cache size.

Optimized features

  • The ProducerName parameter of the built-in tracing module is optimized for the client to allow different users to use different values.

Fixed issues

  • The issue is fixed where a client trace thread blocks the client from properly exiting.
  • The issue is fixed where the message trace ShutDownHook is repeatedly created.

ons-client v1.6.1.Final

Release date Version Download link
2017-08-31 1.6.1.Final ons-client-1.6.1.Final

Optimized features

  • Detailed Java documentation is added for all client APIs.
  • The method for obtaining client addresses is optimized to make it independent of the hostname configuration in /etc/hosts.

ons-client v1.6.0.Final

Release date Version Download link
2017-07-31 1.6.0.Final ons-client-1.6.0.Final

New features

  • The client is shaded in source code to ensure correct debugging.
  • Message attributes including BornHost and BornTimestamp are exposed on the client.
  • The BatchConsumer method is added to consume messages in batches.
  • The demo for calling the BatchConsumer method is added to consume ordered messages in batches based on the Spring settings.

Optimized features

  • The shard key is placed in the message structure for partitionally ordered messages.
  • Integer values are added for message attribute settings.

What to do next

Prepare the environment