243      微信

接入指南__Open API_消息队列 MQ-阿里云

本文档介绍 MQ Open API 的接入步骤以及注意事项，包含 SDK 的获取，以及初始化参数的设置。

1. SDK 获取

公测期间，MQ Open API 的 SDK 获取方法有2种，一种是下载 SDK 源码，编译后加入到本地的 Maven 仓库中，另一种是下载打包好的 Jar 包，直接导入工程中。

• 下载 SDK 源码：下载链接

  <dependencies>
        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>aliyun-java-sdk-ons</artifactId>
            <version>1.2.1-SNAPSHOT</version>
        </dependency>
        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>aliyun-java-sdk-core</artifactId>
            <version>2.2.0</version>
        </dependency>
  </dependencies>

  注意：由于公测期间 aliyun-java-sdk-ons 的 lib 目前还没有部署到软件仓库中，所以是从官网上下载 SDK 到本地，编译部署到本地的软件仓库中。

• 下载 Jar 包：SDK Jar 包下载链接

  <dependencies>
        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>aliyun-java-sdk-core</artifactId>
            <version>2.2.0</version>
        </dependency>
  </dependencies>

  其中 aliyun-java-sdk-ons 的 Jar 包是从官网上下载 SDK 到本地。

2. 公共参数设置

Open API 使用时需要启动 Open API 的客户端，而客户端启动时需要设置接入点和 AccessKey，SecretKey 等参数信息，具体示例如下:

    /**
    *Open API的接入点，设置为目标Region
    */
    String regionId = "XXXXX";
    /**
    *鉴权使用的AccessKey，由阿里云官网控制台获取
    */
    String accessKey = "XXXXXXXXXXXXXXXXX";
    /**
    *鉴权使用的SecretKey，由阿里云官网控制台获取
    */
    String secretKey = "XXXXXXXXXXXXXXXXX";
    /*
    *通过Open API访问的云产品名称，此处设置为Ons即可
    */
    String productName ="Ons";
    /**
    *对应endPoint接入点的接入点域名
    */
    String domain ="ons.XXXXX.aliyuncs.com";
    try {
        DefaultProfile.addEndpoint(regionId，regionId，productName，domain);
    } catch (ClientException e) {
        e.printStackTrace();
    }
    IClientProfile profile= DefaultProfile.getProfile(regionId，accessKey，secretKey);
    IAcsClient iAcsClient= new DefaultAcsClient(profile);

参数说明

• regionId：指的是 API 的网关所在区域，目前支持的有 cn-beijing，cn-hangzhou，cn-qingdao，cn-shenzhen 等。
• accessKey：指的是用户在阿里云服务器管理控制台上获取的 AK。
• secretKey：指的是用户在阿里云服务器管理控制台上获得的 SK。
• endPointName：接入点名称，同 RegionId 一致即可。
• productName：Open API 的产品名称，直接写 Ons 即可。
• domain：Open API 的接入点 Domain，规则是ons.${RegionId}.aliyuncs.com，目前 MQ 支持 Open API 的 Region 请参考下表。

最后更新：2016-11-23 16:04:19

  上一篇： 历史版本__Open API_消息队列 MQ-阿里云

  下一篇： 公共术语__Open API_消息队列 MQ-阿里云