This article describes the release notes of the SDK for Java. To ensure optimal performance and stability, we recommend that you download the latest version of the SDK.

Version 1.1.8

  • Release date

    2016-12-15

    Click aliyun-sdk-mns-1.1.8 to download the SDK.

    Click aliyun-sdk-mns-samples-1.1.8 to download the sample code.

  • New feature

    The BatchSendMessage operation is supported for subscriptions to topics.

  • Installation and running
    1. Download and decompress the aliyun-sdk-mns-samples-1.1.8.zip package.
    2. Import a Maven project into Eclipse and select the aliyun-sdk-mns-samples folder.
    3. In the home directory, create a file named aliyun-mns.properties and specify the endpoint, AccessKey ID, and AccessKey secret in the file.
      Note In Linux, the home directory is /home/YOURNAME/. In Windows, the home directory is C:\Users\YOURNAME.
      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>        
  • Configurations of the pom.xml file
    <dependency>
        <groupId>com.aliyun.mns</groupId>
        <artifactId>aliyun-sdk-mns</artifactId>
        <version>1.1.8.8</version>
        <classifier>jar-with-dependencies</classifier>
    </dependency>  

Version 1.1.7

  • Release date

    2016-08-30

    Click aliyun-sdk-mns-1.1.7 to download the SDK.

    Click aliyun-sdk-mns-samples-1.1.7 to download the sample code.

  • New features
    • Only one Java object is returned after multiple getMNSClient requests.
    • Bugs are fixed.
    • The JSON format is supported for subscriptions to topics.
  • Installation and running
    1. Download and decompress the aliyun-sdk-mns-samples-1.1.7.zip package.
    2. Import a Maven project into Eclipse and select the aliyun-sdk-mns-samples folder.
    3. In the home directory, create a file named .aliyun-mns.properties and specify the endpoint, AccessKey ID, and AccessKey secret in the file.
      Note In Linux, the home directory is /home/YOURNAME/. In Windows, the home directory is C:\Users\YOURNAME.
      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>      

Version 1.1.5

  • Release date

    2016-05-26

    Click aliyun-sdk-mns-1.1.5 to download the SDK.

    Click aliyun-sdk-mns-samples-1.1.5 to download the sample code.

  • New features
    • The TransactionQueue class is supported.
    • The messages can be sent from one client to multiple clients.
    • The sample code that is used for performance testing of the SDK for Java is supported.
  • Installation and running
    1. Download and decompress the aliyun-sdk-mns-samples-1.1.5.zip package.
    2. Import a Maven project into Eclipse and select the aliyun-sdk-mns-samples folder.
    3. In the home directory, create a file named .aliyun-mns.properties and specify the endpoint, AccessKey ID, and AccessKey secret in the file.
      Note In Linux, the home directory is /home/YOURNAME/. In Windows, the home directory is C:\Users\YOURNAME.
      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>          
    4. Run the sample code in the following files: QueueSample.java, TopicSample.java, CloudPullTopicDemo.java, TransactionMessageDemo.java, and TransactionMessageDemo2.java. The CloudPullTopicDemo.java file is used to send messages from one client to multiple clients. The TransactionMessageDemo.java and TransactionMessageDemo2.java files are used to handle transactional messages. When you use the code in the TransactionMessageDemo2.java file, you must specify on-premises transactions and the failover logic.

Version 1.1.4

  • Release date

    2016-04-25

    Click aliyun-sdk-mns-1.1.4 to download the SDK.

    Click aliyun-sdk-mns-samples-1.1.4 to download the sample code.

  • New features
    • MNS queues and mail addresses can be specified as endpoints of subscriptions.
    • Topic messages can be filtered.
    • The timeout error of long polling requests is fixed. This error occurs if the number of long polling requests exceeds the maximum number of connections per route.
  • Installation and running
    1. Download and decompress the aliyun-sdk-mns-samples-1.1.4.zip package.
    2. Import a Maven project into Eclipse and select the aliyun-sdk-mns-samples folder.
    3. In the home directory, create a file named .aliyun-mns.properties and specify the endpoint, AccessKey ID, and AccessKey secret in the file.
      Note In Linux, the home directory is /home/YOURNAME/. In Windows, the home directory is C:\Users\YOURNAME.
      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>           
    4. Run the sample code in the QueueSample.java and TopicSample.java files.

Version 1.1.3

  • Release date

    2016-03-28

    Click aliyun-sdk-mns-1.1.3 to download the SDK.

    Click aliyun-sdk-mns-samples-1.1.3 to download the sample code.

  • New features
    • HTTPS is supported.
    • The default values of the priority, dequeueCount, and delaySeconds parameters of the Message object are removed.
  • Installation and running
    1. Download and decompress the aliyun-sdk-mns-samples-1.1.3.zip package.
    2. Import a Maven project into Eclipse and select the aliyun-sdk-mns-samples folder.
    3. In the home directory, create a file named .aliyun-mns.properties and specify the endpoint, AccessKey ID, and AccessKey secret in the file.
      Note In Linux, the home directory is /home/YOURNAME/. In Windows, the home directory is C:\Users\YOURNAME.
      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>            
    4. Run the sample code in the QueueSample.java and TopicSample.java files.

