七牛---关于JavaScript SDK各种问题总结

来源 http://blog.csdn.net/netdxy/article/details/50507161

很多用户在使用七牛JS SDK(http://developer.qiniu.com/docs/v6/sdk/JavaScript-sdk.html 
)过程中遇到各种问题。

七牛提供基于plupload插件封装上传的demo http://jssdk.demo.qiniu.io/，如果不需要plupload插件可以参考https://github.com/iwillwen/qiniu.js/tree/develop,这里主要针对基于plupload插件的方式讲解遇到的一些问题，通过参考plupload文档资料，可以对七牛的demo进行修改，以满足自己的业务需求，plupload插件的使用文档可以参考http://www.cnblogs.com/2050/p/3913184.html

1.关于上传文件命名问题，可以参考： 
在main.js里面，unique_names是plupload插件下面的一个参数，当值为true时会为每个上传的文件生成一个唯一的文件名，这个是plupload插件自动生成的，如果设置成false，七牛这边是会以上传的原始名进行命名的。 
1).上传的socpe为bucket的形式，unique_names参数设置为false，上传后文件的key是本地的文件名abc.txt 
2).上传的scope为bucket的形式，unique_names参数设置为true，plupload插件会忽略本地文件名，而且这个命名也是没有规律的，上传后文件的key是plupload插件生成的，比如Yc7DZRS1m73o.txt。 
3).上传的scope为bucket:key的形式，上传文件本地的名字需要和scope中的key是一致的，不然会报错key doesn‘t match with scope, 注意，这种形式是不能设置unique_names为true的，因为即使上传文件本地名字为abc.txt,但是plupload会给这个文件赋值另外一个文件名。 
4).上传的scope为bucket，但是token中有设定saveKey，这种形式save_key是应该设置为true，并且上传的本地文件名也是需要和这个savekey文件名一致的。 
5).通过JS前端设置上传的key，在main.js文件里面设置如下：

 'Key': function(up, file) {
             var key = "";
            // do something with key
            return key
            }
1
2
3
4
5
1
2
3
4
5

这个默认是注销的，若想在前端对每个文件的key进行个性化处理，可以配置该函数 
该配置必须要在 unique_names: false , save_key: false 时才生效 
取消注销后，其优先级要高于：qiniu.js文件中getFileKey。

2.设置自定义预览样式

该设置在ui.js 文件里，默认为
var imageView =‘?imageView2/1/w/100/h/100’
可修改成 
var imageView = ‘样式符+样式名’
1
2
3
4
1
2
3
4

3.关于设置取消上传可以参考： 
http://stackoverflow.com/questions/11014384/cancel-file-upload-listener 
(文件plupload.dev.js 1950行 removeFile : function(file) 方法)

