本文介绍如何将文件流、网络流等数据流以流式上传的方式上传到存储空间(Bucket)中的文件(Object)。
上传文件流
以下代码用于将文件流上传到目标存储空间examplebucket中exampledir目录下的exampleobject.txt文件。
const OSS = require('ali-oss');
const fs = require('fs');
const client = new OSS({
// yourRegion填写Bucket所在地域。以华东1(杭州)为例,Region填写为oss-cn-hangzhou。
region: 'yourRegion',
// 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
accessKeyId: process.env.OSS_ACCESS_KEY_ID,
accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
authorizationV4: true,
// 填写Bucket名称,例如examplebucket。
bucket: 'examplebucket',
});
async function putStream () {
try {
// 使用chunked encoding。使用putStream接口时,SDK默认会发起一个chunked encoding的HTTP PUT请求。
// 填写本地文件的完整路径,从本地文件中读取数据流。
// 如果本地文件的完整路径中未指定本地路径,则默认从示例程序所属项目对应本地路径中上传文件。
let stream = fs.createReadStream('D:\\localpath\\examplefile.txt');
// 填写Object完整路径,例如exampledir/exampleobject.txt。Object完整路径中不能包含Bucket名称。
let result = await client.putStream('exampledir/exampleobject.txt', stream);
// 不使用chunked encoding。如果在options指定了contentLength参数,则不会使用chunked encoding。
// let stream = fs.createReadStream('D:\\localpath\\examplefile.txt');
// let size = fs.statSync('D:\\localpath\\examplefile.txt').size;
// let result = await client.putStream(
// stream参数可以是任何实现了Readable Stream的对象,包含文件流,网络流等。
// 'exampledir/exampleobject.txt', stream, {contentLength: size});
console.log(result);
} catch (e) {
console.log(e)
}
}
putStream();
上传网络流
以下代码用于将网络流上传到目标存储空间examplebucket中exampledir目录下的exampleobject.txt文件。
const OSS = require("ali-oss");
const fs = require("fs");
const urllib = require("urllib");
const client = new OSS({
// yourRegion填写Bucket所在地域。以华东1(杭州)为例,Region填写为oss-cn-hangzhou。
region: 'yourRegion',
// 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
accessKeyId: process.env.OSS_ACCESS_KEY_ID,
accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
authorizationV4: true,
// 填写Bucket名称,例如examplebucket。
bucket: 'examplebucket',
});
// 指定网络流URL。
const url = "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20220908/cbgh/图片处理_example.jpg";
// 导入双工流。
// stream参数可以是任何实现了Readable Stream的对象,包含文件流,网络流等。
const Duplex = require("stream").Duplex;
// 实例化双工流。
let stream = new Duplex();
urllib.request(url, (err, data, res) => {
if (!err) {
// 通过双工流接收数据。
stream.push(data);
stream.push(null);
client
// 填写Object完整路径,例如example.png。Object完整路径中不能包含Bucket名称。
.putStream("example.png", stream)
.then((r) => console.log(r))
.catch((e) => console.log(e));
}
});
相关文档
关于流式上传的完整示例代码,请参见GitHub示例。