This topic 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 here to download the SDK.

    Click here to download the sample code.

  • New feature

    The BatchSendMessage operation is supported for subscriptions to topics.

  • Installation and running
    1. Download and decompress aliyun-sdk-mns-samples-1.1.8.zip.
    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>        
  • Specify the pom.xml file
    <dependency>
        <groupId>com.aliyun.mns</groupId>
        <artifactId>aliyun-sdk-mns</artifactId>
        <version>1.1.8</version>
        <classifier>jar-with-dependencies</classifier>
    </dependency>  

Version 1.1.7

  • Release date

    2016-08-30

    Click here to download the SDK.

    Click here to download the sample code.

  • New features
    • Only one MNSClient instance can be retrieved by an Alibaba Cloud account. (If the configurations of clients are the same, the same MNSClient instance is retrieved).
    • Bugs are fixed.
    • The JSON format is supported for subscriptions to topics.
  • Installation and running
    1. Download and decompress aliyun-sdk-mns-samples-1.1.7.zip.
    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 here to download the SDK.

    Click here 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 aliyun-sdk-mns-samples-1.1.5.zip.
    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 here to download the SDK.

    Click here to download the sample code.

  • New features
    • MNS queues and mail addresses can be specified as endpoints of subscriptions.
    • The filtering feature for topic messages is supported.
    • 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 aliyun-sdk-mns-samples-1.1.4.zip.
    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 here to download the SDK.

    Click here to download the sample code.

  • New features
    • The HTTPS protocol 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 aliyun-sdk-mns-samples-1.1.3.zip.
    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 here to download the SDK.

    Click here to download the sample code.

  • New feature

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

  • Installation and running
    1. Download and decompress aliyun-sdk-mns-samples-1.1.2.zip.
    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 here to download the SDK.

    Click here to download the sample code.

  • New feature

    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 aliyun-sdk-mns-samples-1.1.1.zip.
    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

    Click here to download the SDK.

    Click here 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 aliyun-sdk-mns-samples-1.1.0.zip.
    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 here to download the SDK.

    Click here to download the sample code.

  • New features
    • The memory leak is fixed. This error occurs if multiple CloudAccount objects exist.
    • HttpAsyncClient 4.1 is supported.
  • Installation and running
    1. Download and decompress aliyun-sdk-mns-samples-1.0.5.zip.
    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 here to download the SDK.

    Click here to download the sample code.

  • New features
    • The thread hanging is fixed. This error occurs due to network exceptions.
    • Idle connections can be disabled and resident threads can be reclaimed.
  • Installation and running
    1. Download and decompress aliyun-sdk-mns-samples-1.0.4.zip.
    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

    Click here to download the SDK.

    Click here 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 aliyun-sdk-mns-samples-1.0.3.zip.
    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 here to download the SDK.

  • New feature

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

Version 1.0.1

  • Release date

    2014-12-19

    Click here to download the SDK.

  • New feature

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

Version 1.0.0

Release date

2014-08-01

Click here to download the SDK.