Java SDK:Java SDK 使用说明-问答-阿里云开发者社区-阿里云

开发者社区> 问答> 正文

Java SDK:Java SDK 使用说明

行者武松 2017-10-23 14:47:39 2422


简介


欢迎使用阿里云开发者工具套件(SDK)。阿里云Java SDK让您不用复杂编程即可访问云服务器、云监控等多个阿里云服务。这里向您介绍如何获取阿里云Java SDK并开始调用。

环境准备


  1. 阿里云Java SDK适用于JDK 6及以上版本。

  2. 要使用阿里云Java SDK,您需要一个云账号以及一对Access Key ID和Access Key Secret。 请在阿里云控制台中的AccessKey管理页面上创建和查看您的Access Key,或者联系您的系统管理员。

  3. 要使用阿里云SDK访问某个产品的API,您需要事先在阿里云控制台中开通这个产品。


SDK获取和安装


阿里云Java SDK发布在 https://develop.aliyun.com/tools/sdk#/java 这个地址。
请注意,部分阿里云产品的SDK未收录到这个列表中,例如对象存储(OSS),表格存储(Table Store),请前往这些产品的详情页获取相应的SDK。
要成功地调用一个产品的SDK, 您至少需要首先安装SDK核心库。 例如,对云服务器SDK的调用,您需要获取和安装2个SDK,分别是SDK核心库和云服务器的SDK。
您可以通过以下两种方式来安装SDK:在Maven项目中加入依赖项,和在集成开发环境(IDE)中导入Jar包。

方式一: Maven项目中加入依赖项(推荐)


如果您使用Maven来管理您的Java项目,要获得阿里云Java SDK,只需在pom.xml里加入相应的依赖项即可。这些依赖项可以在阿里云Java SDK的 发布地址中找到。
以3.2.2版本的SDK核心库和3.0.0版本的云服务器SDK为例:
  1. <dependency>
  2.     <groupId>com.aliyun</groupId>
  3.     <artifactId>aliyun-java-sdk-core</artifactId>
  4.     <version>3.2.2</version>
  5. </dependency>
  6. <dependency>
  7.     <groupId>com.aliyun</groupId>
  8.     <artifactId>aliyun-java-sdk-ecs</artifactId>
  9.     <version>3.0.0</version>
  10. </dependency>


方式二:在集成开发环境(IDE)中导入JAR包


不论您使用了Eclipse还是IntelliJ作为集成开发环境,您都可以通过导入JAR包的方式来获取阿里云Java SDK。这些JAR包可以在阿里云Java SDK的 发布地址中下载。

Eclipse


  1. 将下载的 aliyun-java-sdk-XXX.jar 文件复制到您的项目文件夹中。

  2. 在Eclipse中,依次选择菜单:工程,Properties,Java Build Path, Add JARs。

  3. 选中您下载的这些JAR文件。


IntelliJ


  1. 将下载的 aliyun-java-sdk-XXX.jar 文件复制到您的项目文件夹中。

  2. 在IntelliJ中,依次选择菜单:File, Project Structure, Modules, 然后选择 Dependencies 选项卡。在出现的列表中选择“添加”(对话框右方的绿色“+”号),再选择 “JARs or directories”。

  3. 选中您下载的这些JAR文件。


开始调用


以下这个代码示例向您展示了调用阿里云SDK的3个主要步骤:
  1. 创建DefaultAcsClient实例并初始化
  2. 创建API请求并设置参数
  3. 发起请求并处理异常
  1. import com.aliyuncs.profile.DefaultProfile;
  2. import com.aliyuncs.DefaultAcsClient;
  3. import com.aliyuncs.IAcsClient;
  4. import com.aliyuncs.exceptions.ClientException;
  5. import com.aliyuncs.exceptions.ServerException;
  6. import com.aliyuncs.ecs.model.v20140526.*;
  7. class Sample {
  8.     public static void main(String[] args) {
  9.         // 创建DefaultAcsClient实例并初始化
  10.         DefaultProfile profile = DefaultProfile.getProfile(
  11.             "<your-region-id>",          // 您的可用区ID
  12.             "<your-access-key-id>",      // 您的Access Key ID
  13.             "<your-access-key-secret>"); // 您的Access Key Secret
  14.         IAcsClient client = new DefaultAcsClient(profile);
  15.         // 创建API请求并设置参数
  16.         DescribeInstancesRequest request = new DescribeInstancesRequest();
  17.         request.setPageSize(10);
  18.         // 发起请求并处理异常
  19.         try {
  20.             DescribeInstancesResponse response = client.getAcsResponse(request);
  21.         } catch (ServerException e) {
  22.             e.printStackTrace();
  23.         } catch (ClientException e) {
  24.             e.printStackTrace();
  25.         }
  26.     }
  27. }

在创建DefaultAcsClient实例并初始化时,您需要填写3个参数:Region ID、Access Key ID和Access Key Secret。Access Key ID和Access Key Secret可以从控制台获得;而Region ID可以从 地域列表中获得。

API参考


要知道您想访问的产品提供的API以及它们的参数,请参考 开放了API的产品列表
sdk使用说明 java使用说明 java使用说明 sdk使用 sdk说明
分享到
取消 提交回答
全部回答(0)
开发与运维
使用钉钉扫一扫加入圈子
+ 订阅

集结各类场景实战经验,助你开发运维畅行无忧

相似问题
最新问题
推荐课程