文档

Java SDK版本说明

更新时间:

建议下载最新发布的SDK版本以获得较高的性能和稳定性。

说明

使用Java SDK时,建议将其升级至1.1.9及以上版本。

添加jaxb依赖

当使用Java 9及以上版本时,需要在pom.xml中添加jaxb相关依赖。

<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
    <version>2.3.1</version>
</dependency>
<dependency>
    <groupId>javax.activation</groupId>
    <artifactId>activation</artifactId>
    <version>1.1.1</version>
</dependency>
<!-- no more than 2.3.3-->
<dependency>
    <groupId>org.glassfish.jaxb</groupId>
    <artifactId>jaxb-runtime</artifactId>
    <version>2.3.3</version>
</dependency>

Version 1.1.9.1

  • 更新日期

    2021-12-24

    SDK下载

    sample下载

  • 更新内容

    • 去除Log4j依赖,改为使用SLF4J依赖。

  • 使用帮助

    1. 下载sample并解压aliyun-sdk-mns-samples-1.1.9.1.zip

    2. 用Eclipse导入Maven工程,选中aliyun-sdk-mns-samples文件夹。

    3. 在用户目录中创建.aliyun-mns.properties文件,并填写服务地址、AccessKeyId和AccessKeySecret。

      说明

      Linux系统用户目录为/home/YOURNAME/,Windows系统用户目录为C:\Users\YOURNAME

      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>        
  • pom配置

    <dependency>
        <groupId>com.aliyun.mns</groupId>
        <artifactId>aliyun-sdk-mns</artifactId>
        <version>1.1.9.1</version>
    </dependency>

Version 1.1.9

  • 更新日期

    2021-03-18

    SDK下载

    sample下载

  • 更新内容

    • 支持OpenService接口。

    • 修复缺陷,在特殊场景下,网络抖动导致客户端抛出I/O reactor status: STOPPED的异常。

  • 使用帮助

    1. 下载sample并解压aliyun-sdk-mns-samples-1.1.9.zip

    2. 用Eclipse导入Maven工程,选中aliyun-sdk-mns-samples文件夹。

    3. 在用户目录中创建.aliyun-mns.properties文件,并填写服务地址、AccessKeyId和AccessKeySecret。

      说明

      Linux系统用户目录为/home/YOURNAME/,Windows系统用户目录为C:\Users\YOURNAME

      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>        
  • pom配置

    <dependency>
        <groupId>com.aliyun.mns</groupId>
        <artifactId>aliyun-sdk-mns</artifactId>
        <version>1.1.9</version>
    </dependency>  

Version 1.1.8

  • 更新日期

    2016-12-15

    SDK下载

    sample下载

  • 更新内容

    Topic订阅增加batch短信发送接口。

  • 使用帮助

    1. 下载sample并解压aliyun-sdk-mns-samples-1.1.8.zip

    2. 用Eclipse导入Maven工程,选中aliyun-sdk-mns-samples文件夹。

    3. 在用户目录中创建.aliyun-mns.properties文件,并填写服务地址、AccessKeyId和AccessKeySecret。

      说明

      Linux系统用户目录为/home/YOURNAME/,Windows系统用户目录为C:\Users\YOURNAME

      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>        
  • pom配置

    <dependency>
        <groupId>com.aliyun.mns</groupId>
        <artifactId>aliyun-sdk-mns</artifactId>
        <version>1.1.8</version>
    </dependency>  

Version 1.1.7

  • 更新日期

    2016-08-30

    SDK下载

    sample下载

  • 更新内容

    • 多次调用getMNSClient时返回同一个Java对象。

    • 修复缺陷。

    • Topic订阅增加JSON选项。

  • 使用帮助

    1. 下载sample并解压aliyun-sdk-mns-samples-1.1.7.zip

    2. 用Eclipse导入Maven工程,选中aliyun-sdk-mns-samples文件夹。

    3. 在用户目录中创建.aliyun-mns.properties文件,并填写服务地址、AccessKeyId和AccessKeySecret。

      说明

      Linux系统用户目录为/home/YOURNAME/,Windows系统用户目录为C:\Users\YOURNAME

      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>      
  • pom配置

    <dependency>
        <groupId>com.aliyun.mns</groupId>
        <artifactId>aliyun-sdk-mns</artifactId>
        <version>1.1.7</version>
    </dependency>  

