JQuery批量上传插件Uploadify使用详解及参数说明
Uploadify是JQuery的一个上传插件,实现的效果非常不错,带进度显示。官方提供的实例是php版本的,您可以点击下面的链接进行浏览或下载。
JSP前台页面:
<script type="text/javascript"> $(document).ready( function() { $("#uploadify").uploadify( {//初始化函数 'uploader' :'uploadify.swf',//flash文件位置,注意路径 'script' :'servlet/Upload',//后台处理的请求 'cancelImg' :'images/cancel.png',//取消按钮图片 'folder' :'uploads',//您想将文件保存到的路径 'queueID' :'fileQueue',//与下面的上传文件列表id对应 'queueSizeLimit' :8,//上传文件的数量 'scriptData':{'a':'value1','b':'value2'},//向后台传的数据 'fileDesc' :'rar文件或zip文件',//上传文件类型说明 'fileExt' :'*.rar;*.zip', //控制可上传文件的扩展名,启用本项时需同时声明fileDesc 'method':'get',//如果向后台传输数据,必须是get 'sizeLimit':1000,//文件上传的大小限制,单位是字节 'auto' :false,//是否自动上传 'multi' :true, 'simUploadLimit' :2,//同时上传文件的数量 'buttonText' :'BROWSE',//浏览按钮图片 'onComplete': function(event, queueID, fileObj,serverData,data) {//当上传完成后的回调函数,ajax方式哦~~ alert(data.speed); } }); }); </script> <script type="text/javascript" src="js/jquery-1.3.2.min.js"></script> <script type="text/javascript" src="js/swfobject.js"></script> <script type="text/javascript" src="js/jquery.uploadify.v2.1.0.min.js"></script> <div id="fileQueue"></div> <input type="file" name="uploadify" id="uploadify" /> <p> <a href="javascript:jQuery('#uploadify').uploadifyUpload()">开始上传</a> <a href="javascript:jQuery('#uploadify').uploadifyClearQueue()">取消所有上传</a> </p> java后台: String savePath = this.getServletConfig().getServletContext().getRealPath(""); savePath = savePath + "/uploads/"; File f1 = new File(savePath); System.out.println(savePath); if (!f1.exists()) { f1.mkdirs(); } DiskFileItemFactory fac = new DiskFileItemFactory(); ServletFileUpload upload = new ServletFileUpload(fac); upload.setHeaderEncoding("utf-8"); List fileList = null; try { fileList = upload.parseRequest(request); } catch (FileUploadException ex) { ex.printStackTrace(); return; } Iterator it = fileList.iterator(); while (it.hasNext()) { FileItem item = (FileItem) it.next(); if (!item.isFormField()) { name = item.getName(); long size = item.getSize(); String type = item.getContentType(); if (name == null || name.trim().equals("")) { continue; } // 扩展名格式: if (name.lastIndexOf(".") >= 0) { extName = name.substring(name.lastIndexOf(".")); } File file = null; do { // 生成文件名: name = UUID.randomUUID().toString(); file = new File(savePath + name + extName); } while (file.exists()); File saveFile = new File(savePath + name + extName); try { item.write(saveFile); } catch (Exception e) { e.printStackTrace(); } } } response.getWriter().print(name + extName);
代码很好懂,不讲解了。
下面是官方英文文档的一些翻译。此文档是2.14版本的,现在出了3.0版本,属性和事件名称有改变,注意参考JS文件
Uploadify属性
属性名类型说明
autoboolean添加到队列后自动上传
buttonImgstring浏览按钮的背景图片
buttonTextstring浏览按钮的显示文字
cancelImgstring取消上传按钮的图片
checkScriptstring服务端用来检查文件是否重名的脚本
displayDatastring上传时显示的提示(percentage百分比/speed速度)
expressInstallstring安装swf的文件(expressInstall.swf)路径
fileDataNamestring重定义的input的名称(后台)
fileDescstring文件打开对话框中的文件类型描述
fileExtstring可允许上传的文件类型
folderstring文件存储的文件夹
heightinteger浏览按钮的高度
hideButtonboolean是否隐藏浏览按钮
methodstring表单提交方式(post/get)
multiboolean是否允许上传多个文件
queueIDstring上传队列的元素的ID
queueSizeLimitinteger上传队列大小
removeCompletedboolean完成上传时是否自动删除
rolloverboolean当鼠标移上时产生特效
scriptstring上传表单提交的目标脚本
scriptAccessstringswf的文件地址
scriptDataJSON提交给后台的附加信息
simUploadLimitinteger同时可上传的文件实例数
sizeLimitinteger每文件的最大大小
uploaderstringuploadify上传的swf文件路径
widthinteger浏览按钮的宽度
wmodestringflash文件的wmode模式
Uploadify事件
事件名参数说明
onAllCompletefunction(event,data)当所有文件上传完毕时触发
onCancelfunction(event,ID,fileObj,data)当某文件被取消上传时触发
onCheckfunction()当开始上传时检查是否重名
onClearQueuefunction(event)当执行uploadifyClearQueue()后执行
onCompletefunction(event,ID,fileObj,response,data)当某文件上传完毕时触发
onErrorfunction(event,ID,fileObj,errorObj)当上传时有错误返回时触发
onInitfunction()当uploadify实例加载完毕时触发
onOpenfunction(event,ID,fileObj)当某文件开始上传时触发
onProgressfunction(event,ID,fileObj,data)当某文件上传进度改变时触发
onQueueFullfunction(event,queueSizeLimit)当上传队列达到限制时触发
onSelectfunction(event,ID,fileObj)每个文件被添加到上传队列时触发
onSelectOncefunction(event,data)一次文件被添加到上传队列时触发
onSWFReadyfunction()当flash加载完毕时触发
Uploadify方法
方法名说明
.uploadify()创建Uploadify的实例
.uploadifyCancel()从上传队列中移除一个文件
.uploadifyClearQueue()清空上传队列
.uploadifySettings()修改Uploadify实例的属性
.uploadifyUpload()
</script>