To ensure optimal performance and stability, we recommend that you download the latest version of the SDK.

Version 1.1.8

  • Release date

    December 15, 2016

    Click to download the SDK

    Click to download the sample code

  • Supported feature

    Supports sending multiple messages at a time to subscriber clients of a topic.

  • SDK installation
    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 (/home/YOURNAME/ on Linux or C:\Users\YOURNAME on Windows), create an .aliyun-mns.properties file and configure the endpoint, AccessKey ID, and AccessKey secret in the file.
      mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=$your_accesskeyid
      mns.accesskeysecret=$your_accesskeysecret        
  • Configure 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

    August 30, 2016

    Click to download the SDK

    Click to download the sample code

  • Supported features
    • You can use a single Alibaba Cloud account to retrieve only one MNSClient instance (If the configurations of clients are the same, the same MNSClient instance is retrieved).
    • Fixed bugs.
    • Supports specifying the JSON message content format in subscriptions to topics.
  • SDK installation
    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 (/home/YOURNAME/ on Linux or C:\Users\YOURNAME on Windows), create an .aliyun-mns.properties file and configure the endpoint, AccessKey ID, and AccessKey secret in the file.
      mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=$your_accesskeyid
      mns.accesskeysecret=$your_accesskeysecret      

Version 1.1.5

  • Release date

    May 26, 2016

    Click to download the SDK

    Click to download the sample code

  • Supported features
    • Adds the TransactionQueue class to handle transactional messages.
    • Supports sending messages from one client to multiple clients.
    • Adds the sample code that can be used to test the performance of the Java SDK.
  • SDK installation
    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 (/home/YOURNAME/ on Linux or C:\Users\YOURNAME on Windows), create an .aliyun-mns.properties file and configure the endpoint, AccessKey ID, and AccessKey secret in the file.
      mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=$your_accesskeyid
      mns.accesskeysecret=$your_accesskeysecret          
    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 need to specify on-premises transactions and the failover logic.

Version 1.1.4

  • Release date

    April 25, 2016

    Click to download the SDK

    Click to download the sample code

  • Supported features
    • Supports specifying queue or email address endpoints in subscriptions.
    • Supports filtering topic messages.
    • Solves the timeout problem that occurs when the number of long polling requests exceeds the maximum number of connections per route.
  • SDK installation
    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 (/home/YOURNAME/ on Linux or C:\Users\YOURNAME on Windows), create an .aliyun-mns.properties file and configure the endpoint, AccessKey ID, and AccessKey secret in the file.
      mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=$your_accesskeyid
      mns.accesskeysecret=$your_accesskeysecret           
    4. Run the sample code in the QueueSample.java and TopicSample.java files.

Version 1.1.3

  • Release date

    March 28, 2016

    Click to download the SDK

    Click to download the sample code

  • Supported features
    • Supports the HTTPS protocol.
    • Removes the default values of the priority, dequeueCount, and delaySeconds parameters of the Message object.
  • SDK installation
    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 (/home/YOURNAME/ on Linux or C:\Users\YOURNAME on Windows), create an .aliyun-mns.properties file and configure the endpoint, AccessKey ID, and AccessKey secret in the file.
      mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=$your_accesskeyid
      mns.accesskeysecret=$your_accesskeysecret            
    4. Run the sample code in the QueueSample.java and TopicSample.java files.

Version 1.1.2

  • Release date

    January 30, 2016

    Click to download the SDK

    Click to download the sample code

  • Supported feature

    Supports setting the default value of the waitseconds parameter to the value of the QueMeta parameter rather than 0 when you call the popMessage operation without specifying parameters.

  • SDK installation
    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 (/home/YOURNAME/ on Linux or C:\Users\YOURNAME on Windows), create an .aliyun-mns.properties file and configure the endpoint, AccessKey ID, and AccessKey secret in the file.
      mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=$your_accesskeyid
      mns.accesskeysecret=$your_accesskeysecret
    4. Run the sample code in the QueueSample.java and TopicSample.java files.

