Dropzone使用总结

前几天,公司后台接手做了一下啊,其中有项功能是需要上传图片等数据。在此使用了dropzone框架,现来总结一下使用该框架和在使用过程中所遇到的问题。

先放上dropzone官网,http://www.dropzonejs.com/。官网对各API和各种处理也比较详细,这里就仅写一下在我的项目中所呈现的内容和注意的点吧。

在我的项目中,使用的是类似官网demo的例子

在项目中的需求是,需要用户拖曳图片或通过文件夹选取图片,支持预览,每次最多只能上传3张图片,每张图片大小不允许超过2MB。Ok,发现dropzone都能很容易的实现这些需求和功能。废话不多说,代码展示:

1、首先引入dropzone,在官网可下载,同时在页面中引入dropzone样式和js文件

2、在html页面中,没有过多的要求,也没有进行什么修改,直接使用dropzone样式即可

3、ok,前面的准备工作就做好了。接下来,进行初始化我们的dropzone控件

Dropzone.autoDiscover = false;

var dropz = new Dropzone('div.dropzone',{

url : '../../xxx',

autoProcessQueue : false,// 如果为false,文件将被添加到队列中,但不会自动处理队列。

uploadMultiple : true, // 是否在一个请求中发送多个文件。

parallelUploads : 3, // 并行处理多少个文件上传

maxFiles : 3, // 用于限制此Dropzone将处理的最大文件数

maxFilesize : 2,

acceptedFiles: ".jpg,.gif,.png",

dictDefaultMessage:"拖拉图片文件到这里或者点击",

dictFallbackMessage:"你的浏览器不支持拖拉文件来上传",

dictMaxFilesExceeded:"文件数量过多",

dictFileTooBig:"可添加的最大文件大小为{{maxFilesize}}Mb,当前文件大小为{{filesize}}Mb ",

init : function() { // dropzone初始化时调用您可以在此处添加事件侦听器

var myDropzone = this;

this.on("addedfile",function(file) {

var removeButton = Dropzone.createElement("");

removeButton.addEventListener("click",function(e) {

e.preventDefault();

e.stopPropagation();

myDropzone.removeFile(file);

});

file.previewElement.appendChild(removeButton);

});

},

sendingmultiple : function(file, xhr, formData) {// 在每个文件发送之前调用。获取xhr对象和formData对象作为第二和第三个参数,可以修改它们(例如添加CSRF令牌)或添加其他数据。

$.each(submitParams,function(key,value){

formData.set(key,value);

});

},

successmultiple : function(file, response){// 该文件已成功上传。获取服务器响应作为第二个参数。

},

completemultiple : function(file,data){

},)};

解析:init就是我们初始化的代码了,在初始化中,加入添加文件时间侦听器,可在增加文件时处理一些界面或者数据的手机。在此,即为增加的图片添加了个移除按钮,该按钮点击触发myDropzone.removeFile(file事件,则可实现在页面上添加移除等操作了。

url : '../../xxx', 该配置项必须在form之外的元素配置,还可以提供一个将被调用files并且必须返回url 的函数。该配置项连接了后台上传的地址,则后台可接收处理dropzone发送过来的数据。

autoProcessQueue : false,// 如果为false,文件将被添加到队列中,但不会自动处理队列

uploadMultiple : true, // 是否在一个请求中发送多个文件。

parallelUploads : 3, // 并行处理多少个文件上传

以上三项配置,可处理dropzone同时请求上传多个文件,在项目中,需求是3个,则parallelUploads设置为3。

maxFiles : 3, // 用于限制此Dropzone将处理的最大文件数

maxFilesize : 2,

acceptedFiles: ".jpg,.gif,.png",

dictDefaultMessage:"拖拉图片文件到这里或者点击",

dictFallbackMessage:"你的浏览器不支持拖拉文件来上传",

dictMaxFilesExceeded:"文件数量过多",

dictFileTooBig:"可添加的最大文件大小为{{maxFilesize}}Mb,当前文件大小为{{filesize}}Mb ",

以上配置即根据需求所配置,各取所需,在官网中可查找更多的配置选项满足需求更改。

上传:

sendingmultiple : function(file, xhr, formData) {// 在每个文件发送之前调用。获取xhr对象和formData对象作为第二和第三个参数,可以修改它们(例如添加CSRF令牌)或添加其他数据。

$.each(submitParams,function(key,value){

formData.set(key,value);

});

},

由于autoProcessQueue配置为false,故需手动处理队列,在点击提交按钮时,触发dropz.processQueue();则可上传。在sendingmultiple中,可加入自己需要传入的参数,在这通过formData传入一些需要传入的参数,在后台通过request.getParameterMap();接收即可。

后台处理代码:

@RequestMapping(value = "/xxx", method = RequestMethod.POST)

public ResponseEntity playerAccountManager(MultipartHttpServletRequest request) {

InputStream is = null;

Map res = new HashMap();

try {

Iterator itr = request.getFileNames();

Map requestParams = request.getParameterMap();

Map params = new HashMap();

for (Entry entry : requestParams.entrySet()) {

params.put(entry.getKey(), entry.getValue()[0]);

}

while (itr.hasNext()) {

String uploadedFile = itr.next();

MultipartFile file = request.getFile(uploadedFile);

String filename = file.getOriginalFilename();

is = file.getInputStream();

FileUtil.copyInputStreamToFile("F:/Test", is, filename);

}

res.put("code", 0);

} catch (Exception e) {

if (logger.isDebugEnabled()) {

logger.debug(e.getMessage());

}

e.printStackTrace();

res.put("code", 1);

res.put("msg", e.getMessage());

return new ResponseEntity<>(JSON.toJSONString(res), HttpStatus.INTERNAL_SERVER_ERROR);

} finally {

try {

is.close();

} catch (IOException e) {

e.printStackTrace();

}

}

res.put("msg", "Uploaded successfully");

return new ResponseEntity<>(JSON.toJSONString(res), HttpStatus.OK);

}

后台使用的是spring,通过配置MultipartHttpServletRequest,则接收时不用使httpServletRequest转换成MultipartHttpServletRequest,spring接收到的是MultipartHttpServletRequest请求,则自动会将请求转换成MultipartHttpServletRequest,后台代码直接处理即可。request.getFile(uploadedFile);

可逐一接收dropzone发送过来的图片,uploadedFile 为图片文件名称。然后进行读流存储操作。将图片存储到指定路径。