This page lists changes to the Simple Message Queue (formerly MNS) Java SDK by version, including new features, bug fixes, and breaking changes. We recommend that you download the latest version of the SDK to ensure high performance and stability.
1.4.0
Released: 2025-08-04
Features
Improved the error message for
BatchSendMessagewhen oversized message bodies are blocked.Added the
messageGroupIdproperty to the message class for FIFO message support.Topic message attributes now support the new versions of email and text message subscription clients.
Breaking changes
Minimum JDK version raised to JDK 8.
Download: GitHub Releases
1.3.1
Released: 2025-05-30
Bug fixes
Fixed a serialization parsing exception that occurred when consuming messages from a dead-letter queue (DLQ) in certain scenarios.
Download: GitHub Releases
1.3.0
Released: 2025-04-07
Features
Added user-defined attributes and system attributes to the message class.
Download: GitHub Releases
1.2.1
Released: 2025-04-02
Features
Changed the default
socketTimeoutvalue to 40 seconds.Deprecated message count-related properties and methods in the
QueueMetaclass. Use CloudMonitor APIs to retrieve these metrics instead.
Bug fixes
Fixed a
jaxb-runtimeincompatibility in the JDK 8 runtime environment.Fixed an issue where some requests timed out in extreme scenarios.
Download: GitHub Releases
1.2.0
Released: 2025-01-02
Dependencies
Upgraded
aliyun-java-sdk-coreto version 4.7.1.
Breaking changes
Receiving or deleting messages from a queue now requires explicit exception handling. Catch and handle exceptions to prevent uncaught exceptions from interrupting loop-based execution (such as a
whileloop).
Download: GitHub Releases
1.1.11
Released: 2024-08-23
Features
Improved the readability of the
[Message]:nullerror message for invalidBatchDeleteMessagerequests.
Download: GitHub Releases
1.1.10
Released: 2024-05-30
Features
AccessKey ID and AccessKey secret can now be loaded from environment variables. For more information, see Configure endpoints and credentials.
Queue-based and topic-based message production and consumption now support optional Base64 encoding and decoding.
Added sample code for the preceding features.
Added sample code for sending and consuming large files.
A RequestId is now returned when sending or publishing a message to simplify troubleshooting.
Bug fixes
Fixed a 500 error caused by the concurrent sample code in the official documentation.
Fixed an issue where retrieving a message from a queue still triggered a long wait even when
waitsecondswas set to 0.Fixed a
getCredentialsinconsistency that caused request failures in extreme scenarios.Fixed incorrect client version reporting that returned an old version or the SDK version of a different product.
Other changes
Sample code moved from the
maindirectory to thetestdirectory.
Download: GitHub Releases
1.1.9.1
Released: 2021-12-24
Dependencies
Replaced the Log4j dependency with SLF4J.
Download: aliyun-sdk-mns-1.1.9.1.jar
1.1.9
Released: 2021-03-18
Features
Added support for the
OpenServiceAPI.
Bug fixes
Fixed the client throwing an
I/O reactor status: STOPPEDexception due to network jitter in certain scenarios.
Download: aliyun-sdk-mns-1.1.9.jar
1.1.8
Released: 2016-12-15
Features
Added a batch text message sending API for topic subscriptions.
Download: aliyun-sdk-mns-1.1.8.8.jar
1.1.7
Released: 2016-08-30
Features
The
getMNSClientmethod now returns the same Java object across multiple calls.Added a JSON format option for topic subscriptions.
Bug fixes
General bug fixes.
Download: aliyun-sdk-mns-1.1.7.1.jar
1.1.5
Released: 2016-05-26
Features
Added one-to-many message broadcasting.
Added sample code for Java SDK performance testing.
Download: aliyun-sdk-mns-1.1.5.jar
1.1.4
Released: 2016-04-25
Features
Queues and email addresses are now supported as subscription endpoints.
Added message filtering for topics.
Bug fixes
Fixed long polling request timeouts caused by the number of requests exceeding
maxConnectionsPerRoute.
Download: aliyun-sdk-mns-1.1.4.jar
1.1.3
Released: 2016-03-28
Features
Added HTTPS support.
Breaking changes
Removed the default initial values of
priority,dequeueCount, anddelaySecondsin the Message object.
Download: aliyun-sdk-mns-1.1.3.jar
1.1.2
Released: 2016-01-30
Bug fixes
Fixed an issue where the
waitsecondsparameter forpopMessageused the value fromQueueMetainstead of 0 when no parameter was passed.
Download: aliyun-sdk-mns-1.1.2.jar
1.1.1
Released: 2016-01-19
Bug fixes
Fixed an issue where Chinese messages were encoded in UTF-8 instead of the platform's default character set.
Download: aliyun-sdk-mns-1.1.1.jar
1.1.0
Released: 2016-01-06
Features
Added topic support for publish/subscribe messaging.
Added Security Token Service (STS) token support.
Base64 encoding for messages is now optional.
Download: aliyun-sdk-mns-1.1.0.jar
1.0.5
Released: 2015-12-02
Bug fixes
Fixed a memory leak that occurred when multiple
CloudAccountobjects existed.
Dependencies
Upgraded
httpasyncclientto version 4.1.
Download: aliyun-sdk-mns-1.0.5.jar
1.0.4
Released: 2015-11-05
Bug fixes
Fixed thread aborts in extreme cases of network abnormalities.
Fixed the resident thread that reclaims idle connections after they are closed.
Download: aliyun-sdk-mns-1.0.4.jar
1.0.3
Released: 2015-06-09
Features
Added support for
BatchSendMessage,BatchReceiveMessage,BatchPeekMessage, andBatchDeleteMessage.Added sample code.
Bug fixes
Fixed SDK hangs caused by too many connections in the CLOSE_WAIT state.
Other changes
Upgraded the API protocol version:
x-mns-version=2015-06-06.
Download: aliyun-sdk-mns-1.0.3.jar
1.0.2
Released: 2015-03-03
Other changes
Optimized XML parsing logic for improved performance.
Download: aliyun-sdk-mqs-1.0.2.jar
1.0.1
Released: 2014-12-19
Other changes
Increased the default thread pool size to 50, resolving a performance bottleneck during high-concurrency synchronization.
Download: aliyun-sdk-mqs-1.0.1.jar