Version 1.1.1

  • Release date

    January 19, 2016

    Click to download the SDK

    Click to download the sample code

  • Supported feature

    Supports using UTF-8 instead of the default character set to encode Chinese messages.

  • SDK installation
    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 (/home/YOURNAME/ on Linux or C:\Users\YOURNAME on Windows), create an .aliyun-mns.properties file and configure the endpoint, AccessKey ID, and AccessKey secret in the file.
      mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=$your_accesskeyid
      mns.accesskeysecret=$your_accesskeysecret         
    4. Run the sample code in the QueueSample.java and TopicSample.java files.

Version 1.1.0

  • Release date

    January 26, 2016

    Click to download the SDK

    Click to download the sample code

  • Supported features
    • Supports the topic feature.
    • Supports Security Token Service (STS) tokens.
    • Supports specifying Base64 encoding based on your needs.
  • SDK installation
    1. Download and 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 (/home/YOURNAME/ on Linux or C:\Users\YOURNAME on Windows), create an .aliyun-mns.properties file and configure the endpoint, AccessKey ID, and AccessKey secret in the file.
      mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=$your_accesskeyid
      mns.accesskeysecret=$your_accesskeysecret        
    4. Run the sample code in the QueueSample.java and TopicSample.java files.

Version 1.0.5

  • Release date

    December 02, 2015

    Click to download the SDK

    Click to download the sample code

  • Supported features
    • Solves the problem of memory leaks that occur when multiple CloudAccount objects exist.
    • Supports HttpAsyncClient 4.1 for configuring dependencies.
  • SDK installation
    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 (/home/YOURNAME/ on Linux or C:\Users\YOURNAME on Windows), create an .aliyun-mns.properties file and configure the endpoint, AccessKey ID, and AccessKey secret in the file.
      mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=$your_accesskeyid
      mns.accesskeysecret=$your_accesskeysecret            
    4. Run the sample code in the Sample.java file.

Version 1.0.4

  • Release date

    November 05, 2015

    Click to download the SDK

    Click to download the sample code

  • Supported features
    • Solves the problem of thread hanging that occurs due to network exceptions.
    • Supports disabling idle connections and reclaiming resident threads.
  • SDK installation
    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 (/home/YOURNAME/ on Linux or C:\Users\YOURNAME on Windows), create an .aliyun-mns.properties file and configure the endpoint, AccessKey ID, and AccessKey secret in the file.
      mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=$your_accesskeyid
      mns.accesskeysecret=$your_accesskeysecret            
    4. Run the sample code in the Sample.java file.

Version 1.0.3

  • Release date

    June 09, 2015

    Click to download the SDK

    Click to download the sample code

  • Supported features
    • Solves the problem of SDK holding that occurs when you disable a large amount of waiting connections.
    • Adds the sample code.
    • Supports the latest API version: "x-mns-version"="2015-06-06".
    • Supports the BatchSendMessage, BatchReceiveMessage, BatchPeekMessage, and BatchDeleteMessage operations.
  • SDK installation
    1. Download and 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 (/home/YOURNAME/ on Linux or C:\Users\YOURNAME on Windows), create an .aliyun-mns.properties file and configure the endpoint, AccessKey ID, and AccessKey secret in the file.
      mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=$your_accesskeyid
      mns.accesskeysecret=$your_accesskeysecret            
    4. Run the sample code in the Sample.java file.

Version 1.0.2

  • Release date

    March 03, 2015

    Click to download the SDK

  • Supported feature

    Optimizes the logic of parsing messages of the XML format to improve the performance.

Version 1.0.1

  • Release date

    December 19, 2014

    Click to download the SDK

  • Supported feature

    Supports a maximum of 50 threads for a thread pool and solves the SDK-side performance problem that occurs due to highly concurrent workloads.

Version 1.0.0

Release date

2014-08-01

Click to download the SDK