平安金融云 - 更懂金融的云

Java SDK

1. 简介 <ul> <li>OBS Java SDK 适用于 JDK6 及以上版本；</li> <li>本文档主要介绍 OBS Java SDK 的接口使用及注意事项；</li> <li>并且假设您是平安金融云用户，且已经开通了OBS服务；</li> <li>如果您还没有开通或者还不了解平安金融云 OBS 服务，请登录 OBS产品主页 进行了解。</li> </ul>   2. SDK下载 Java SDK 开发包最新版本<a href="https://obs-cn-shanghai.ocftcloud.com/obs-read-public/fincloud-pingan-obs-java-sdk-3.8.1.jar" target="_blank">v3.8.1</a>。 相关依赖包<a href="https://obs-cn-shanghai.ocftcloud.com/obs-read-public/Obs-Lib.zip" target="_blank"> OBS-Lib</a>。   3. API概览 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> API </td> <td> 描述 </td> </tr> <tr> <td> putObject </td> <td> 普通上传，若对象存在则更新。 </td> </tr> <tr> <td> batchPutObject </td> <td> 同时上传多个 File 对象到 OBS。 </td> </tr> <tr> <td> putObjectMultipart </td> <td> 对于大文件上传，可以切分成片上传。在以下情况下，应该考虑使用分片上传： <ul> <li>文件大于 100M</li> <li>网络环境差，上传易导致失败</li> <li>需要支持断点续传</li> </ul> </td> </tr> <tr> <td> abortMultipartUpload </td> <td> 分片上传的接口中，当参数 MutilpartUploadFileRequest 的 enableCheckpoint 被设置成 true 时（默认为true），断点续传功能被开启。断点续传允许重试失败的分片，而不需重传已经成功的分片。分片上传会在客户端的文件系统中创建一个分片记录（.ucp）文件。开启断点续传功能后，上传会读取该文件中的记录，而只传还未完成的分片；若此记录文件不存在，则会创建该记录文件，并从头开始上传文件。由于分片上传的每个片会驻留在 OBS 中，直到所有分片上传完成且执行 complete 操作。未执行 complete 操作的上传，其相关的分片将占用存储资源。用户需要调用取消分片上传的接口来删除这些分片。 </td> </tr> <tr> <td> putAndCompressObject </td> <td> 将File对象进行压缩上传到对象存储，若对象存在则更新。 </td> </tr> <tr> <td> getObject </td> <td> 下载指定对象，此方法将占用一个Http连接，在Content读取完毕或显示关闭时释放连接。若仅为了获得对象的描述信息而非内容，请使用headObject接口。 </td> </tr> <tr> <td> getSignedUrl </td> <td> 获取对象的已签名的下载 URL。 </td> </tr> <tr> <td> batchGetObject </td> <td> 根据多个文件的 objectKey 同时下载多个文件。 </td> </tr> <tr> <td> getAndUncompressObject </td> <td> 解压指定objectKey对象，然后进行下载。 </td> </tr> <tr> <td> listObjects </td> <td> 查询bucket下的对象列表。 </td> </tr> <tr> <td> headObject </td> <td> 获得对象描述信息以及自定义元数据。 </td> </tr> <tr> <td> deleteObject </td> <td> 删除指定对象。 </td> </tr> <tr> <td> encryptFile </td> <td> 客户端加密是指用户数据在发送给远端服务器之前，通过SDK完成加密，而加密所用的密钥由用户方自己保存，从而可以保证用户数据安全和密钥唯一性，即使数据泄漏别人也无法解密得到原始数据。 </td> </tr> <tr> <td> encryptInputStream </td> <td> 客户端加密是指用户数据在发送给远端服务器之前，通过SDK完成加密，而加密所用的密钥由用户方自己保存，从而可以保证用户数据安全和密钥唯一性，即使数据泄漏别人也无法解密得到原始数据。 </td> </tr> <tr> <td> decryptFile </td> <td> 客户端解密是指用户从OBS服务器获取密文后，在客户端进行数据解密。 </td> </tr> <tr> <td> decryptInputStream </td> <td> 客户端解密是指用户从OBS服务器获取密文后，在客户端进行数据解密。 </td> </tr> <tr> <td> getImageView </td> <td> 格式转换，获取适配图片，支持格式 jpeg，tiff, gif, bmp, png ，其中 gif 格式只会保留第一帧图片，此方法将占用一个 Http 连接，在 Content 读取完毕或显示关闭时释放连接。参数 width 和 height 至少需传入一个，不能同时为 0。 </td> </tr> <tr> <td> getCutImage </td> <td> 根据宽度和高度获取剪切图，先截取图片左边和上边，截取到一定大小后（比较小的时候），会截取四边，保留中间部分，当设定值大于图片实际宽、高时，会根据实际大小裁剪，支持 jpeg, tiff, gif, bmp, emf, exif, wmf, icon, png, memoryBmp, webp。此方法将占用一个 Http 连接，在 Content 读取完毕或显示关闭时释放连接。 </td> </tr> <tr> <td> getImageInfo </td> <td> 获取指定图片信息 </td> </tr> <tr> <td> transCodingMedia </td> <td> 媒体转码，此方法将占用一个 Http 连接，在 Content 读取完毕或显示关闭时释放连接。 </td> </tr> <tr> <td> getVedioFrame </td> <td> 获取视频截图，此方法将占用一个 Http 连接，在 Content 读取完毕或显示关闭时释放连接。 </td> </tr> <tr> <td> getMediaInfo </td> <td> 获取媒体对象的信息。 </td> </tr> <tr> <td> queryMediaByCKs </td> <td> 获取 media 转码记录，用于查询转码进度。 </td> </tr> <tr> <td> pfop </td> <td> 图片、音视频异步处理并持久化。 </td> </tr> <tr> <td> prefop </td> <td> 操作pfop操作进度和操作结果。 </td> </tr> </tbody> </table>   4. API描述 前言 ObjectKey的定义须符合规范，具体请参照术语说明 （1）初始化服务 描述 RadosgwService 是 OBS 服务的 JAVA 客户端，它为调用者提供一系列与 OBS 进行交互的接口，用于上传下载文件，加密解密文件，处理图片，音视频文件等。用户在调用 SDK 接口前必须先初始化 RadosgwService 服务。 <ul> <li> 基本配置文件创建服务实例：</li> </ul> <pre> <code>String configFileName = <your config file name>; RadosgwService service = RadosgwServiceFactory. getFromConfigFile(configFileName);</code></pre> 将配置文件信息放在 classpath 下，作为 configFileName.properties 文件存放。 configFileName.properties 信息内容示例如下: <pre> <code>access_id = theAccessId security_id = theSecurityId rgw_addr = theObsEndPoint</code></pre> <ul> <li>基于 ObsClientConfig 接口对象创建服务实例：</li> </ul> <pre> <code>ObsClientConfig oc = new ObsClientConfig() { public String getUserAgent() { return "<your system name>"; } public String getObsUrl() { return "<theObsEndPoint>"; } public String getObsAccessKey() { return "<theAccessId>"; } public String getObsSecret() { return "<theSecurityId>"; } }; RadosgwService service = RadosgwServiceFactory.getFromConfigObject(oc);</code></pre> theObsEndPoint请从OBS控制台去获取endpoint，建议使用https 的请求，如"https：//obs-cn-shenzhen.ocftcloud.com"。   （2）文件上传 putObject(String bucket, String objectKey, File localFile) 接口描述 以 File 对象上传对象存储，若对象存在则更新。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> true </td> <td> 保存对象的 bucket 名称 </td> <td>   </td> </tr> <tr> <td> objectKey </td> <td> String </td> <td> true </td> <td> 对象 Key </td> <td> 需自行实现策略保证同一 bucket 下 objectKey唯一， 首字符不能为路径符。 </td> </tr> <tr> <td> localFile </td> <td> File </td> <td> true </td> <td> 待上传的文件对象 </td> <td> 不能超过 1GB </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> putObjectResult  </td> <td> PutObjectResult  </td> <td> PutObjectResult 对象 </td> <td>   </td> </tr> </tbody> </table>   putObject(String bucket, String objectKey, File localFile, ObjectMetadata metadata) 接口描述 以 File 对象上传对象存储并附带自定义元数据，若对象存在则更新。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> true </td> <td> 保存对象的 bucket 名称 </td> <td>   </td> </tr> <tr> <td> objectKey </td> <td> String </td> <td> true </td> <td> 对象 Key </td> <td> 需自行实现策略保证同一 bucket 下 objectKey唯一， 首字符不能为路径符。 </td> </tr> <tr> <td> localFile </td> <td> File </td> <td> true </td> <td> 待上传的文件对象 </td> <td> 不能超过 1GB </td> </tr> <tr> <td> metadata </td> <td> ObjectMetadata </td> <td> true </td> <td> 自定义元数据 </td> <td> key-value 格式，key 只允许使用小写字母、数字、中横线 </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> putObjectResult  </td> <td> PutObjectResult  </td> <td> PutObjectResult 对象 </td> <td>   </td> </tr> </tbody> </table>   （3）流式上传 putObject(String bucket, String objectKey, InputStream inputStream) 接口描述 以 InputStream 形式上传对象存储，若对象存在则更新，建议仅用于上传较小的对象。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> true </td> <td> 保存对象的 bucket 名称 </td> <td>   </td> </tr> <tr> <td> objectKey </td> <td> String </td> <td> true </td> <td> 对象 Key </td> <td> 需自行实现策略保证同一 bucket 下 objectKey唯一， 首字符不能为路径符。 </td> </tr> <tr> <td> inputStream </td> <td> InputStream </td> <td> true </td> <td> 待上传的流 </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> putObjectResult  </td> <td> PutObjectResult  </td> <td> PutObjectResult 对象 </td> <td>   </td> </tr> </tbody> </table>   putObject(String bucket, String objectKey, InputStream inputStream, ObjectMetadata metadata) 接口描述 以 InputStream 形式上传对象存储并附带对象元数据，若对象存在则更新，大、小对象上传均适用。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> true </td> <td> 保存对象的 bucket 名称 </td> <td>   </td> </tr> <tr> <td> objectKey </td> <td> String </td> <td> true </td> <td> 对象 Key </td> <td> 需自行实现策略保证同一 bucket 下 objectKey唯一， 首字符不能为路径符。 </td> </tr> <tr> <td> inputStream </td> <td> InputStream </td> <td> true </td> <td> 待上传的流 </td> <td>   </td> </tr> <tr> <td> metadata </td> <td> ObjectMetadata </td> <td> true </td> <td> 自定义元数据 </td> <td> key-value 格式，key 只允许使用小写字母、数字、中横线。建议指定 ContentLength，若不指定，流会被首先全部读取到内存再做上传；建议指定 contentType，若不指定，会赋予默认类型 application/octet-stream。 </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> putObjectResult  </td> <td> PutObjectResult  </td> <td> PutObjectResult 对象 </td> <td>   </td> </tr> </tbody> </table>   （4）批量上传 batchPutObject(String bucket, BatchPutFile[] batchPutFiles) 接口描述 同时上传多个 File 对象到 OBS。该接口是串行，逐一上传，可根据实际情况自行实现并行上传。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> true </td> <td> 保存对象的 bucket 名称 </td> <td>   </td> </tr> <tr> <td> batchPutFiles </td> <td> BatchPutFile[] </td> <td> true </td> <td> 批量上传的文件对象数组 </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> BatchPutObjectResults </td> <td> List<BatchPutObjectResult> </td> <td> 返回结果对象 List，循环该 List 去得到每个文件上传后的结果集。 每个 BatchPutObjectResult 对象中包含该文件上传信息(比如上传是否成功，上传失败原因，文件 MD5 值等)。 </td> <td>   </td> </tr> </tbody> </table>   （5）分片上传 putObjectMultipart(MutilpartUploadFileRequest uploadFileRequest) 接口描述 对于大文件上传，可以切分成片上传。在以下情况下，应该考虑使用分片上传：  文件大于 100M  网络环境差，上传易导致失败  需要支持断点续传 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> uploadFileRequest </td> <td> MutilpartUploadFileRequest </td> <td> true </td> <td> 分片信息设定：每片大小、开启断点续传、开启MD5校验等 </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> </tbody> </table>   abortMultipartUpload(AbortMutilpartUploadRequest abortRequest) 接口描述 取消分片上传。分片上传的接口中，当参数 MutilpartUploadFileRequest 的 enableCheckpoint 被设置成 true 时（默认为true），断点续传功能被开启。断点续传允许重试失败的分片，而不需重传已经成功的分片。分片上传会在客户端的文件系统中创建一个分片记录（.ucp）文件。开启断点续传功能后，上传会读取该文件中的记录，而只传还未完成的分片；若此记录文件不存在，则会创建该记录文件，并从头开始上传文件。由于分片上传的每个片会驻留在 OBS 中，直到所有分片上传完成且执行 complete 操作。未执行 complete 操作的上传，其相关的分片将占用存储资源。用户需要调用取消分片上传的接口来删除这些分片。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> abortRequest </td> <td> AbortMutilpartUploadRequest </td> <td> true </td> <td> 取消分片的信息 </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> </tbody> </table>   （6）文件压缩上传 putAndCompressObject(String bucket, String objectKey, File localFile, ObjectMetadata metadata, CompressMode mode) 接口描述 将File对象进行压缩上传到对象存储，若对象存在则更新。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> true </td> <td> 保存对象的 bucket 名称 </td> <td>   </td> </tr> <tr> <td> objectKey </td> <td> String </td> <td> true </td> <td> 对象 Key </td> <td> 需自行实现策略保证同一 bucket 下 objectKey 唯一, 不能为空，首字符不能为路径符 </td> </tr> <tr> <td> localFile </td> <td> File </td> <td> true </td> <td> 待上传的文件对象 </td> <td> 不能超过 1GB </td> </tr> <tr> <td> metadata </td> <td> ObjectMetadata </td> <td> true </td> <td> 自定义元数据 </td> <td> key-value 格式，key 只允许使用小写字母、数字、中横线 </td> </tr> <tr> <td> mode </td> <td> CompressMode枚举类 </td> <td> true </td> <td> 压缩模式 </td> <td> 支持MS,ML,ZIP,GZP,LZ4,LZO模式 </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> putObjectResult </td> <td> PutObjectResult </td> <td> PutObjectResult对象 </td> <td>   </td> </tr> </tbody> </table>   （7）文件下载 getObject(String bucket, String objectKey) 接口描述 下载指定对象，此方法将占用一个Http连接，在Content读取完毕或显示关闭时释放连接。若仅为了获得对象的描述信息而非内容，请使用headObject接口。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> true </td> <td> 保存对象的 bucket 名称 </td> <td>   </td> </tr> <tr> <td> objectKey </td> <td> String </td> <td> true </td> <td> 对象 Key </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> s3object </td> <td> S3Object </td> <td> 包含对象流的 S3Object 实例，需读取 Content 自行保存 </td> <td>   </td> </tr> </tbody> </table>   getSignedUrl(String bucket, String objectKey) 接口描述 获取对象的已签名的下载 URL，使用默认设置。默认有效时间为 15秒。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> true </td> <td> 保存对象的 bucket 名称 </td> <td>   </td> </tr> <tr> <td> objectKey </td> <td> String </td> <td> true </td> <td> 对象 Key </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> url </td> <td> String </td> <td> 已签名的对象下载 url </td> <td> url 具有默认的有效期，下载文件名为对象 Key </td> </tr> </tbody> </table>   getSignedUrl(String bucket, String objectKey, String contentDisposition) 接口描述 获取对象的已签名的下载 URL，指定返回 contentDisposition 头以告知浏览器如何显示文件，并使用默认的 url 有效期 15 秒。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> true </td> <td> 保存对象的 bucket 名称 </td> <td>   </td> </tr> <tr> <td> objectKey </td> <td> String </td> <td> true </td> <td> 对象 Key </td> <td>   </td> </tr> <tr> <td> contentDisposition </td> <td> String </td> <td> true </td> <td> 在请求url时，期望云存储服务端返回的 content-disposition http头信息 </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> url </td> <td> String </td> <td> 已签名的对象下载 url </td> <td> 已签名的对象下载 url，url 具有默认的有效期。最长 15 min </td> </tr> </tbody> </table>   getSignedUrl(String bucket, String objectKey, String contentDisposition, long expireSeconds) 接口描述 获取对象的已签名的下载URL，指定返回contentDisposition头以告知浏览器如何显示文件，并指定url有效期(秒)。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> true </td> <td> 保存对象的 bucket 名称 </td> <td>   </td> </tr> <tr> <td> objectKey </td> <td> String </td> <td> true </td> <td> 对象 Key </td> <td>   </td> </tr> <tr> <td> contentDisposition </td> <td> String </td> <td> true </td> <td> 在请求url时，期望云存储服务端返回的 content-disposition http头信息 </td> <td>   </td> </tr> <tr> <td> expireSeconds </td> <td> long </td> <td> true </td> <td> url 有效秒数 </td> <td> url 生成后，在此时间段内有效，过期的 url 会被云存储拒绝访问 </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> url </td> <td> String </td> <td> 已签名的对象下载 url </td> <td>   </td> </tr> </tbody> </table>   （8）批量下载 batchGetObject(String bucketName, String[] objectKeys) 接口描述 根据多个文件的 objectKey 同时下载多个文件。该接口是串行，逐一下载，文件数过大或者文件大小过大会导致读取异常，可根据实际情况自行实现并行下载。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 字段名称 </td> <td> 字段类型 </td> <td> 是否必须 </td> <td> 字段描述 </td> <td> 备注 </td> </tr> <tr> <td> bucketName </td> <td> String </td> <td> true </td> <td> 保存对象的 bucket 名称 </td> <td>   </td> </tr> <tr> <td> objectKeys </td> <td> String[] </td> <td> true </td> <td> objectKey 数组 </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 字段名称 </td> <td> 字段类型 </td> <td> 字段描述 </td> <td> 备注 </td> </tr> <tr> <td> batchS3ObjectList </td> <td> List<BatchS3Object> </td> <td> 批量下载完毕后，SDK 将返回结果对象 List，循环该 List 去得到每个文件下载后的对象，该对象中包含所下载文件的文件流，另外还有该文件下载时的信息（比如下载是否成功，下载失败原因，文件 MD5 值等。） </td> <td>   </td> </tr> </tbody> </table>   （9）文件解压下载 getAndUncompressObject(String bucket, String objectKey) 接口描述 解压指定objectKey对象，然后进行下载。访问成功(http状态码200)最终都需释放链接。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> true </td> <td> 保存对象的 bucket 名称 </td> <td>   </td> </tr> <tr> <td> objectKey </td> <td> String </td> <td> true </td> <td> 对象 Key </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 字段名称 </td> <td> 字段类型 </td> <td> 字段描述 </td> <td> 备注 </td> </tr> <tr> <td> s3Object </td> <td> S3Object </td> <td> 包含对象流的 S3Object 实例，需读取 Content 自行保存 </td> <td>   </td> </tr> </tbody> </table>   （10）查询对象列表 listObjects(ListObjectsRequest listObjectsRequest) 接口描述 查询bucket下的对象列表。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> listObjectsRequest </td> <td> ListObjectsRequest </td> <td> true </td> <td> 查询对象参数设定：结果大小、Key起始位置，前缀等 </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 字段名称 </td> <td> 字段类型 </td> <td> 字段描述 </td> <td> 备注 </td> </tr> <tr> <td> objectListing </td> <td> ObjectListing </td> <td> 对象列表 </td> <td>   </td> </tr> </tbody> </table>   （11）获取文件信息 headObject(String bucket, String objectKey) 接口描述 获得对象描述信息以及自定义元数据 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> true </td> <td> 保存对象的 bucket 名称 </td> <td>   </td> </tr> <tr> <td> objectKey </td> <td> String </td> <td> true </td> <td> 对象 Key </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 字段名称 </td> <td> 字段类型 </td> <td> 字段描述 </td> <td> 备注 </td> </tr> <tr> <td> objectMetadata </td> <td> ObjectMetadata </td> <td> 对象元数据 ObjectMetadata </td> <td>   </td> </tr> </tbody> </table>   （12）删除Object deleteObject(String bucketName, String objectKey) 接口描述 删除指定对象 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> true </td> <td> 保存对象的 bucket 名称 </td> <td>   </td> </tr> <tr> <td> objectKey </td> <td> String </td> <td> true </td> <td> 对象 Key </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 字段名称 </td> <td> 字段类型 </td> <td> 字段描述 </td> <td> 备注 </td> </tr> </tbody> </table>   （13）加密上传 客户端加密是指用户数据在发送给远端服务器之前，通过SDK完成加密，而加密所用的密钥由用户方自己保存，从而可以保证用户数据安全和密钥唯一性，即使数据泄漏别人也无法解密得到原始数据。 encryptFile(File file, String keySource) 接口描述 文件加密上传。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> file  </td> <td> File  </td> <td> true </td> <td> 文件对象 </td> <td>   </td> </tr> <tr> <td> keySource </td> <td> String </td> <td> true </td> <td> 加密文件用的密钥 </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 字段名称 </td> <td> 字段类型 </td> <td> 字段描述 </td> <td> 备注 </td> </tr> <tr> <td> inputStream </td> <td> InputStream </td> <td> 文件加密流 </td> <td>   </td> </tr> </tbody> </table>   encryptInputStream(InputStream inputStream, String keySource) 接口描述 流加密上传。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> inputStream </td> <td> InputStream </td> <td> true </td> <td> 文件流 </td> <td>   </td> </tr> <tr> <td> keySource </td> <td> String </td> <td> true </td> <td> 加密文件用的密钥 </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 字段名称 </td> <td> 字段类型 </td> <td> 字段描述 </td> <td> 备注 </td> </tr> <tr> <td> inputStream </td> <td> InputStream </td> <td> 文件加密流 </td> <td>   </td> </tr> </tbody> </table>   （14）解密文件 客户端解密是指用户从OBS服务器获取密文后，在客户端进行数据解密。 decryptFile(File file, String keySource) 接口描述 解密下载为文件 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> file  </td> <td> File  </td> <td> true </td> <td> 本地保存文件对象 </td> <td>   </td> </tr> <tr> <td> keySource </td> <td> String </td> <td> true </td> <td> 加密文件用的密钥 </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 字段名称 </td> <td> 字段类型 </td> <td> 字段描述 </td> <td> 备注 </td> </tr> <tr> <td> inputStream </td> <td> InputStream </td> <td> 文件解密流 </td> <td>   </td> </tr> </tbody> </table>   decryptInputStream(InputStream inputStream, String keySource) 接口描述 解密下载文件流。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> inputStream </td> <td> InputStream </td> <td> true </td> <td> 文件流 </td> <td>   </td> </tr> <tr> <td> keySource </td> <td> String </td> <td> true </td> <td> 加密文件用的密钥 </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 字段名称 </td> <td> 字段类型 </td> <td> 字段描述 </td> <td> 备注 </td> </tr> <tr> <td> inputStream </td> <td> InputStream </td> <td> 文件解密流 </td> <td>   </td> </tr> </tbody> </table>   （15）图片处理 getImageView(String bucket, String objectKey, String mode, int width, int height, String imageFormat) 接口描述 图片格式转换。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> true </td> <td> 保存对象的 bucket 名称 </td> <td>   </td> </tr> <tr> <td> objectKey </td> <td> String </td> <td> true </td> <td> 对象 Key </td> <td>   </td> </tr> <tr> <td> mode </td> <td> String </td> <td> true </td> <td> 缩放方式，有效值 0-5 0: 限定缩略图的长边最多为 ，短边最多为 ，进行等比缩放，不裁剪。如果只指定 w 参数则表示限定长边（短边自适应），只指定 h 参数则表示限定短边（长边自适应）。 1: 限定缩略图的宽最少为 ，高最少为 ，进行等比缩放，居中裁剪。转后的缩略图通常恰好是 x 的大小（有一个边缩放的时候会因为超出矩形框而被裁剪掉多余部分）。如果只指定 w 参数或只指定 h 参数，代表限定为长宽相等的正方图。 2: 限定缩略图的宽最多为 ，高最多为 ，进行等比缩放，不裁剪。如果只指定 w 参数则表示限定宽（长自适应），只指定 h 参数则表示限定长（宽自适应）。它和模式0类似，区别只是限定宽和高，不是限定长边和短边。从应用场景来说，模式0适合移动设备上做缩略图，模式2适合PC上做缩略图。 3: 限定缩略图的宽最少为 ，高最少为 ，进行等比缩放，不裁剪。如果只指定 w 参数或只指定 h 参数，代表长宽限定为同样的值。你可以理解为模式1是模式3的结果再做居中裁剪得到的。 4: 限定缩略图的长边最少为 ，短边最少为 ，进行等比缩放，不裁剪。如果只指定 w 参数或只指定 h 参数，表示长边短边限定为同样的值。这个模式很适合在手持设备做图片的全屏查看（把这里的长边短边分别设为手机屏幕的分辨率即可），生成的图片尺寸刚好充满整个屏幕（某一个边可能会超出屏幕）。 5: 限定缩略图的长边最少为 ，短边最少为 ，进行等比缩放，居中裁剪。如果只指定 w 参数或只指定 h 参数，表示长边短边限定为同样的值。同上模式4，但超出限定的矩形部分会被裁剪。 `width:` </td> <td>   </td> </tr> <tr> <td>   </td> <td>   </td> <td>   </td> <td> 图片宽度，非负数，有效值（0-6000） </td> <td>   </td> </tr> <tr> <td> width </td> <td> Int </td> <td> false </td> <td> 图片高度，非负数，有效值（0-6000) </td> <td>   </td> </tr> <tr> <td> height </td> <td> Int </td> <td> false </td> <td> 图片格式(非必传)，支持jpeg, tiff, gif, bmp, png </td> <td>   </td> </tr> <tr> <td> imageFormat </td> <td> String </td> <td> false </td> <td>   </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 字段名称 </td> <td> 字段类型 </td> <td> 字段描述 </td> <td> 备注 </td> </tr> <tr> <td> s3object </td> <td> S3Object </td> <td> 包含对象流的 S3Object 实例，需读取 Content 自行保存 </td> <td>   </td> </tr> </tbody> </table>   getCutImage(String bucket, String objectKey, int width, int height) 接口描述 图片剪切。根据宽度和高度获取剪切图，先截取图片左边和上边，截取到一定大小后（比较小的时候），会截取四边，保留中间部分，当设定值大于图片实际宽、高时，会根据实际大小裁剪，支持 jpeg, tiff, gif, bmp, emf, exif, wmf, icon, png, memoryBmp, webp。此方法将占用一个 Http 连接，在 Content 读取完毕或显示关闭时释放连接。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> true </td> <td> 保存对象的 bucket 名称 </td> <td>   </td> </tr> <tr> <td> objectKey </td> <td> String </td> <td> true </td> <td> 对象 Key </td> <td>   </td> </tr> <tr> <td> width </td> <td> int </td> <td> true </td> <td> 图片宽度，非负数，有效值（0-6000) </td> <td>   </td> </tr> <tr> <td> height </td> <td> int </td> <td> true </td> <td> 图片高度，非负数，有效值（0-6000) </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 字段名称 </td> <td> 字段类型 </td> <td> 字段描述 </td> <td> 备注 </td> </tr> <tr> <td> s3object </td> <td> S3Object </td> <td> 包含对象流的 S3Object 实例，需读取 Content 自行保存 </td> <td>   </td> </tr> </tbody> </table>   getImageInfo(String bucket, String objectKey) 接口描述 获取指定图片信息。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> true </td> <td> 保存对象的 bucket 名称 </td> <td>   </td> </tr> <tr> <td> objectKey </td> <td> String </td> <td> true </td> <td> 对象 Key </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 字段名称 </td> <td> 字段类型 </td> <td> 字段描述 </td> <td> 备注 </td> </tr> <tr> <td> imageInfoStr </td> <td> InputStream </td> <td> 图片信息，json格式字符串，示例如下： {   "ColorModel": "rgb", //颜色模式   "Format": "jpeg", //图片格式   "FrameNumber": 0, //缩放方式，与 mode 一样   "Height": 1707,   "Width": 963 } </td> <td>   </td> </tr> </tbody> </table>   （16）视频处理 transCodingMedia(String bucket, String objectKey, String format, String notifyURL) 接口描述 媒体转码，此方法将占用一个 Http 连接，在 Content 读取完毕或显示关闭时释放连接。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> true </td> <td> 保存对象的 bucket 名称 </td> <td>   </td> </tr> <tr> <td> objectKey </td> <td> String </td> <td> true </td> <td> 对象 Key </td> <td>   </td> </tr> <tr> <td> format </td> <td> String </td> <td> true </td> <td> 转码后对象的格式 </td> <td>   </td> </tr> <tr> <td> notifyURL </td> <td> String </td> <td> false </td> <td> 转码JOB的通知URL，不生效可忽略 </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 字段名称 </td> <td> 字段类型 </td> <td> 字段描述 </td> <td> 备注 </td> </tr> <tr> <td> s3object </td> <td> S3Object </td> <td> 包含对象流的 S3Object 实例，需读取 Content 自行保存 </td> <td>   </td> </tr> </tbody> </table>   getVedioFrame(String bucket, String objectKey, String format) 接口描述 获取视频截图，此方法将占用一个 Http 连接，在 Content 读取完毕或显示关闭时释放连接。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> true </td> <td> 保存对象的 bucket 名称 </td> <td>   </td> </tr> <tr> <td> objectKey </td> <td> String </td> <td> true </td> <td> 对象 Key </td> <td>   </td> </tr> <tr> <td> format </td> <td> String </td> <td> true </td> <td> 截图的格式、尺寸 </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 字段名称 </td> <td> 字段类型 </td> <td> 字段描述 </td> <td> 备注 </td> </tr> <tr> <td> s3object </td> <td> S3Object </td> <td> 包含对象流的 S3Object 实例，需读取 Content 自行保存 </td> <td>   </td> </tr> </tbody> </table>   getMediaInfo(String bucket, String objectKey) 接口描述 获取媒体信息，此方法将占用一个 Http 连接，在 Content 读取完毕或显示关闭时释放连接。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> true </td> <td> 保存对象的 bucket 名称 </td> <td>   </td> </tr> <tr> <td> objectKey </td> <td> String </td> <td> true </td> <td> 对象 Key </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 字段 名称 </td> <td> 字段 类型 </td> <td> 字段描述 </td> <td> 备注 </td> </tr> <tr> <td> mediaInfoStr </td> <td> String </td> <td> 媒体对象的信息，json格式字符串，示例如下： { "streams": [{ "index": 0, "codec_name": "mjpeg", "codec_long_name": "MJPEG (Motion JPEG)", "codec_type": "video", "codec_time_base": "1/25", "codec_tag_string": "[0][0][0][0]", "codec_tag": "0x0000", "width": 3885, "height": 2764, "has_b_frames": 0, "sample_aspect_ratio": "1:1", "display_aspect_ratio": "3885:2764", "pix_fmt": "yuvj444p", "level": -99, "color_range": "pc", "color_space": "bt470bg", "chroma_location": "center", "refs": 1, "r_frame_rate": "25/1", "avg_frame_rate": "0/0", "time_base": "1/25", "bits_per_raw_sample": "8", "disposition": { "default": 0, "dub": 0, "original": 0, "comment": 0, "lyrics": 0, "karaoke": 0, "forced": 0, "hearing_impaired": 0, "visual_impaired": 0, "clean_effects": 0, "attached_pic": 0 } }], "format": { "filename": "/wls/appsystems/csp-media/data/0b5f036604ea452fbc26810946293644xiaoming-bucket-0009.46a5476297c740239820ed4d64e256a6$002", "nb_streams": 1, "nb_programs": 0, "format_name": "jpeg_pipe", "format_long_name": "piped jpeg sequence", "size": "1659948", "probe_score": 6 } } </td> <td>   </td> </tr> </tbody> </table>   queryMediaByCKs(String bucket, List<String> convertedKeys) 接口描述 获取 media 转码记录，用于查询转码进度。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> true </td> <td> 保存对象的 bucket 名称 </td> <td>   </td> </tr> <tr> <td> convertedKeys </td> <td> List<String> </td> <td> true </td> <td> 转换后新生成的对象Key集合 </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 字段名称 </td> <td> 字段类型 </td> <td> 字段描述 </td> <td> 备注 </td> </tr> <tr> <td> mediaResultStr </td> <td> String  </td> <td> 音视频转码进度信息，json字符串，示例如下： [{ "bucket": "yourBucket", "finishTime": "2017-07-14 13:56:54", "submitTime": "2017-07-14 13:56:53", "startTime": "2017-07-14 13:56:53", "state": "Error", // 状态，用于反应转码进度 "oriObjectKey": "46a5476297c740239820ed4d64e256a6$002", // 原始key "message": "desFile.exists: false", // 失败原因 "convertedKey": "yourConvertedKey " }]   </td> <td>   </td> </tr> </tbody> </table>   （17）图片/音视频持久化处理 pfop(Pfop pfop) 接口描述 图片、音视频异步处理并持久化。 请求参数Pfop <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> sourceType </td> <td> SourceType </td> <td> true </td> <td> 媒体类型 </td> <td>   </td> </tr> <tr> <td> srcBucket </td> <td> String </td> <td> true </td> <td> 源bucket </td> <td>   </td> </tr> <tr> <td> srcKey </td> <td> String </td> <td> true </td> <td> 源key </td> <td>   </td> </tr> <tr> <td> force </td> <td> boolean </td> <td> true </td> <td> 指定当处理后的KEY已经存在于bucket中是否覆盖已经存在的对象。为true时覆盖。 </td> <td>   </td> </tr> <tr> <td> notifyUrl </td> <td> String </td> <td> false </td> <td> 异步处理完成后通知客户的地址。暂不生效，可忽略设定。 </td> <td>   </td> </tr> <tr> <td> ops </td> <td> String </td> <td> true </td> <td> 持久处理操作列表，用 | 分隔，如: avthumb/wma; saveas/ZGRhc2U6cGxhaW50ZXh0LWZyYW1lLTFa|avthumb/mp3; saveas/ZGRhc2U6cGxhaW50ZXh0LWZyYW1lMVU= 是将源视频文件转成wma并以KEY mywma 存储在bucket ddase下；转成mp3并以KEY mymp3 存储在bucket ddase下。 一个持久处理包括处理命令和存储设置，用 ; 分隔。存储设置以saveas/开头，后接按Base64编码后的字符串。若不指定saveas，则会由obs生成一个key并保存在srcBucket下。 </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 字段名称 </td> <td> 字段类型 </td> <td> 字段描述 </td> <td> 备注 </td> </tr> <tr> <td> resultStr </td> <td> String </td> <td> Pfop异步操作流水号JSON，用于查询操作进度。 {"persistentId": "0443351fbb564de38542f8c092d18389fe9f8345f3ca"} </td> <td> 因是异步处理，是否持久化成功需要调用持久化结果查询接口判断。  </td> </tr> </tbody> </table>   prefop(String persistentId) 接口描述 查询pfop操作进度和操作结果。 请求参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必须 </td> <td> 参数描述 </td> <td> 备注 </td> </tr> <tr> <td> persistentId </td> <td> String </td> <td> true </td> <td> 异步处理流水号 </td> <td>   </td> </tr> </tbody> </table> 响应参数 <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 字段 名称 </td> <td> 字段 类型 </td> <td> 字段描述 </td> <td> 备注 </td> </tr> <tr> <td> resultStr </td> <td> String </td> <td> 查询响应为content-type为application/json的字符串，示例如下： { "id":"0f7edf1e508e4620b8784e5ca4dd7554fe9f82ff1b31", "notifyState":"0", "desc":"The fop was completed successfully", "notifyTryTimes":4, "items":[{ "cmd":"convert/900/600/png/75", "desc":"success", "error":"", "hash":"\"b2e18e821063c7713e497dd0c9a6a7e3\"", "code":0, "key":"ZGRhc2U6ZGRhc2VhYzRlZjIyOGQxNDQ0MDRiYmM5ZDYyNzE2ZWU5M2ZhNjA="}, {"cmd":"thumb/0/700/800/png/75", "desc":"success", "error":"", "hash":"\"ab63afa8d90fc944ed437d91d8d10b81\"", "code":0, "key":"ZGRhc2U6ZGRhc2U2YjIyOGQ0MWZjZmQ0NTllOGQ2OTRkYTgzNDJmYjkyYzA="}, {"cmd":"imageslim", "desc":"success", "error":"", "hash":"\"4e3cd2637001ce77d95928a0e961548f\"", "code":0, "key":"ZGRhc2U6ZGRhc2U0MTcwZWQ0NDc4NzU0NzNkYjUwM2Q5NzU2OTUxN2Y5NTA=" }], "inputKey":"1222_1-test", "inputBucket":"ddase", "code":0, "notifyResponseCode":200 } </td> <td>   </td> </tr> </tbody> </table> 查询结果说明： <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 名称 </td> <td> 必填 </td> <td> 描述 </td> </tr> <tr> <td> code </td> <td> 是 </td> <td> 状态码 0：成功，1：正在处理，2：处理成功但PFOP操作列表部分或全部失败，3：处理失败 </td> </tr> <tr> <td> desc </td> <td> 否 </td> <td> 对应code的描述 </td> </tr> <tr> <td> id </td> <td> 是 </td> <td> PFOP持久处理流水号 </td> </tr> <tr> <td> inputBucket </td> <td> 是 </td> <td> 源文件所在bucket </td> </tr> <tr> <td> inputKey </td> <td> 是 </td> <td> 源文件所在key </td> </tr> <tr> <td> items </td> <td> 否 </td> <td> 持久操作列表（仅当code码为0/2时该字段有值），与通知内容中的items一致，请参阅通知内容说明 </td> </tr> <tr> <td> notifyState </td> <td> 否 </td> <td> 通知状态 0：成功，1：等待通知，2：通知失败，3：通知彻底失败并不再尝试通知。为空表示处理还未完成。 </td> </tr> <tr> <td> notifyResponseCode </td> <td> 否 </td> <td> 通知客户端的响应码，当响应为200时被认为通知成功 </td> </tr> <tr> <td> notifyResponseBody </td> <td> 否 </td> <td> 通知响应，当通知失败时为失败相关的信息 </td> </tr> <tr> <td> notifyTryTimes </td> <td> 否 </td> <td> 通知客户端已经尝试的次数 </td> </tr> </tbody> </table>   （18）通用类说明 PutObjectResult <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 描述 </td> </tr> <tr> <td> eTag </td> <td> String </td> <td> 文件MD5值，可用于校验非分片上传的文件完整性。 </td> </tr> <tr> <td> objectKey </td> <td> String </td> <td> 文件Key </td> </tr> <tr> <td> date </td> <td> Date </td> <td> 请求响应时间 </td> </tr> </tbody> </table>   ObjectMetadata <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 描述 </td> </tr> <tr> <td> userMetadata </td> <td> Map </td> <td> 自定义元数据信息，Key为x-amz-meta-自定义名称 </td> </tr> <tr> <td> metadata </td> <td> Map </td> <td> http标准请求Header，如Contentype等 </td> </tr> </tbody> </table>   BatchPutFile <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 描述 </td> </tr> <tr> <td> file </td> <td> File </td> <td> 上传File对象 </td> </tr> <tr> <td> objectKey </td> <td> String </td> <td> 文件Key，唯一身份标识 </td> </tr> <tr> <td> metadata </td> <td> ObjectMetadata </td> <td> 必填。对象全量元数据信息 </td> </tr> </tbody> </table>   BatchPutObjectResult <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 描述 </td> </tr> <tr> <td> successFlag </td> <td> boolean </td> <td> 上传状态。true:成功；false:失败 </td> </tr> <tr> <td> message </td> <td> String </td> <td> 上传失败的错误信息 </td> </tr> <tr> <td> 其它参数 </td> <td>   </td> <td> 参照父类PutObjectResult参数说明 </td> </tr> </tbody> </table>   MutilpartUploadFileRequest <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 描述 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> 桶名称 </td> </tr> <tr> <td> checkpointFile </td> <td> String </td> <td> 断点续传 ucp 临时文件的保存位置。默认是上传文件父目录 </td> </tr> <tr> <td> enableCheckpoint </td> <td> boolean </td> <td> 是否启用断点续传。默认开启 </td> </tr> <tr> <td> enableMD5 </td> <td> boolean </td> <td> 是否启用MD5文件内容校验。默认开启 </td> </tr> <tr> <td> key </td> <td> String </td> <td> 文件Key，唯一身份标识 </td> </tr> <tr> <td> objectMetadata </td> <td> ObjectMetadata </td> <td> 文件元数据信息 </td> </tr> <tr> <td> partSize </td> <td> long </td> <td> 分片大小。默认值5M </td> </tr> <tr> <td> retryTimes </td> <td> int </td> <td> 单片失败重试次数。默认值0,不重试;最大重试次数3 </td> </tr> <tr> <td> uploadFile </td> <td> String </td> <td> 上传文件本地路径 </td> </tr> <tr> <td> uploadNotifier </td> <td> MutilpartUploadNotifier </td> <td> 分片上传监听器，进度通知 </td> </tr> </tbody> </table>   AbortMutilpartUploadRequest <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必填 </td> <td> 描述 </td> </tr> <tr> <td> bucket </td> <td> String </td> <td> 是 </td> <td> 桶名称 </td> </tr> <tr> <td> headers </td> <td> Map </td> <td> 否 </td> <td> 请求头 </td> </tr> <tr> <td> key </td> <td> String </td> <td> 是 </td> <td> 文件Key，唯一身份标识 </td> </tr> <tr> <td> uploadId </td> <td> String </td> <td> 是 </td> <td> 分片ID必须实现 uploadNotifier，在对应通知中获取 uploadId </td> </tr> </tbody> </table>   CompressMode <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 枚举类别 </td> <td> 中文简称 </td> <td> 描述 </td> </tr> <tr> <td> ML </td> <td> 极限模式 </td> <td> 使用FastLZ算法。压缩率：文本10%，位图60% </td> </tr> <tr> <td> MS </td> <td> 极速模式 </td> <td> 使用SNAPPY算法。压缩率：文本15%，位图60% </td> </tr> <tr> <td> ZIP </td> <td> zip模式 </td> <td> 使用JDK自带GZIP算法。其详细信息参照JDK。 </td> </tr> <tr> <td> GZIP </td> <td> GZIP压缩 </td> <td> 使用JDK自带DEFLATE算法。其详细信息参照JDK。 </td> </tr> <tr> <td> LZ4 </td> <td> LZ4模式 </td> <td> 使用LZ77优化后的算法LZ4。压缩率：文本30%，位图不支持 </td> </tr> <tr> <td> LZO </td> <td> LZO模式 </td> <td> LZO 是用 ANSI C语言编写的无损压缩库。适合进行数据的实时压缩解压处理 </td> </tr> </tbody> </table>   S3Object <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 描述 </td> </tr> <tr> <td> bucketName </td> <td> String </td> <td> 桶名称 </td> </tr> <tr> <td> createTimestamp </td> <td> Long </td> <td> S3Object对象创建时间 </td> </tr> <tr> <td> key </td> <td> String </td> <td> 文件Key，唯一身份标识 </td> </tr> <tr> <td> objectContent </td> <td> S3ObjectInputStream </td> <td> 下载文件流。需关闭，否则连接一直处于占用状态 </td> </tr> <tr> <td> objectMetadata </td> <td> ObjectMetadata </td> <td> 对象元数据信息 </td> </tr> <tr> <td> readStarted </td> <td> boolean </td> <td> 下载流是否已开始读 </td> </tr> <tr> <td> statusCode </td> <td> int </td> <td> http状态码。200代表请求成功 </td> </tr> </tbody> </table>   BatchS3Object <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 描述 </td> </tr> <tr> <td> successFlag </td> <td> boolean </td> <td> 单个文件下载是否成功 </td> </tr> <tr> <td> message </td> <td> String </td> <td> 单个文件下载失败错误信息 </td> </tr> <tr> <td> 其它参数 </td> <td>   </td> <td> 请参照父类S3Object的参数说明 </td> </tr> </tbody> </table>   ListObjectsRequest <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 是否必填 </td> <td> 描述 </td> </tr> <tr> <td> bucketName </td> <td> String </td> <td> 是 </td> <td> 桶名称 </td> </tr> <tr> <td> delimiter </td> <td> String </td> <td> 否 </td> <td> 用于对KEY进行分组的分隔符 </td> </tr> <tr> <td> marker </td> <td> String </td> <td> 否 </td> <td> 查询KEY的起始位置（不包括此KEY） </td> </tr> <tr> <td> maxKeys </td> <td> Integer </td> <td> 否 </td> <td> 查询结果最大Key的数量，默认为1000 </td> </tr> <tr> <td> prefix </td> <td> String </td> <td> 否 </td> <td> 查询前缀 </td> </tr> </tbody> </table> ObjectListing <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> 参数名称 </td> <td> 参数类型 </td> <td> 描述 </td> </tr> <tr> <td> bucketName </td> <td> String </td> <td> 桶名称 </td> </tr> <tr> <td> commonPrefixes </td> <td> List </td> <td> Key分组列表。按照prefix/起始位置到delimiter为一组 </td> </tr> <tr> <td> delimiter </td> <td> String </td> <td> 用于对KEY进行分组的字符 </td> </tr> <tr> <td> isTruncated </td> <td> boolean </td> <td> 查询结果是否被截取。若被截取，则表示查询还有下一页 </td> </tr> <tr> <td> marker </td> <td> String </td> <td> 指定查询KEY的起始位置（不包括此KEY） </td> </tr> <tr> <td> maxKeys </td> <td> int </td> <td> 查询结果最大Key的数量，默认为1000 </td> </tr> <tr> <td> nextMarker </td> <td> String </td> <td> 下一页的mark。注意：此字段仅在请求中包含了delimiter参数时才会出现在响应中。否则，应该取响应中的KEY列表（object Summaries）的最后一个元素作为下一页请求的mark参数。 </td> </tr> <tr> <td> objects </td> <td> List<S3Object> </td> <td> 返回的对象基本信息，包括key、元数据信息，不包括对象数据 </td> </tr> <tr> <td> prefix </td> <td> String </td> <td> 查询前缀 </td> </tr> </tbody> </table>

以上内容是否解决了您的问题？是否