拷贝Object

简单拷贝Object

• 基本流程

  1. 创建BosClient。
  2. 执行copyObject( )方法。

• 示例代码

  JavaScript 复制

  1let options = {
  2 'Content-Length': <file.size>, // 添加http header
  3 'Content-Type': 'application/json', // 添加http header
  4 'Cache-Control': 'public, max-age=31536000', // 指定缓存指令
  5 'Content-Disposition': 'attachment; filename="example.jpg"', // 指示回复的内容该以何种形式展示
  6 'x-bce-meta-foo1': 'bar1', // 覆盖自定义meta信息
  7 'x-bce-meta-foo2': 'bar2', // 覆盖自定义meta信息
  8 'x-bce-meta-foo3': 'bar3' // 覆盖自定义meta信息
  9}
  10//SrcBucketName, SrcKey为Bucket/Object，DestBucketName, DestKey为拷贝到的目的Bucket/Object
  11client.copyObject(<SrcBucketName>, <SrcKey>, <DestBucketName>, <DestKey>, options);

同步Copy功能

当前BOS的CopyObject接口是通过同步方式实现的。同步方式下，BOS端会等待Copy实际完成才返回成功。同步Copy能帮助用户更准确的判断Copy状态，但用户感知的复制时间会变长，且复制时间和文件大小成正比。

同步Copy方式更符合业界常规，提升了与其它平台的兼容性。同步Copy方式还简化了BOS服务端的业务逻辑，提高了服务效率。

Object设置meta信息

可以通过拷贝Object的方式设置meta信息。

BOS修改Object的Metadata通过拷贝Object实现。即拷贝Object的时候，把目的Bucket设置为源Bucket，目的Object设置为源Object，并设置新的Metadata，通过拷贝自身实现修改Metadata的目的。如果不设置新的Metadata，则报错。

• 示例代码

  JavaScript 复制

  1let options = {<meta_key>: <meta_value>}
  2
  3// SrcBucketName, SrcKey为Bucket/Object
  4// DestBucketName = SrcBucketName, DestKey = SrcKey 目标与原Bucket/Object相同
  5client.copyObject(<SrcBucketName>, <SrcKey>, <DestBucketName>, <DestKey>, options);

分块拷贝

除了通过CopyObject接?拷贝文件以外，BOS还提供了另外一种拷贝模式——Multipart Upload Copy。用户可以在如下的应用场景内（但不仅限于此），使用Multipart Upload Copy，如：

• 需要支持断点拷贝。
• 拷贝超过5GB大小的文件。
• 网络条件较差，和BOS的服务?之间的连接经常断开。

下面将介绍分步实现三步拷贝。

三步拷贝包含init、“拷贝分块”和complete三步，其中init和complete的操作同分块上传一致。

为了便于理解，下面提供三步拷贝完整代码：

1// 准备
2let options = {
3  'Content-Length': <file.size>, // 添加http header
4  'Content-Type': 'application/json', // 添加http header
5  'Cache-Control': 'public, max-age=31536000', // 指定缓存指令
6  'Content-Disposition': 'attachment; filename="example.jpg"', // 指示回复的内容该以何种形式展示
7
8  'x-bce-meta-foo1': 'bar1', // 添加自定义meta信息
9  'x-bce-meta-foo2': 'bar2', // 添加自定义meta信息
10  'x-bce-meta-foo3': 'bar3' // 添加自定义meta信息
11}; 
12let PART_SIZE = 5 * 1024 * 1024; // 指定分块大小
13
14/** 第一步 init **/
15// SrcBucketName, SrcKey为原Bucket/Object
16// DestBucketName, DestKey为拷贝到的目的Bucket/Object
17client.initiateMultipartUpload(srcBucketName, SrcKey)
18    .then(function(response) {
19        uploadId = response.body.uploadId; // 获取服务器生成的uploadId标识任务
20    })
21   
22
23/** 第二步 分块拷贝 **/
24// 获取文件大小
25let leftSize = 0;
26client.getObjectMetadata(<SrcBucketName>, <SrcKey>).then(response => {
27    leftSize = response.http_headers?.['content-length']
28});
29
30let tasks = [];
31let offset = 0;
32let partNumber = 1;
33
34while (leftSize > 0) {
35    let partSize = Math.min(leftSize, PART_SIZE);
36    tasks.push({
37        file: <SrcKey>,
38        bucketName: <SrcBucketName>,
39        uploadId: uploadId,
40        partNumber: partNumber,
41        partSize: partSize,
42        start: offset,
43        stop: offset + partSize - 1
44    })
45    leftSize -= partSize;
46    offset += partSize;
47    partNumber+=1;
48}
49    let partList = [];
50    Promise.all(tasks.map(async (task, index) => {
51         return client.uploadPartCopy(<SrcBucketName>, <SrcKey>, <DestBucketName>, <DestKey>,uploadId, partNumber, range, <options>).then(response => {
52            // do something
53        })
54    })).then(response => {
55        partList = response
56            .map(res => ({partNumber: res.partNumber, eTag: res.http_headers.eTag}));
57    });
58
59
60/** 第三步 complete **/
61client.completeMultipartUpload(<DestBucketName>, <DestKey>, uploadId, partList)

注意:

1. offset参数以字节为单位，为分块的开始偏移位置。
2. size参数以字节为单位，定义每个分块的大小，除最后一个Part以外，其他的Part大小都要大于 5MB。