欢迎使用阿里云开发者工具套件（Alibaba Cloud SDK for Java）。Alibaba Cloud SDK for Java让您不用复杂编程即可访问云数据库Redis版。本教程介绍如何安装并开始使用Alibaba Cloud SDK for Java。

在线调试和生成SDK示例

OpenAPI Explorer提供在线调用云产品API、动态生成SDK示例代码和快速检索接口等功能，能显著降低使用API的难度，推荐您使用。

前提条件

  • 使用Alibaba Cloud SDK for Java，您需要一个阿里云账号和访问密钥（AccessKey）。 请在阿里云控制台中的AccessKey管理页面上创建和查看您的AccessKey，或联系您的系统管理员。
  • 安装Java环境。Alibaba Cloud SDK for Java要求使用JDK1.6或更高版本。

安装Alibaba Cloud SDK for Java

您可以通过添加Maven依赖或者导入Jar文件来安装Java SDK，详细说明请参见安装Alibaba Cloud SDK for Java。
说明 通过添加Maven依赖下载SDK包时，请选择最新版本的SDK。

使用Alibaba Cloud SDK for Java调用Redis API

  1. 创建DefaultAcsClient实例并初始化。 
    DefaultProfile profile = DefaultProfile.getProfile(
    "<regionId>",         // 地域ID
    "<accessKeyId>",      // RAM账号的AccessKey ID
    "<accessKeySecret>"); // RAM账号Access Key Secret
IAcsClient client = new DefaultAcsClient(profile);
  2. 设置地域和域名信息（可选）。
    Endpoint是阿里云服务的API服务端地址。针对不同的地域，单个服务可能有不同的endpoint。阿里云SDK内置了endpoint寻址模块，当您调用SDK对一个服务发起请求时，SDK会自动根据您在创建SDK client时指定的地域ID（Region ID）和产品ID来找到endpoint，所以该步骤为可选。各地域的endpoint信息请参见服务地址。 
    DefaultProfile.addEndpoint(
    "<endpointName>",  // Endpoint名称，可自定义
    "<regionId>",      // 地域ID
    "r-kvstore",       // 产品编码，Redis的编码固定为r-kvstore
    "<endpoint>");     // 服务端地址
  3. 创建API请求并设置参数。
    下方代码以调用DescribeAccounts接口作为示例。 
    DescribeAccountsRequest request = new DescribeAccountsRequest();
    request.setInstanceId("r-bp1xxxxxxxxxxxx");
  4. 发起请求并处理应答或异常。 
    try {
    DescribeAccountsResponse response = client.getAcsResponse(request);
    System.out.println(new Gson().toJson(response));
} catch (ServerException e) {
    e.printStackTrace();
} catch (ClientException e) {
    System.out.println("ErrCode:" + e.getErrCode());
    System.out.println("ErrMsg:" + e.getErrMsg());
    System.out.println("RequestId:" + e.getRequestId());
}

完整的示例代码

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.profile.DefaultProfile;
import com.google.gson.Gson;
import java.util.*;
import com.aliyuncs.r_kvstore.model.v20150101.*;

public class DescribeAccounts {

    public static void main(String[] args) {
        // 创建DefaultAcsClient实例并初始化
        DefaultProfile profile = DefaultProfile.getProfile(
            "cn-hangzhou",        // 地域ID
            "<accessKeyId>",      // RAM账号的AccessKey ID
            "<accessKeySecret>"); // RAM账号的AccessKey Secret
        IAcsClient client = new DefaultAcsClient(profile);
        // 设置地域和域名信息（可选）
        DefaultProfile.addEndpoint(
            "cn-hangzhou", // Endpoint名称，可自定义
            "cn-hangzhou", // 地域ID
            "r-kvstore",   // 产品编码，Redis的编码固定为r-kvstore
            "r-kvstore.aliyuncs.com"); // 服务端地址
        // 创建API请求并设置参数
        DescribeAccountsRequest request = new DescribeAccountsRequest();
        request.setInstanceId("r-bp1xxxxxxxxxxxx");
        // 发起请求并处理应答或异常
        try {
            DescribeAccountsResponse response = client.getAcsResponse(request);
            System.out.println(new Gson().toJson(response));
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            System.out.println("ErrCode:" + e.getErrCode());
            System.out.println("ErrMsg:" + e.getErrMsg());
            System.out.println("RequestId:" + e.getRequestId());
        }

    }
}