查询接口

更新时间:2020-06-01 21:08:46

本章介绍OAS Java SDK提供的查询接口QueryManager。

QueryManager实例化:

  1. ServiceCredentials credentials = new ServiceCredentials("yourAccessKeyID",
  2. "yourAccessKeySecret");
  3. ServiceHost serviceHost = new ServiceHost("http://cn-hangzhou.oas.aliyuncs.com");
  4. ClientConfiguration clientConfiguration = new ClientConfiguration();
  5. AliyunOASClient aliyunOASClient = OASFactory.aliyunOASClientFactory(serviceHost,
  6. credentials, clientConfiguration);
  7. //方法1
  8. QueryManager queryManager = OASFactory.queryManagerFactory(credentials,
  9. "http://cn-hangzhou.oas.aliyuncs.com");
  10. //方法2
  11. QueryManager queryManager2 = OASFactory.queryManagerFactory(serviceHost, credentials,
  12. clientConfiguration);
  13. //方法3
  14. QueryManager queryManager3 = OASFactory.queryManagerFactory(aliyunOASClient);

罗列Part列表

入参ListPartsRequest:

变量名 类型 描述
vaultId String 要查询的VaultId
uploadId String 要查询的UploadId
  1. /**
  2. * 罗列Part列表
  3. * @param request 请求对象
  4. * @return ListPartsResult对象包含Parts列表
  5. */
  6. public ListPartsResult listAllParts(ListPartsRequest request);

返回结果ListPartsResult:

变量名 类型 描述
marker String 查询计数标志
descriptor MultipartUploadDescriptor Multipart上传描述符

其中,MultipartUploadDescriptor类结构:

变量名 类型 描述
partList List<PartDescriptor> 所有part的描述符列表
uploadId String 所属的uploadId
creationDate Date 本上传任务建立的时间
partSize long 本Multipart上传设定的part大小
description String 描述

其中,PartDescriptor类结构:

变量名 类型 描述
range Range 标识该Part的起、止位置
treeEtag String 该Part根据TreeEtag算法生成的校验信息
contentEtag String 该Part根据md5算法生成的校验信息

罗列Vault列表

  1. /**
  2. * 罗列所有Vault列表
  3. * @param request 请求对象
  4. * @return ListVaultsResult对象
  5. */
  6. public ListVaultsResult listAllVaults(ListVaultsRequest request);

返回结果ListVaultsResult:

变量名 类型 描述
marker String 下一次请求的起始标识
vaultList List<VaultDescriptor> Vault的JSON描述列表

查询VaultId

  1. /**
  2. * 根据VaultName获得VaultId
  3. * @param vaultName Vault名字
  4. * @return VaultId字符串
  5. */
  6. public String getVaultIdFromName(String vaultName);

罗列MultipartUpload任务

  1. /**
  2. * 罗列所有MultipartUpload任务
  3. * @param request 请求对象
  4. * @return ListMultipartUploadsResult对象
  5. */
  6. public ListMultipartUploadsResult listAllMultipartUploads(ListMultipartUploadsRequest request);

返回结果ListMultipartUploadsResult:

变量名 类型 描述
marker String 下一次列表查询的起始标识
uploadList List<MultipartUploadDescriptor> Mulitpart Upload的JSON描述列表

罗列所有Job列表

  1. /**
  2. * 罗列出所有的Job
  3. * @param request 请求对象
  4. * @return ListJobsResult对象
  5. */
  6. public ListJobsResult listAllJobs(ListJobsRequest request);

返回结果ListJobsResult:

变量名 类型 描述
marker String 下一次查询的起始标识
vaultList List<VaultDescriptor> Job的JSON描述列表