4.限制上传文件的类型： 
这里又分为两种方法： 
1).通过在token中设定mimeLimit字段限定上传文件的类型，示例 
“image/*“表示只允许上传图片类型； 
“image/jpeg;image/png”表示只允许上传jpg和png类型的图片； 
“!application/json;text/plain”表示禁止上传json文本和纯文本。（注意最前面的感叹号） 
2).通过plupload中设定filter参数直接在JS前端限定，如下

//可以使用该参数来限制上传文件的类型，大小等，该参数以对象的形式传入，它包括三个属性：
        filters : {
            max_file_size : '100mb',
            prevent_duplicates: true,
            //Specify what files to browse for
             mime_types: [
            {title : "flv files", extensions : "flv"} //限定flv后缀上传格式上传
            {title : "Video files", extensions : "flv,mpg,mpeg,avi,wmv,mov,asf,rm,rmvb,mkv,m4v,mp4"}, //限定flv,mpg,mpeg,avi,wmv,mov,asf,rm,rmvb,mkv,m4v,mp4后缀格式上传
            {title : "Image files", extensions : "jpg,gif,png"}, //限定jpg,gif,png后缀上传
            {title : "Zip files", extensions : "zip"} //限定zip后缀上传
             ]
        },
1
2
3
4
5
6
7
8
9
10
11
12
13
1
2
3
4
5
6
7
8
9
10
11
12
13

5.设置每次只能选择一个文件 
通过plupload插件中的multi_selection参数控制，如下

//设置一次只能选择一个文件
  multi_selection: false,
1
2
1
2

6.设置取消上传，暂停上传 
在index.html中加入者两个控制按钮：

<a class="btn btn-default btn-lg " id="up_load"  href="#" >
     <span>确认上传span>
a>  
<a class="btn btn-default btn-lg " id="stop_load"  href="#" >
     <span>暂停上传span>
a> 
1
2
3
4
5
6
1
2
3
4
5
6

然后在main.js文件里面绑定这两个按钮，添加代码如下：

$('#up_load').on('click', function(){
   uploader.start();
});
$('#stop_load').on('click', function(){
   uploader.stop();
});
1
2
3
4
5
6
1
2
3
4
5
6

7.取消分片上传 
将main.js 里面 chunk_size: ‘4mb’设置chunk_size: ‘0mb’ ，注意分片上传默认也只能是4M，如果设置一个别的分片的大小会出现上传失败。

8.取消自动上传 
将main.js文件auto_start参数改成auto_start: false

9.关于请求token出现跨域 
因为都是建议用户从后端SDK获取token，然后在main.js设置参数uptoken_url: ‘获取uptoken的url’, 这里就有可能出现跨域的现象，此时在服务端添加 response.setHeader(“Access-Control-Allow-Origin”,”*”); 相应头字段即可。

10.上传前对图片进行压缩 
七牛的JS SDK集成的plupload插件本身就带有压缩功能，即即在图片文件还未上传之前就对它进行压缩，具体设置只需要在main.js里面设置resize参数，加上以下代码就可以了：

可以使用resize该参数对将要上传的图片进行压缩，该参数是一个对象，里面包括5个属性：
width：指定压缩后图片的宽度，如果没有设置该属性则默认为原始图片的宽度
height：指定压缩后图片的高度，如果没有设置该属性则默认为原始图片的高度
crop：是否裁剪图片
quality：压缩后图片的质量，只对jpg格式的图片有效，默认为90。quality可以跟width和height一起使用，但也可以单独使用，单独使用时，压缩后图片的宽高不会变化，但由于质量降低了，所以体积也会变小
preserve_headers：压缩后是否保留图片的元数据，true为保留，false为不保留,默认为true。删除图片的元数据能使图片的体积减小一点点

resize参数的配置示例如下：

resize: {
  width: 100,
  height: 100,
  crop: true,
  quality: 60,
  preserve_headers: false
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

10.Android自带的Webview对JS SDK不支持 
在Android自带的Webview里面引用JS SDK的demo(http://jssdk.demo.qiniu.io/) :

public class MainActivity extends Activity {
    private WebView webview;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        webview = (WebView) findViewById(R.id.wv);
        webview.getSettings().setJavaScriptEnabled(true);
        webview.setWebViewClient(new WebViewClient(){
            public boolean shouldOverrideUrlLoading(WebView view, String url){
                view.loadUrl(url); 
                return true;
            }
        });
        webview.loadUrl("http://demos.qiniu.com/demo/simpleuploader/");
    }

}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

但是点击选择文件按钮没有反应，这个是Webview对JS不是很支持造成的，解决方法可以引入这个Webview,jar包地址如下: 
https://github.com/delight-im/Android-AdvancedWebView/blob/master/JARs/Android-AdvancedWebView.jar 
使用的方法文档上都有写，比较简单：

private AdvancedWebView mWebView;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        mWebView = (AdvancedWebView) findViewById(R.id.webview);
        mWebView.setListener(this, this);
        mWebView.loadUrl("http://jssdk.demo.qiniu.io/");
    }
1
2
3
4
5
6
7
8
9
10
1
2
3
4
5
6
7
8
9
10

11.关于多个按钮选择文件的Demo 
很多用户都在问JSSDK多文件选择的Demo，其实比较简单，只需要在main.js文件里面多new几个Uploader对象就可以了，然后在主页面上里面写好对应的上传的按钮就可以了，可以参考这个Demo: http://115.231.183.78/JavaScript/views/index.html

这里直接给出main.js和indxe.html里面需要改动的地方: 
main.js里面多new几个uploader对象

$(function() {
    var uploader = Qiniu.uploader({
        runtimes: 'html5,flash,html4',
        browse_button: 'pickfiles',
        container: 'container',
        drop_element: 'container',
        max_file_size: '100mb',
        flash_swf_url: 'js/plupload/Moxie.swf',
        dragdrop: true,
        chunk_size: '4mb',
        uptoken:'um6IEH7mtwnwkGpjImD08JdxlvViuELhI4mFfoeL:79ApUIePTtKIdVGDHJ9D9BfBnhE=:eyJzY29wZSI6ImphdmFkZW1vIiwiZGVhZGxpbmUiOjE0NTk4ODMyMzV9Cg==',
        // uptoken_url: $('#uptoken_url').val(),  //当然建议这种通过url的方式获取token
        domain: $('#domain').val(),
        auto_start: false,
        init: {
            'FilesAdded': function(up, files) {
                $('table').show();
                $('#success').hide();
                plupload.each(files, function(file) {
                    var progress = new FileProgress(file, 'fsUploadProgress');
                    progress.setStatus("等待...");
                });
            },
            'BeforeUpload': function(up, file) {
                var progress = new FileProgress(file, 'fsUploadProgress');
                var chunk_size = plupload.parseSize(this.getOption('chunk_size'));
                if (up.runtime === 'html5' && chunk_size) {
                    progress.setChunkProgess(chunk_size);
                }
            },
            'UploadProgress': function(up, file) {
                var progress = new FileProgress(file, 'fsUploadProgress');
                var chunk_size = plupload.parseSize(this.getOption('chunk_size'));

                progress.setProgress(file.percent + "%", file.speed, chunk_size);
            },
            'UploadComplete': function() {
                $('#success').show();
            },
            'FileUploaded': function(up, file, info) {
                var progress = new FileProgress(file, 'fsUploadProgress');
                progress.setComplete(up, info);
            },
            'Error': function(up, err, errTip) {
                $('table').show();
                var progress = new FileProgress(err.file, 'fsUploadProgress');
                progress.setError();
                progress.setStatus(errTip);
            }
        }
    });

    uploader.bind('FileUploaded', function() {
        console.log('hello man,a file is uploaded');
    });

    $('#up_load').on('click', function(){
        uploader.start();
    });
    $('#stop_load').on('click', function(){
        uploader.stop();
    });

    var Q2 = new QiniuJsSDK();
    var uploader2 = Q2.uploader({
        runtimes: 'html5,flash,html4',
        browse_button: 'pickfiles2',
        container: 'container2',
        drop_element: 'container2',
        max_file_size: '100mb',
        flash_swf_url: 'js/plupload/Moxie.swf',
        dragdrop: true,
        chunk_size: '4mb',
        uptoken:'um6IEH7mtwnwkGpjImD08JdxlvViuELhI4mFfoeL:79ApUIePTtKIdVGDHJ9D9BfBnhE=:eyJzY29wZSI6ImphdmFkZW1vIiwiZGVhZGxpbmUiOjE0NTk4ODMyMzV9Cg==',
        // uptoken_url: $('#uptoken_url').val(),  //当然建议这种通过url的方式获取token
        domain: $('#domain').val(),
        auto_start: false,
        init: {
            'FilesAdded': function(up, files) {
                $('table').show();
                $('#success').hide();
                plupload.each(files, function(file) {
                    var progress = new FileProgress(file, 'fsUploadProgress');
                    progress.setStatus("等待...");
                });
            },
            'BeforeUpload': function(up, file) {
                var progress = new FileProgress(file, 'fsUploadProgress');
                var chunk_size = plupload.parseSize(this.getOption('chunk_size'));
                if (up.runtime === 'html5' && chunk_size) {
                    progress.setChunkProgess(chunk_size);
                }
            },
            'UploadProgress': function(up, file) {
                var progress = new FileProgress(file, 'fsUploadProgress');
                var chunk_size = plupload.parseSize(this.getOption('chunk_size'));

                progress.setProgress(file.percent + "%", file.speed, chunk_size);
            },
            'UploadComplete': function() {
                $('#success').show();
            },
            'FileUploaded': function(up, file, info) {
                var progress = new FileProgress(file, 'fsUploadProgress');
                progress.setComplete(up, info);
            },
            'Error': function(up, err, errTip) {
                $('table').show();
                var progress = new FileProgress(err.file, 'fsUploadProgress');
                progress.setError();
                progress.setStatus(errTip);
            }
        }
    });

    uploader2.bind('FileUploaded', function() {
        console.log('hello man 2,a file is uploaded');
    });
    $('#up_load2').on('click', function(){
        uploader2.start();
    });
    $('#stop_load2').on('click', function(){
        uploader2.stop();
    });
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

相应的index.html文件加入相关按钮:

<div id="container">
        <a class="btn btn-default btn-lg " id="pickfiles" style="width:160px" href="#" >
            <i class="glyphicon glyphicon-plus">i>
            <span>选择文件span>
        a>

        <a class="btn btn-default btn-lg " id="up_load" style="width:160px" href="#" >
            <span>确认上传span>
        a>  

        <a class="btn btn-default btn-lg " id="stop_load" style="width:160px" href="#" >
            <span>暂停上传span>
        a> 
    div>

<div id="container2">
        <a class="btn btn-default btn-lg " id="pickfiles2" style="width:160px" href="#" >
            <i class="glyphicon glyphicon-plus">i>
            <span>选择文件span>
        a>

        <a class="btn btn-default btn-lg " id="up_load2" style="width:160px" href="#" >
            <span>确认上传span>
        a>  

        <a class="btn btn-default btn-lg " id="stop_load2" style="width:160px" href="#" >
            <span>暂停上传span>
        a> 
    div>
div>