在前端开发中文件上传是经常会遇到的，并且多数情况会使用第三方平台来存储文件，腾讯云cos是我们常用的。本篇文章就是带我从前端的角度实现腾讯云COS存储。本文参考了腾讯云COS开发文档 JavaScript SDK
步骤
安装腾讯云COS上传所需的sdk
下载cos-js-sdk-v5.min.js并引入index.html
监听文件上传组件
//监听文件变化 document.getElementById('file').onchange = function() { let file = this.files[0]; let type = file.type //初始化文件上传 initUploadObj(that, file.name, file, 'image', function(res) { if (res.success) { that.$message.success(res.msg) } else { that.$message.warning(res.msg) } }) }
初始化文件上传对象（封装起来其他地方上传也可以用）
/** * 初始化上传文件对象 * @param {object} Vue * @param {string} fileName 文件名 * @param {object} file 上传的文件流及文件类型 名称相关信息 * @param {Array} 允许上传的文件类型 * @param {function} uploadStatusCallbalck * @return {function} 返回回调函数 */ export const initUploadObj = function (Vue,fileName,file,type,uploadStatusCallbalck) { let fileInfo = { file_name: fileName, media_type: 2, media_sub_type: 0, size_of_bytes: 122, file_expired_type: 'permanent', }; //前端做文件类型限制 if(type == 'image'){ type = ['.jpg','.gif','.jpeg','.bmp','.png'] } if(type == 'excel'){ type = ['.xlsx'] } let fileType =file.name ? file.name.substring(file.name.lastIndexOf(".")).toLowerCase() : ''; if (!!type && type.indexOf (fileType) < 0) { uploadStatusCallbalck ({success: false, msg: '请上传正确的'+type+'文件格式!'}); return; } var cos = new COS ({ getAuthorization: function (options, callback) { let singleInfo = Vue.$store.state.fileToken; callback ({ TmpSecretId: singleInfo.tmpSecretId, TmpSecretKey: singleInfo.tmpSecretKey, XCosSecurityToken: singleInfo.sessionToken, ExpiredTime: singleInfo.expiredTime, }); }, }); fileInfo.file_name = file.name; //获取文件上传密钥 getFileToken (Vue, fileInfo, cos, file, uploadStatusCallbalck); };
获取文件上传密钥（最好存在后端通过ajax请求获取，安全性较高）
function getFileToken (Vue, fileInfo, cos, file, uploadStatusCallbalck) { let url = process.env.VUE_APP_URL + '/file/secretid'; if (!file) return; // 异步获取临时密钥 axios .get (url) .then (function (res) { if (res.data.code == 100000) { //获取的临时秘钥存储在vuex中 Vue.$store.commit ('UPDATE_FILE_INFO', res.data.data); uploadFile (cos, file, res.data.data, uploadStatusCallbalck); } else { uploadStatusCallbalck ({success: false, msg: '获取文件秘钥失败!'}); } }) .catch (function (err) { uploadStatusCallbalck ({success: false, msg: '获取文件秘钥接口出错!'}); }); }
上传文件(调用相关api putObject来上传文件)
/** * @method uploadFile * @param {object} cos */ function uploadFile (cos, file, signInfo, callback) { cos.putObject ( { Bucket: process.env.VUE_APP_BUCKET, Region: 'ap-shanghai', Key: signInfo.fileId, Body: file, onHashProgress: function (progressData) { console.log ('校验中', JSON.stringify (progressData)); }, onProgress: function (progressData) { console.log ('上传中', JSON.stringify (progressData)); }, }, function (err, data) { if (err) { console.log (err); callback ({success: false, msg: '文件上传失败!'}); return; } callback ({success: true, msg: '上传成功!', data: data, signInfo: signInfo}); } ); }
总结
腾讯云cos文件上传实际是分为三步，本地表单处理文件流 => 根据文档获取相关参数 => 上传文件。
第一步主要前端上传功能的处理，可以用来限制文件上传大小（不太准确，根据文件的字节流长度），文件上传类型（根据文件后缀名）。
第二步的参数多数都是可以在cos账号后台拿到的。这块参数最好还是存储在后台比较安全。