图片持久化处理

最近更新时间:2024-07-15 14:57:01

我的收藏

简介

本文档提供关于图片持久化处理的 API 概览以及 SDK 示例代码。
注意:
COS Node.js SDK 版本需要大于等于 v2.12.6。
API
说明
对象存储(Cloud Object Storage,COS)提供的上传时处理功能可以帮助使用者在上传时实现图片处理。此外能够对已存储在 COS 的图片进行相应处理操作,并将结果存入到 COS

上传时使用图片处理

下面示例展示了如何在上传图片时自动实现图片处理。
图片上传完成后,COS 会存储原始图片和已处理过的图片。后续用户可以通过普通的下载请求获取处理结果。

示例代码

function handleFileInUploading(file) {
// sdk的引入及初始化cos请参考 https://cloud.tencent.com/document/product/436/8629
const filePath = "temp-file-to-upload" // 本地文件路径
cos.putObject(
{
Bucket: 'examplebucket-1250000000', // Bucket 格式:test-1250000000,必填
Region: 'COS_REGION', // Bucket所在地域,比如ap-beijing,必填
Key: file.name, // 存储在桶里的对象键(例如1.jpg,a/b/test.txt),必填
Body: fs.createReadStream(filePath), // 上传文件对象,必填
ContentLength: fs.statSync(filePath).size, // 上传文件对象大小,当上传Body为文件流且需要正确展示上传进度时必填
Headers: {
// 通过 imageMogr2 接口使用图片缩放功能:指定图片宽度为 200,宽度等比压缩
'Pic-Operations': JSON.stringify({
is_pic_info: 1, // 固定值
// fileid 设置和Key相同可实现上传后只保留处理后的图片而不保留原图
// fileid 如果设置中文,需要经过URLEncode,比如 fileid: encodeURIComponent('图片.jpg')
rules: [{ fileid: "desample_photo.jpg", rule: "imageMogr2/thumbnail/200x/" }],
}),
},
},
function (err, data) {
console.log(err || data);
},
);
}

对云上数据进行图片处理

下面示例展示了如何对已存储在 COS 的图片进行相应处理操作,并将结果存入到 COS。

示例代码

function handleFileInBucket() {
// sdk的引入及初始化cos请参考 https://cloud.tencent.com/document/product/436/8629
cos.request(
{
Bucket: 'examplebucket-1250000000', // Bucket 格式:test-1250000000,必填
Region: 'COS_REGION', // Bucket所在地域,比如ap-beijing,必填
Key: '1.png', // 存储在桶里的对象键(例如1.jpg,a/b/test.txt),必填
Method: 'POST', // 固定值
Action: 'image_process', // 固定值
Headers: {
// 通过 imageMogr2 接口使用图片缩放功能:指定图片宽度为 200,宽度等比压缩
'Pic-Operations': JSON.stringify({
is_pic_info: 1,
// fileid 设置和Key相同可实现只保留处理后的图片而不保留原图
// fileid 如果设置中文,需要经过URLEncode,比如 fileid: encodeURIComponent('图片.jpg')
rules: [{ fileid: "desample_photo.jpg", rule: "imageMogr2/thumbnail/200x/" }],
}),
},
},
function (err, data) {
console.log(err || data);
},
);
}

下载时使用图片处理

下面示例展示了如何在下载图片时实现图片处理。

示例代码

function getObject() {
// sdk的引入及初始化cos请参考 https://cloud.tencent.com/document/product/436/8629
cos.getObject(
{
Bucket: 'examplebucket-1250000000', // Bucket 格式:test-1250000000,必填
Region: 'COS_REGION', // Bucket所在地域,比如ap-beijing,必填
Key: '1.png', // 存储在桶里的对象键(例如1.jpg,a/b/test.txt),必填
Query: {
// 通过 imageMogr2 接口使用图片缩放功能:指定图片宽度为 200,宽度等比压缩
'imageMogr2/thumbnail/200x/': '',
}
},
function (err, data) {
// 获取到文件内容
console.log(err || data);
if (data) {
const localPath = 'xxx'; // 填写要写入的本地文件路径
fs.writeFileSync(localPath, data.Body); // 将图片内容保存本地路径
}
},
);
}

生成带图片处理参数的签名 URL

下面示例展示了如何生成带图片处理参数的图片 url,一般使用这种 url 在浏览器里下载文件。

示例代码

// sdk的引入及初始化cos请参考 https://cloud.tencent.com/document/product/436/8629

// 生成带图片处理参数的文件 URL,带签名。
cos.getObjectUrl(
{
Bucket: 'examplebucket-1250000000', // Bucket 格式:test-1250000000,必填
Region: 'COS_REGION', // Bucket所在地域,比如ap-beijing,必填
Key: 'exampleobject', // 存储在桶里的对象键(例如1.jpg,a/b/test.txt),必填
Query: {
// 通过 imageMogr2 接口使用图片缩放功能:指定图片宽度为 200,宽度等比压缩
'imageMogr2/thumbnail/200x/': ''
},
Sign: true, // url是否带签名,私有读必须带签名才可访问
},
function (err, data) {
if (data) {
// 使用浏览器打开url预览或触发浏览器下载
console.log(data.Url);
}
},
);

// 生成带图片处理参数的文件 URL,不带签名。
cos.getObjectUrl(
{
Bucket: 'examplebucket-1250000000', // Bucket 格式:test-1250000000,必填
Region: 'COS_REGION', // Bucket所在地域,比如ap-beijing,必填
Key: 'exampleobject', // 存储在桶里的对象键(例如1.jpg,a/b/test.txt),必填
Query: {
// 通过 imageMogr2 接口使用图片缩放功能:指定图片宽度为 200,宽度等比压缩
'imageMogr2/thumbnail/200x/': ''
},
Sign: false, // url是否带签名,公有读可以不带签名访问
},
function (err, data) {
if (data) {
// 使用浏览器打开 url 预览或触发浏览器下载
console.log(data.Url);
}
},
);