学习笔记:利用七牛云上传图片小结

目的

类似朋友圈发图,选择图片上传并展示出来

引入外部文件

从浏览器端上传文件至七牛云,并对上传成功后的图片进行数据处理操作。

  • 引入Plupload *
    该SDK上传功能集于Plupload插件封装,所以需要下载Plupload; plupload.dev.js

  • 引入qiniu.js
    为了简便,当时直接从官网示例中复制的js文件

  • 引入moxie.js
    因为Plupload插件除了能解决h5的上传问题,还能上传flash等,所以需要该文件。本来我们是不需要的,但由于plupload.dev.js和qiniu.js里面有依赖于moxie.js的代码,如果不引入,就一直报错:moxie not defined,挺头疼的,索性一并引入了

因为互相依赖,所以引入的顺序也很重要,先是moxie.js => plupload.dev.js => qiniu.js => index.js

上传

环境搭好了,在index.js中进行初始化

var uploader = Qiniu.uploader({
    runtimes: 'html5,flash,html4',      // 上传模式,依次退化
    browse_button: 'pickfiles',         // 上传选择的点选按钮ID,必需
    // 在初始化时,uptoken,uptoken_url,uptoken_func三个参数中必须有一个被设置
    // 且如果提供了多个,其优先级为uptoken > uptoken_url > uptoken_func
    // 其中uptoken是直接提供上传凭证,uptoken_url是提供了获取上传凭证的地址,如果需要定制获取uptoken的过程则可以设置uptoken_func
    // uptoken : '<Your upload token>', // uptoken是上传凭证,由其他程序生成
    // uptoken_url: '/uptoken',         // Ajax请求uptoken的Url,强烈建议设置(服务端提供)
    // uptoken_func: function(file){    // 在需要获取uptoken时,该方法会被调用
    //    // do something
    //    return uptoken;
    // },
    get_new_uptoken: false,             // 设置上传文件的时候是否每次都重新获取新的uptoken
    // downtoken_url: '/downtoken',
    // Ajax请求downToken的Url,私有空间时使用,JS-SDK将向该地址POST文件的key和domain,服务端返回的JSON必须包含url字段,url值为该文件的下载地址
    // unique_names: true,              // 默认false,key为文件名。若开启该选项,JS-SDK会为每个文件自动生成key(文件名)
    // save_key: true,                  // 默认false。若在服务端生成uptoken的上传策略中指定了sava_key,则开启,SDK在前端将不对key进行任何处理
    domain: '<Your bucket domain>',     // bucket域名,下载资源时用到,必需
    container: 'container',             // 上传区域DOM ID,默认是browser_button的父元素
    max_file_size: '100mb',             // 最大文件体积限制
    flash_swf_url: 'path/of/plupload/Moxie.swf',  //引入flash,相对路径
    max_retries: 3,                     // 上传失败最大重试次数
    dragdrop: true,                     // 开启可拖曳上传
    drop_element: 'container',          // 拖曳上传区域元素的ID,拖曳文件或文件夹后可触发上传
    chunk_size: '4mb',                  // 分块上传时,每块的体积
    auto_start: true,                   // 选择文件后自动上传,若关闭需要自己绑定事件触发上传
    //x_vars : {
    //    查看自定义变量
    //    'time' : function(up,file) {
    //        var time = (new Date()).getTime();
          // do something with 'time'
    //        return time;
    //    },
    //    'size' : function(up,file) {
    //        var size = file.size;
          // do something with 'size'
    //        return size;
    //    }
    //},
    init: {
        'FilesAdded': function(up, files) {
            plupload.each(files, function(file) {
                // 文件添加进队列后,处理相关的事情
            });
        },
        'BeforeUpload': function(up, file) {
               // 每个文件上传前,处理相关的事情
        },
        'UploadProgress': function(up, file) {
               // 每个文件上传时,处理相关的事情
        },
        'FileUploaded': function(up, file, info) {
               // 每个文件上传成功后,处理相关的事情
               // 其中info是文件上传成功后,服务端返回的json,形式如:
               // {
               //    "hash": "Fh8xVqod2MQ1mocfI4S4KpRL6D98",
               //    "key": "gogopher.jpg"
               //  }
               // 查看简单反馈
               // var domain = up.getOption('domain');
               // var res = parseJSON(info);
               // var sourceLink = domain +"/"+ res.key; 获取上传成功后的文件的Url
        },
        'Error': function(up, err, errTip) {
               //上传出错时,处理相关的事情
        },
        'UploadComplete': function() {
               //队列文件处理完毕后,处理相关的事情
        },
        'Key': function(up, file) {
            // 若想在前端对每个文件的key进行个性化处理,可以配置该函数
            // 该配置必须要在unique_names: false,save_key: false时才生效

            var key = "";
            // do something with key here
            return key
        }
    }
});

// domain为七牛空间对应的域名,选择某个空间后,可通过 空间设置->基本设置->域名设置 查看获取

// uploader为一个plupload对象,继承了所有plupload的方法

这样基本没什么问题了。如果要限制上传文件的格式,可以添加属性filter

filter: {
      mime_types : [
        { title : "Image files", extensions : "jpg,gif,png"}
      ],
      max_file_size: "200mb",
      prevent_duplicates: true
}

后来要限制上传的图片张数不超过九张,如果超过就提示。这样,auto_start设置了true就不太好了,改成false,手动上传。在FilesAdded方法中判断队列中的文件个数,如果没有超过,就调用uploader.start()就接着上传了。

遇到的乌龙

  • 文件的引入问题

  • domain获取错误,结果图片的url错误,找不到

  • 设置了自动上传,结果一点上传,一股脑就执行完了一连串的步骤

总结

多看文档,多比较人家的实例

阅读 5.4k

推荐阅读
learnnnnnnnnnning
用户专栏

前端的学习笔记,略乱

8 人关注
37 篇文章
专栏主页