Version 1.1.2

  • Release date

    2016-01-30

    Click aliyun-sdk-mns-1.1.2 to download the SDK.

    Click aliyun-sdk-mns-samples-1.1.2 to download the sample code.

  • New features

    The following error is fixed: If you call the popMessage operation without specifying the waitseconds parameter, the waitseconds parameter is set to the value of the QueueMeta parameter rather than 0.

  • Installation and running
    1. Download and decompress the aliyun-sdk-mns-samples-1.1.2.zip package.
    2. Import a Maven project into Eclipse and select the aliyun-sdk-mns-samples folder.
    3. In the home directory, create a file named .aliyun-mns.properties and specify the endpoint, AccessKey ID, and AccessKey secret in the file.
      Note In Linux, the home directory is /home/YOURNAME/. In Windows, the home directory is C:\Users\YOURNAME.
      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>
    4. Run the sample code in the QueueSample.java and TopicSample.java files.

Version 1.1.1

  • Release date

    2016-01-19

    Click aliyun-sdk-mns-1.1.1 to download the SDK.

    Click aliyun-sdk-mns-samples-1.1.1 to download the sample code.

  • New features

    The following error is fixed: UTF-8 rather than the default character set is used to encode Chinese messages.

  • Installation and running
    1. Download and decompress the aliyun-sdk-mns-samples-1.1.1.zip package.
    2. Import a Maven project into Eclipse and select the aliyun-sdk-mns-samples folder.
    3. In the home directory, create a file named .aliyun-mns.properties and specify the endpoint, AccessKey ID, and AccessKey secret in the file.
      Note In Linux, the home directory is /home/YOURNAME/. In Windows, the home directory is C:\Users\YOURNAME.
      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>         
    4. Run the sample code in the QueueSample.java and TopicSample.java files.

Version 1.1.0

  • Release date

    2016-01-06

    SDK reference

    Click aliyun-sdk-mns-samples-1.1.0 to download the sample code.

  • New features
    • The topic feature is supported.
    • The Security Token Service (STS) tokens are supported.
    • The Base64 encoding can be disabled.
  • Installation and running
    1. Download the decompress the aliyun-sdk-mns-samples-1.1.0.zip package.
    2. Import a Maven project into Eclipse and select the aliyun-sdk-mns-samples folder.
    3. In the home directory, create a file named .aliyun-mns.properties and specify the endpoint, AccessKey ID, and AccessKey secret in the file.
      Note In Linux, the home directory is /home/YOURNAME/. In Windows, the home directory is C:\Users\YOURNAME.
      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>        
    4. Run the sample code in the QueueSample.java and TopicSample.java files.

Version 1.0.5

  • Release date

    2015-12-02

    Click aliyun-sdk-mns-1.0.5 to download the SDK.

    Click aliyun-sdk-mns-samples-1.0.5 to download the sample code.

  • New features
    • The memory leak is fixed. This error occurred if multiple CloudAccount objects exist.
    • HttpAsyncClient 4.1 is supported.
  • Installation and running
    1. Download and decompress the aliyun-sdk-mns-samples-1.0.5.zip package.
    2. Import a Maven project into Eclipse and select the aliyun-sdk-mns-samples folder.
    3. In the home directory, create a file named .aliyun-mns.properties and specify the endpoint, AccessKey ID, and AccessKey secret in the file.
      Note In Linux, the home directory is /home/YOURNAME/. In Windows, the home directory is C:\Users\YOURNAME.
      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>            
    4. Run the sample code in the Sample.java file.

Version 1.0.4

  • Release date

    2015-11-05

    Click aliyun-sdk-mns-1.0.4 to download the SDK.

    Click aliyun-sdk-mns-samples-1.0.4 to download the sample code.

  • New features
    • The thread hanging is fixed. This error occurred due to network exceptions.
    • Idle connections can be disabled and resident threads can be reclaimed.
  • Installation and running
    1. Download and decompress the aliyun-sdk-mns-samples-1.0.4.zip package.
    2. Import a Maven project into Eclipse and select the aliyun-sdk-mns-samples folder.
    3. In the home directory, create a file named .aliyun-mns.properties and specify the endpoint, AccessKey ID, and AccessKey secret in the file.
      Note In Linux, the home directory is /home/YOURNAME/. In Windows, the home directory is C:\Users\YOURNAME.
      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>            
    4. Run the sample code in the Sample.java file.

Version 1.0.3

  • Release date

    2015-06-09

    SDK reference

    Click aliyun-sdk-mns-samples-1.0.3 to download the sample code.

  • New features
    • The SDK hanging is fixed. This error occurs if you disable a large amount of waiting connections.
    • Sample code is added.
    • The API version "x-mns-version"="2015-06-06" is supported.
    • The BatchSendMessage, BatchReceiveMessage, BatchPeekMessage, and BatchDeleteMessage operations are supported.
  • Installation and running
    1. Download the decompress the aliyun-sdk-mns-samples-1.0.3.zip package.
    2. Import a Maven project into Eclipse and select the aliyun-sdk-mns-samples folder.
    3. In the home directory, create a file named .aliyun-mns.properties and specify the endpoint, AccessKey ID, and AccessKey secret in the file.
      Note In Linux, the home directory is /home/YOURNAME/. In Windows, the home directory is C:\Users\YOURNAME.
      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>            
    4. Run the sample code in the Sample.java file.

Version 1.0.2

  • Release date

    2015-03-03

    Click aliyun-sdk-mns-1.0.2 to download the SDK.

  • New features

    The logic of parsing messages in the XML format is optimized to improve performance.

Version 1.0.1

  • Release date

    2014-12-19

    Click aliyun-sdk-mns-1.0.1 to download the SDK.

  • New features

    A maximum of 50 threads for a thread pool are supported. The performance bottleneck is fixed. This bottleneck occurs due to large-scale concurrent workload.

Version 1.0.0

Release date

2014-08-01

Click aliyun-sdk-mns-1.0.0 to download the SDK.