Ucloud 开发者工具套件（SDK）。

面向 AutoAI 的多个产品服务，目前包括：

• uhost
• udisk
• unet
• ulb
• vpc
• ufs
• usql
• pathx
• udb
• udpn
• umem
• censor
• ocr
• usms

后续将支持更多的 AutoAI 的产品服务。

• 需要一个 AutoAI 的账号以及一对 PrivateKey、PublicKey 点此获取

方式一、maven 仓库

以使用 udisk 为例：

snippet.xml

>
  >cn.ucloud>
  >ucloud-sdk-java-udisk>
  >0.8.2.6-release>
>

方式二、官网下载（暂时无效）

以使用“获取 udisk 信息”为例：

第一步、创建 UdiskClient 并实例化，默认实例化为 DefaultUdiskClient

    在ucloud-sdk-java中，*Client都是sdk的客户端接口，通过*Client发起目标操作。并且，*Client都有一个已经
 实现的Default*Client。
    
    在实例化Default*Client时，设置*Config参数，*Config接受一个Account对象的实例化参数。在*Config可能会
 需要一些其他的必要参数，这个需要根据具体使用的Client确定。

        

第二步、创建 DescribeUDiskParam 并实例化，作为请求的参数对象

  
      在ucloud-sdk-java中，*Param对象都是请求的参数类。
      
      每个参数类中属性注释“require”代表参数为必要参数，“optional”代表参数为可选参数。
      
      *Param实例化时所需要的构造参数均为必要参数，当然，一些“Array”类型或者“对象”类型的参数并没有出现构造参数中，
   对于这样的必要参数，你需要通过set方法设置，如果缺少了这些必要参数，sdk将抛出“ValidationException”，并且在
   异常信息中会给出必要参数的属性名称。

第三步、发起请求并处理结果（支持三种方式）

      方式1：同步处理
      try{
          result = client.method(param);
      } catch (Exception e){
          // 这里可能会抛出一些异常
          // 比如网络异常等
      }
      这个方式与常见调用方式相同，阻塞调用，直到当前请求结果返回。

—-

    方式2：同步回调处理
    client.method(param, new UcloudHandler<*Result>() {
         @Override
         public Object success(*Result result) {
              // result中的retCode为0时
              return null;
         }
                                           
         @Override
         public Object failed(*Result result) {
              // result中的retCode不为0时
              return null;
         }
                                           
         @Override
         public Object error(Exception e) {
               // 当发生异常时候，需要在这个方法中进行处理
               return null;
         }
    },false);
    这个方式也是阻塞的，直到当前请求结果返回。

—-

      方式3：异步回调处理    
      这个方式是非阻塞的，调用方式与方式2类似，但是要缺省method()最后的flag参数，或者为true。
          

代码示例：

snippet.java

import cn.ucloud.common.pojo.Account;
import cn.ucloud.udisk.client.DefaultUdiskClient;
import cn.ucloud.udisk.client.UdiskClient;
import cn.ucloud.udisk.model.DescribeUDiskParam;
import cn.ucloud.udisk.model.DescribeUDiskResult;
import cn.ucloud.udisk.pojo.UdiskConfig;
 
 
public class Main {
 
    public static void main(String []args)  {
        UdiskClient client = new DefaultUdiskClient(new UdiskConfig(
                new Account("PrivateKey",
                        "PublicKey")
        ));
        DescribeUDiskParam param = new DescribeUDiskParam("region");
        param.setProjectId("projectId");
        DescribeUDiskResult describeUDisk = null;
        try {
            describeUDisk = client.describeUDisk(param);
        } catch (Exception e) {
            e.printStackTrace();
        }
        System.out.println(describeUDisk);
    }
}