Download instruction

Last Updated: Sep 11, 2017

MNS Java SDK

It is recommended to download the latest SDK to obtain the best performance and stability.

Version 1.1.8

Update Date

2016-12-15 Download SDK, Download Sample.

Updates

  • Add SMS(short message service)subscription for Topic.

Help

  1. Download the sample and decompress aliyun-sdk-mns-samples-1.1.8.zip;

  2. Import the Maven project using Eclipse and select the aliyun-sdk-mns-samples folder;

  3. Create the .aliyun-mns.properties file in the user directory, (“/home/YOURNAME/“ in Linux or “C:\Users\YOURNAME” in Windows), and specify the service address, AccessKeyID, and AccessKeySecret:

    1. mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
    2. mns.accesskeyid=$your_accesskeyid
    3. mns.accesskeysecret=$your_accesskeysecret

Pom Configuration

  1. <dependency>
  2. <groupId>com.aliyun.mns</groupId>
  3. <artifactId>aliyun-sdk-mns</artifactId>
  4. <version>1.1.8</version>
  5. <classifier>jar-with-dependencies</classifier>
  6. </dependency>

Version 1.1.7

Update Date

2016-08-30 SDK Download Sample Download.

Updates

  • Make CloudAccount singleton(same ClientConfiguration will return same MNSClient object).

  • Topic suscription support JSON option.

Help

  1. Download the sample and decompress aliyun-sdk-mns-samples-1.1.7.zip;

  2. Import the Maven project using Eclipse and select the aliyun-sdk-mns-samples folder;

  3. Create the .aliyun-mns.properties file in the user directory, (“/home/YOURNAME/“ in Linux or “C:\Users\YOURNAME” in Windows), and specify the service address, AccessKeyID, and AccessKeySecret:

    1. mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
    2. mns.accesskeyid=$your_accesskeyid
    3. mns.accesskeysecret=$your_accesskeysecret

Version 1.1.5

Update Date

2016-05-26 SDK Download Sample Download.

Updates

  • Add TransactionQueue.

  • Add braodcast message.

  • Add demo code for performance test.

Help

  1. Download the sample and decompress aliyun-sdk-mns-samples-1.1.5.zip;

  2. Import the Maven project using Eclipse and select the aliyun-sdk-mns-samples folder;

  3. Create the .aliyun-mns.properties file in the user directory, (“/home/YOURNAME/“ in Linux or “C:\Users\YOURNAME” in Windows), and specify the service address, AccessKeyID, and AccessKeySecret:

    1. mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
    2. mns.accesskeyid=$your_accesskeyid
    3. mns.accesskeysecret=$your_accesskeysecret
  4. Run QueueSample.java , TopicSample.java , CloudPullTopicDemo.java(demo for broadcast), TransactionMessageDemo.java(demo for tansaction message),TransactionMessageDemo2.java(Simple demo for transaction message which need more failover operations).

Version 1.1.4

Update Date

2016-04-25 SDK Download Sample Download.

Updates

  • Subscription supports Queue/Mail Endpoint

  • Topic supports message tag

  • BugFix: fix long polling timeout problem due to the number of connection exceed the maxConnectionsPerRoute.

Help

  1. Download the sample and decompress aliyun-sdk-mns-samples-1.1.4.zip;

  2. Import the Maven project using Eclipse and select the aliyun-sdk-mns-samples folder;

  3. Create the .aliyun-mns.properties file in the user directory, (“/home/YOURNAME/“ in Linux or “C:\Users\YOURNAME” in Windows), and specify the service address, AccessKeyID, and AccessKeySecret:

    1. mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
    2. mns.accesskeyid=$your_accesskeyid
    3. mns.accesskeysecret=$your_accesskeysecret
  4. Run QueueSample.java and TopicSample.java file

Version 1.1.3

Update Date

2016-03-28 SDK Download Sample Download

Updates

  • Support HTTPS.
  • Remove the default value of priority ,dequeueCount, delaySeconds of Message.

Help

  1. Download the sample and decompress aliyun-sdk-mns-samples-1.1.3.zip;

  2. Import the Maven project using Eclipse and select the aliyun-sdk-mns-samples folder;

  3. Create the .aliyun-mns.properties file in the user directory, (“/home/YOURNAME/“ in Linux or “C:\Users\YOURNAME” in Windows), and specify the service address, AccessKeyID, and AccessKeySecret:

    1. mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
    2. mns.accesskeyid=$your_accesskeyid
    3. mns.accesskeysecret=$your_accesskeysecret
  4. Run QueueSample.java and TopicSample.java file

Version 1.1.2

Update Date

2016-01-30 SDK Download Sample Download

Updates

  • fixbug: popMessage API set waitseconds default value to 0 while waitseconds isn’t provided.