Version 1.1.5

  • 更新日期

    2016-05-26

    SDK下载

    sample下载

  • 更新内容

    • 增加事务消息队列TransactionQueue。

    • 增加一对多广播消息功能。

    • 新增JAVA SDK性能测试示例代码。

  • 使用帮助

    1. 下载sample并解压aliyun-sdk-mns-samples-1.1.5.zip

    2. 用Eclipse导入Maven工程,选中aliyun-sdk-mns-samples文件夹。

    3. 在用户目录中创建.aliyun-mns.properties文件,并填写服务地址、AccessKeyId和AccessKeySecret。

      说明

      Linux系统用户目录为/home/YOURNAME/,Windows系统用户目录为C:\Users\YOURNAME

      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>          
    4. 运行QueueSample.javaTopicSample.javaCloudPullTopicDemo.java(广播消息示例代码)、TransactionMessageDemo.java(事务队列完全封装版使用示例)、TransactionMessageDemo2.java(事务队列用户自定义版示例,需要用户自定义本地事务,做Failover处理)。

  • pom配置

    <dependency>
        <groupId>com.aliyun.mns</groupId>
        <artifactId>aliyun-sdk-mns</artifactId>
        <version>1.1.5</version>
    </dependency>  

Version 1.1.4

  • 更新日期

    2016-04-25

    SDK下载

    sample下载

  • 更新内容

    • 订阅支持设置队列和邮件为Endpoint。

    • 主题支持消息过滤。

    • 修复长轮询请求数超过单路由(maxConnectionsPerRoute)最大链接数导致请求超时。

  • 使用帮助

    1. 下载sample并解压aliyun-sdk-mns-samples-1.1.4.zip

    2. 用Eclipse导入Maven工程,选中aliyun-sdk-mns-samples文件夹。

    3. 在用户目录中创建.aliyun-mns.properties文件,并填写服务地址、AccessKeyId和AccessKeySecret。

      说明

      Linux系统用户目录为/home/YOURNAME/,Windows系统用户目录为C:\Users\YOURNAME

      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>           
    4. 运行QueueSample.javaTopicSample.java文件。

  • pom配置

    <dependency>
        <groupId>com.aliyun.mns</groupId>
        <artifactId>aliyun-sdk-mns</artifactId>
        <version>1.1.4</version>
    </dependency>  

Version 1.1.3

  • 更新日期

    2016-03-28

    SDK下载

    sample下载

  • 更新内容

    • 支持HTTPS。

    • 去除Message对象中priority、dequeueCount、delaySeconds的默认初始化值。

  • 使用帮助

    1. 下载sample并解压aliyun-sdk-mns-samples-1.1.3.zip

    2. 用Eclipse导入Maven工程,选中aliyun-sdk-mns-samples文件夹。

    3. 在用户目录中创建.aliyun-mns.properties文件,并填写服务地址、AccessKeyId和AccessKeySecret。

      说明

      Linux系统用户目录为/home/YOURNAME/,Windows系统用户目录为C:\Users\YOURNAME

      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>            
    4. 运行QueueSample.javaTopicSample.java文件。

  • pom配置

    <dependency>
        <groupId>com.aliyun.mns</groupId>
        <artifactId>aliyun-sdk-mns</artifactId>
        <version>1.1.3</version>
    </dependency>  

Version 1.1.2

  • 更新日期

    2016-01-30

    SDK下载

    sample下载

  • 更新内容

    修复popMessage接口无参数情况下waitseconds取QueueMeta中设置的值,而非0。

  • 使用帮助

    1. 下载sample并解压aliyun-sdk-mns-samples-1.1.2.zip

    2. 用Eclipse导入Maven工程,选中aliyun-sdk-mns-samples文件夹。

    3. 在用户目录中创建.aliyun-mns.properties文件,并填写服务地址、AccessKeyId和AccessKeySecret。

      说明

      Linux系统用户目录为/home/YOURNAME/,Windows系统用户目录为C:\Users\YOURNAME

      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>
    4. 运行QueueSample.javaTopicSample.java文件。

  • pom配置

    <dependency>
        <groupId>com.aliyun.mns</groupId>
        <artifactId>aliyun-sdk-mns</artifactId>
        <version>1.1.2</version>
    </dependency>  

Version 1.1.1

  • 更新日期

    2016-01-19

    SDK下载

    sample下载

  • 更新内容

    修复中文消息使用UTF-8编码,而非平台默认字符集。

  • 使用帮助

    1. 下载sample并解压aliyun-sdk-mns-samples-1.1.1.zip

    2. 用Eclipse导入Maven工程,选中aliyun-sdk-mns-samples文件夹。

    3. 在用户目录中创建.aliyun-mns.properties文件,并填写服务地址、AccessKeyId和AccessKeySecret。

      说明

      Linux系统用户目录为/home/YOURNAME/,Windows系统用户目录为C:\Users\YOURNAME

      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>         
    4. 运行QueueSample.javaTopicSample.java文件。

  • pom配置

    <dependency>
        <groupId>com.aliyun.mns</groupId>
        <artifactId>aliyun-sdk-mns</artifactId>
        <version>1.1.1</version>
    </dependency>  

