上传回调处理
描述
上传回调处理(Upload CallBack Processing,ucp)通过在调用Put Object,Complete Multipart Upload时,代替客户端执行Commit提交操作。 客户端可以将一些上传信息包含在CNPutObjectRequest(单块)或CNCompleteMultipartUploadRequest(多块)中,从而可以在上传成功后一并返回给用户服务器端。用户服务端正确处理回调后返回{"result":true},如果回调处理错误返回{"result":false},默认的超时时间设置为3秒,重试两次。后端会通过POST方法向用户的回调地址POST一段json数据。
调用方法
Map<String, String> haders = new HashMap<>();
request.setCallBack("callbackUrl","callbackBody",haders);
参数说明
| 名称 | 描述 | 必需 |
|---|---|---|
| callbackurl | 支持http | 是 |
| callbackbody | 回调参数支持自定义参数返回、常量和魔法变量,自定义变量通过Head传回,例如objectKey=${key}&etag=${etag}&location=${kss-location} &uid=123 | 是 |
| haders | 自定义头以kss-开始 | 否 |
魔法变量
| 参数 | 说明 | 备注 |
|---|---|---|
| bucket | 文件上传的Bucket | Utf-8编码 |
| key | 文件的名称 | Utf-8编码 |
| etag | 文件Md5值经过base64处理 | |
| objectSize | 文件大小 | 以字节标识 |
| mimeType | 文件类型 | |
| createTime | 文件创建时间 | Unix时间戳表示,1420629372,精确到秒 |