This topic describes the release notes for Message Queue for Apache RocketMQ SDK for Java and provides the release date, download link, and updates of each release. You can select a version of the SDK for Java that can best suit your business requirements based on the description of this topic when you use the SDK for Java to send and subscribe to messages.

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

Precautions

Java Development Kit (JDK) 1.8 is applicable to all versions of the SDK for Java. JDK 1.6 is applicable only to ons-client V1.8.4.Final and earlier versions. To prevent JDK compatibility issues when you update the SDK version, we recommend that you use JDK 1.8.

ons-client v1.8.8.3.Final

Release date Version number Download link Download link (including Exactly-once delivery semantics)
2022-01-18 1.8.8.3.Final ons-client-1.8.8.3.Final ons-client-ext-1.8.8.3.Final

Optimized features

  • The following issue is fixed: The message that corresponds to a specific consumer offset is skipped due to broker errors.
  • The following issue is fixed: The unit of the timeout period for message consumption is incorrect.

ons-client v1.8.8.1.Final

Release date Version number 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 following issue is fixed: An error occurs when ordered messages are retried.
  • The following issue is fixed: Multiple duplicate messages are generated when the client retries to send a message that failed to be consumed in specific scenarios.

ons-client v1.8.8.Final

Release date Version number 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 logic for sending heartbeats is optimized.
  • The following issue is fixed: The SDK uses an excessive amount of memory.
  • The following issue is fixed: A message is sent back to the broker if the consumer fails to consume the message.
  • The following issue is fixed: A topic-specific message cache limit does not take effect.

ons-client v1.8.7.4.Final

Release date Version number 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 following issue is fixed: The consumption of ordered messages is delayed in specific scenarios.
    Note If you use the SDK for Java V1.8.7.1.Final or later to consume ordered messages, we recommend that you update the SDK client to the latest version.
  • The following issue is fixed: Ports are occupied for liveness detection on message producers.

ons-client v1.8.7.3.Final

Release date Version number 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

Added features

Optimized features

  • The following issue is fixed: 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 number 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

Added 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 the secondary hash function.
  • The methods for managing instances that have namespaces and instances that do not have namespaces are unified.

Optimized features

  • The retry logic upon failures and the server circuit breaking mechanism are optimized. This can improve service availability and reduce the negative impacts of service upgrades, Elastic Compute Service (ECS) instance downtime, and virtual IP address (VIP) jitters on your business.

ons-client v1.8.5.Final

Release date Version number 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

Added features

  • The pull mode is added.
    Notice Before you 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 number 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

Added features

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

ons-client v1.8.0.Final

Release date Version number 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

  • Issues related to the automatic retry logic are fixed. By default, a maximum of three retries are allowed. This logic is applicable to scenarios in which a producer fails to send a message to a topic in an instance in a synchronous manner.

ons-client v1.7.8.Final

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

Added 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 following issue is fixed: Two copies of logs are generated.

Earlier versions

ons-client v1.7.7.Final

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

Fixed issues

  • The following issue is fixed: Message traces cannot be sent when multiple consumer or producer instances are initialized in the same process. This issue may occur in V1.7.5 and V1.7.6. We recommend that you update your SDK.

ons-client v1.7.6.Final

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

Added features

  • All log frameworks are supported.

Fixed issues

  • Apache Log4j2 is supported.
  • The following issue is fixed: A 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 number Download link
2018-03-23 1.7.5.Final ons-client-1.7.5.Final

Fixed issues

  • The following issue is fixed: Internal dependencies of Alibaba are used.

ons-client v1.7.4.Final

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

Added features

  • Access to Message Queue for Apache RocketMQ by using STS tokens is supported.
  • Priorities can be specified for Message Queue for Apache RocketMQ brokers when you send message trace data. 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 number Download link
2018-01-25 1.7.2.Final ons-client-1.7.2.Final

Added features

  • Encryption in transit is supported for Enterprise Platinum Edition instances in the process of generating a signature by using the AccessKey ID and AccessKey secret. This feature improves data security.
  • SQL attribute filtering is supported for consumers in Enterprise Platinum Edition instances. This makes message subscription more efficient.
  • A client can be configured to automatically detect changes in a name server. This way, you can perform O&M operations and switchovers to ensure that the client is highly available.
  • The exact version of a client is reported to the broker when the client initiates a connection request to the broker.

ons-client v1.7.1.Final

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

Added features

  • A custom callback thread pool can be configured when you call an API operation to send messages in an asynchronous manner.
  • The JVM -D parameter Dclient.callback.executor.thread.nums is added to the request parameters of the API operation that sends messages in an asynchronous manner. This parameter is used to manage the number of threads in the public thread pool. For example, you can set this parameter to 10.

Fixed issues

  • The following issue is fixed: The cache count is not decreased when a message is sent back to the broker due to a consumption timeout.
  • The following issue is fixed: The asynchronous semaphore of a client is released before the scheduled point in time.

ons-client v1.7.0.Final

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

Added features

  • The cache policy for messages on clients is modified based on two dimensions: message count and cache size.

Optimized features

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

Fixed issues

  • The following issue is fixed: A client trace thread prevents the client from exiting as expected.
  • The following issue is fixed: The message trace ShutDownHook is created multiple times.

ons-client v1.6.1.Final

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

Optimized features

  • Java documentation is provided for all client API operations.
  • The method that is used to obtain client addresses is optimized. This allows you to obtain client addresses without the need to modify the hostname configuration in /etc/hosts.

ons-client v1.6.0.Final

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

Added features

  • The client is shaded in the source code to ensure correct debugging.
  • The BornHost and BornTimestamp message attributes can be viewed on the client.
  • The BatchConsumer method is added to consume multiple messages at a time.
  • The demo for calling the BatchConsumer method is added to consume multiple ordered messages at a time based on Spring settings.

Optimized features

  • The shard key is stored in the message structure for partitionally ordered messages.
  • Integer values are supported for message property settings.

What to do next

Prepare the environment