Java SDK使用示例

步骤一：下载SDK完整工程

1. 进入OpenAPI门户的API调试页面，在左侧选择API接口。

   本示例以DescribeSourceServers接口为例。

2. 在左侧的参数配置页签，选择服务地址，并填写需要的参数信息。填写时请参考右侧的文档页签，充分了解接口的说明和注意事项（尤其是费用相关信息），以及各参数的具体含义和使用方法。

3. 在右侧的SDK示例页签，选择Java语言，单击下载完整工程按钮，下载SDK完整工程至本地并解压。

   说明

   • 如果您需要复制SDK示例代码，具体操作，请参见如何自动生成SDK示例。

   • 关于Java SDK示例代码的详细说明，请参见SDK快速入门。

   

步骤二：导入解压后的工程

1. 打开开发者工具IDEA。

2. 在顶部菜单中，选择File > New > Project from Existing Sources...。

   

3. 在弹出的对话框中，选择解压后的SDK完整工程文件。

步骤三：配置身份验证

通过阿里云提供的Credentials工具，配置访问接口时的身份验证。阿里云SDK支持通过定义ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET环境变量来创建默认的访问凭证。调用接口时，程序直接访问凭证，读取您的访问密钥（即AccessKey）并自动完成鉴权。

阿里云Credentials工具提供多种身份验证配置方案，更多信息，请参见身份验证配置。

1. 在pom.xml文件中，添加以下依赖，安装阿里云SDK Credentials工具。

   说明

   阿里云SDK Credentials工具的版本会持续更新，建议您可以访问版本更新日志获取最新版本。

   <dependency>
       <groupId>com.aliyun</groupId>
       <artifactId>credentials-java</artifactId>
       <version>0.2.11</version>
   </dependency>

   

2. 右键单击pom.xml文件，选择Maven > Reload project，Maven项目管理工具会自动下载相关的jar包。

3. 配置环境变量ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。具体操作，请参见在Linux、macOS和Windows系统配置环境变量。

   说明

   创建和获取AccessKey的具体操作，请参见创建AccessKey。

步骤四：运行SDK示例代码

1. 在IDEA左侧导航栏中，打开Java SDK示例代码文件。

2. 在顶部菜单中，选择Run > Run...运行代码。

   

3. 查看代码运行结果。

   

后续您可以根据需要对SDK配置HTTPS请求、代理、超时和重试机制等，具体操作，请参见进阶配置。