Version 1.1.0

  • 更新日期

    2016-01-06

    SDK参考

    sample下载

  • 更新内容

    • 添加对于Topic功能的支持。

    • 添加对于STS Token的支持。

    • 消息Base64编码支持可选。

  • 使用帮助

    1. 下载sample并解压aliyun-sdk-mns-samples-1.1.0.zip

    2. 用Eclipse导入Maven工程,选中aliyun-sdk-mns-samples文件夹。

    3. 在用户目录中创建.aliyun-mns.properties文件,并填写服务地址、AccessKeyId和AccessKeySecret。

      说明

      Linux系统用户目录为/home/YOURNAME/,Windows系统用户目录为C:\Users\YOURNAME

      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>        
    4. 运行QueueSample.javaTopicSample.java文件。

  • pom配置

    <dependency>
        <groupId>com.aliyun.mns</groupId>
        <artifactId>aliyun-sdk-mns</artifactId>
        <version>1.1.0</version>
    </dependency>  

Version 1.0.5

  • 更新日期

    2015-12-02

    SDK下载

    sample下载

  • 更新内容

    • 修复问题多CloudAccount对象时导致内存泄漏。

    • 依赖的httpasyncclient版本升至4.1。

  • 使用帮助

    1. 下载sample并解压aliyun-sdk-mns-samples-1.0.5.zip

    2. 用Eclipse导入Maven工程,选中aliyun-sdk-mns-samples文件夹。

    3. 在用户目录中创建.aliyun-mns.properties文件,并填写服务地址、AccessKeyId和AccessKeySecret。

      说明

      Linux系统用户目录为/home/YOURNAME/,Windows系统用户目录为C:\Users\YOURNAME

      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>            
    4. 运行Sample.java文件。

  • pom配置

    <dependency>
        <groupId>com.aliyun.mns</groupId>
        <artifactId>aliyun-sdk-mns</artifactId>
        <version>1.0.5</version>
    </dependency>  

Version 1.0.4

  • 更新日期

    2015-11-05

    SDK下载

    sample下载

  • 更新内容

    • 修复网络异常时极端情况下线程中止。

    • 修复关闭空闲连接回收常驻线程。

  • 使用帮助

    1. 下载sample并解压aliyun-sdk-mns-samples-1.0.4.zip

    2. 用Eclipse导入Maven工程,选中aliyun-sdk-mns-samples文件夹。

    3. 在用户目录中创建.aliyun-mns.properties文件,并填写服务地址、AccessKeyId和AccessKeySecret。

      说明

      Linux系统用户目录为/home/YOURNAME/,Windows系统用户目录为C:\Users\YOURNAME

      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>            
    4. 运行Sample.java文件。

  • pom配置

    <dependency>
        <groupId>com.aliyun.mns</groupId>
        <artifactId>aliyun-sdk-mns</artifactId>
        <version>1.0.4</version>
    </dependency>  

Version 1.0.3

  • 更新日期

    2015-06-09

    SDK参考

    sample下载

  • 更新内容

    • 修复大量close wait的连接导致SDK挂起。

    • 增加sample code。

    • API协议升级:"x-mns-version"="2015-06-06"。

    • 支持BatchSendMessage、BatchReceiveMessage、BatchPeekMessage、BatchDeleteMessage。

  • 使用帮助

    1. 下载sample并解压aliyun-sdk-mns-samples-1.0.3.zip

    2. 用Eclipse导入Maven工程,选中aliyun-sdk-mns-samples文件夹。

    3. 在用户目录中创建.aliyun-mns.properties文件,并填写服务地址、AccessKeyId和AccessKeySecret。

      说明

      Linux系统用户目录为/home/YOURNAME/,Windows系统用户目录为C:\Users\YOURNAME

      mns.accountendpoint=http://<yourAccountId>.mns.cn-hangzhou.aliyuncs.com
      mns.accesskeyid=<yourAccessKeyId>
      mns.accesskeysecret=<yourAccessKeySecret>            
    4. 运行Sample.java文件。

  • pom配置

    <dependency>
        <groupId>com.aliyun.mns</groupId>
        <artifactId>aliyun-sdk-mns</artifactId>
        <version>1.0.3</version>
    </dependency>  

Version 1.0.2

  • 更新日期

    2015-03-03

    SDK下载

  • 更新内容

    优化XML解析逻辑,提升性能。

  • pom配置

    <dependency>
        <groupId>com.aliyun.mns</groupId>
        <artifactId>aliyun-sdk-mns</artifactId>
        <version>1.0.2</version>
    </dependency>  

Version 1.0.1

  • 更新日期

    2014-12-19

    SDK下载

  • 更新内容

    缺省线程池修正为50,修复大规模并发同步时SDK端的性能瓶颈。

  • pom配置

    <dependency>
        <groupId>com.aliyun.mns</groupId>
        <artifactId>aliyun-sdk-mns</artifactId>
        <version>1.0.1</version>
    </dependency>  
  • 本页导读 (1)
文档反馈