Help

  1. Download the sample and decompress aliyun-sdk-mns-samples-1.1.2.zip;

  2. Import the Maven project using Eclipse and select the aliyun-sdk-mns-samples folder;

  3. Create the .aliyun-mns.properties file in the user directory, (“/home/YOURNAME/“ in Linux or “C:\Users\YOURNAME” in Windows), and specify the service address, AccessKeyID, and AccessKeySecret:

    1. mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
    2. mns.accesskeyid=$your_accesskeyid
    3. mns.accesskeysecret=$your_accesskeysecret
  4. Run QueueSample.java and TopicSample.java file

Version 1.1.1

Update Date

2016-01-19 SDK Download Sample Download.

Updates

  • Fix bug:Using UTF-8 charset of Chinese instead of default GB charset.

Help

  1. Download the sample and decompress aliyun-sdk-mns-samples-1.1.1.zip;
  2. Import the Maven project using Eclipse and select the aliyun-sdk-mns-samples folder;
  3. Create the .aliyun-mns.properties file in the user directory, (“/home/YOURNAME/“ in Linux or “C:\Users\YOURNAME” in Windows), and specify the service address, AccessKeyID, and AccessKeySecret:
    1. mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
    2. mns.accesskeyid=$your_accesskeyid
    3. mns.accesskeysecret=$your_accesskeysecret
  4. Run QueueSample.java and TopicSample.java file.

Version 1.1.0

Update Date

2016-01-06 SDK Download Sample Download.

Updates

  • Add support for Topic.

  • Add support for STS Token.

  • Make Message Base64 Encoding optional.

Help

  1. Download the sample and decompress aliyun-sdk-mns-samples-1.1.0.zip;

  2. Import the Maven project using Eclipse and select the aliyun-sdk-mns-samples folder;

  3. Create the .aliyun-mns.properties file in the user directory, (“/home/YOURNAME/“ in Linux or “C:\Users\YOURNAME” in Windows), and specify the service address, AccessKeyID, and AccessKeySecret:

    1. mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
    2. mns.accesskeyid=$your_accesskeyid
    3. mns.accesskeysecret=$your_accesskeysecret
  4. Run QueueSample.java and TopicSample.java file.

Version 1.0.5

Update Date

2015-12-02 SDK Download Sample Download.

Updates

  • Fix bug: memory leak while using multiple CloudAccount Object.

  • Upgrade the version of httpasyncclient to 4.1.

Help

  1. Download the sample and decompress aliyun-sdk-mns-samples-1.0.5.zip;

  2. Import the Maven project using Eclipse and select the aliyun-sdk-mns-samples folder;

  3. Create the .aliyun-mns.properties file in the user directory, (“/home/YOURNAME/“ in Linux or “C:\Users\YOURNAME” in Windows), and specify the service address, AccessKeyID, and AccessKeySecret:

    1. mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
    2. mns.accesskeyid=$your_accesskeyid
    3. mns.accesskeysecret=$your_accesskeysecret
  4. Run the Sample.java file.

Version 1.0.4

Update Date

2015-11-05 SDK Download ,Sample Download.

Updates

  • Fix bug: thread hang while network is abnormal;

  • Fix bug: recycle the thread while closing the free connection.

Help

  1. Download the sample and decompress aliyun-sdk-mns-samples-1.0.4.zip;

  2. Import the Maven project using Eclipse and select the aliyun-sdk-mns-samples folder;

  3. Create the .aliyun-mns.properties file in the user directory, (“/home/YOURNAME/“ in Linux or “C:\Users\YOURNAME” in Windows), and specify the service address, AccessKeyID, and AccessKeySecret:

    1. mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
    2. mns.accesskeyid=$your_accesskeyid
    3. mns.accesskeysecret=$your_accesskeysecret
  4. Run the Sample.java file.

Version 1.0.3

Update Date

2015-06-09 SDK Download Sample Download.

Updates

  • Fixed bug: SDKs is suspended due to a large number of close wait connections;

  • Added sample code;

  • Upgraded the API protocol: “x-mns-version”=”2015-06-06”;

  • Supports BatchSendMessage, BatchReceiveMessage, BatchPeekMessage, and BatchDeleteMessage.

Help

  1. Download the sample and decompress aliyun-sdk-mns-samples-1.0.3.zip;

  2. Import the Maven project using Eclipse and select the aliyun-sdk-mns-samples folder;

  3. Create the .aliyun-mns.properties file in the user directory, (“/home/YOURNAME/“ in Linux or “C:\Users\YOURNAME” in Windows), and specify the service address, AccessKeyID, and AccessKeySecret:

    1. mns.accountendpoint=http://$accountid.mns.cn-hangzhou.aliyuncs.com
    2. mns.accesskeyid=$your_accesskeyid
    3. mns.accesskeysecret=$your_accesskeysecret
  4. Run the Sample.java file.

Version 1.0.2

Update Date

2015-03-03 Download.

Updates

  • Optimized XML parsing logic and improved performance.

Version 1.0.1

Update Date

2014-12-19 Download

Updates

  • Corrected the default thread pool size to 50 and resolved the SDK performance bottleneck for large-scale concurrent synchronization.

Version 1.0.0

Update Date

2014-08-01 Download

Thank you! We've received your feedback.