JQuery上传插件Uploadify使用详解及错误处理


Posted in Javascript onApril 27, 2010

 什么是Uploadify

Uploadify是JQuery的一个上传插件,支持多文件上传,实现的效果非常不错,带进度显示。

官网提供的是PHP的DEMO,在这里我详细介绍在Asp.net下的使用.

下载

如何使用

1 创建Web项目,命名为JQueryUploadDemo,从官网上下载最新的版本解压后添加到项目中

2 在项目中添加UploadHandler.ashx文件用来处理文件的上传。

3 在项目中添加UploadFile文件夹,用来存放上传的文件。

进行完上面三步后项目的基本结构如下图:

JQuery上传插件Uploadify使用详解及错误处理
4 Default.aspx的html页的代码修改如下:

<html xmlns="http://www.w3.org/1999/xhtml"> 
<head runat="server"> 
<title>Uploadify</title> 
<link href="JS/jquery.uploadify-v2.1.0/example/css/default.css" 
rel="stylesheet" type="text/css" /> 
<link href="JS/jquery.uploadify-v2.1.0/uploadify.css" 
rel="stylesheet" type="text/css" /> <script type="text/javascript" 
src="JS/jquery.uploadify-v2.1.0/jquery-1.3.2.min.js"></script> 
<script type="text/javascript" 
src="JS/jquery.uploadify-v2.1.0/swfobject.js"></script> 
<script type="text/javascript" 
src="JS/jquery.uploadify-v2.1.0/jquery.uploadify.v2.1.0.min.js"></script> 
<script type="text/javascript"> 
$(document).ready(function() 
{ 
$("#uploadify").uploadify({ 
'uploader': 'JS/jquery.uploadify-v2.1.0/uploadify.swf', 
'script': 'UploadHandler.ashx', 
'cancelImg': 'JS/jquery.uploadify-v2.1.0/cancel.png', 
'folder': 'UploadFile', 
'queueID': 'fileQueue', 
'auto': false, 
'multi': true 
}); 
}); 
</script> 
</head> 
<body> 
<div id="fileQueue"></div> 
<input type="file" name="uploadify" id="uploadify" /> 
<p> 
<a href="javascript:$('#uploadify').uploadifyUpload()">上传</a>| 
<a href="javascript:$('#uploadify').uploadifyClearQueue()">取消上传</a> 
</p> 
</body> 
</html>

5 UploadHandler类的ProcessRequest方法代码如下:

public void ProcessRequest(HttpContext context) 
{ 
context.Response.ContentType = "text/plain"; 
context.Response.Charset = "utf-8"; HttpPostedFile file = context.Request.Files["Filedata"]; 
string uploadPath = 
HttpContext.Current.Server.MapPath(@context.Request["folder"])+"\\"; 
if (file != null) 
{ 
if (!Directory.Exists(uploadPath)) 
{ 
Directory.CreateDirectory(uploadPath); 
} 
file.SaveAs(uploadPath + file.FileName); 
//下面这句代码缺少的话,上传成功后上传队列的显示不会自动消失 
context.Response.Write("1"); 
} 
else 
{ 
context.Response.Write("0"); 
} 
}

注意:这里一定要注意,一定要引用using System.IO;命名空间,我出错的原因也是在这里,网上的教程基本上都没提到这一点,所以有很多网友会遇到IOError的错误。

6 运行后效果如下图:

JQuery上传插件Uploadify使用详解及错误处理
 7 选择了两个文件后,点击上传,就可以看到UploadFile文件夹中会增加这两个文件。

上面的代码就简单实现了上传的功能,依靠函数uploadify实现,uploadify函数的参数为json格式,可以对json对象的key值的修改来进行自定义的设置,如multi设置为true或false来控制是否可以进行多文件上传,下面就来介绍下这些key值的意思:

uploader : uploadify.swf 文件的相对路径,该swf文件是一个带有文字BROWSE的按钮,点击后淡出打开文件对话框,默认值:uploadify.swf。
script :   后台处理程序的相对路径 。默认值:uploadify.php
checkScript :用来判断上传选择的文件在服务器是否存在的后台处理程序的相对路径
fileDataName :设置一个名字,在服务器处理程序中根据该名字来取上传文件的数据。默认为Filedata
method : 提交方式Post 或Get 默认为Post
scriptAccess :flash脚本文件的访问模式,如果在本地测试设置为always,默认值:sameDomain 
folder :  上传文件存放的目录 。
queueID : 文件队列的ID,该ID与存放文件队列的div的ID一致。
queueSizeLimit : 当允许多文件生成时,设置选择文件的个数,默认值:999 。
multi : 设置为true时可以上传多个文件。
auto : 设置为true当选择文件后就直接上传了,为false需要点击上传按钮才上传 。
fileDesc : 这个属性值必须设置fileExt属性后才有效,用来设置选择文件对话框中的提示文本,如设置fileDesc为“请选择rar doc pdf文件”,打开文件选择框效果如下图:

JQuery上传插件Uploadify使用详解及错误处理

fileExt : 设置可以选择的文件的类型,格式如:'*.doc;*.pdf;*.rar' 。
sizeLimit : 上传文件的大小限制 。
simUploadLimit : 允许同时上传的个数 默认值:1 。
buttonText : 浏览按钮的文本,默认值:BROWSE 。
buttonImg : 浏览按钮的图片的路径 。
hideButton : 设置为true则隐藏浏览按钮的图片 。
rollover : 值为true和false,设置为true时当鼠标移到浏览按钮上时有反转效果。
width : 设置浏览按钮的宽度 ,默认值:110。
height : 设置浏览按钮的高度 ,默认值:30。
wmode : 设置该项为transparent 可以使浏览按钮的flash背景文件透明,并且flash文件会被置为页面的最高层。 默认值:opaque 。
cancelImg :选择文件到文件队列中后的每一个文件上的关闭按钮图标,如下图:

JQuery上传插件Uploadify使用详解及错误处理

上面介绍的key值的value都为字符串或是布尔类型,比较简单,接下来要介绍的key值的value为一个函数,可以在选择文件、出错或其他一些操作的时候返回一些信息给用户。

onInit : 做一些初始化的工作

onSelect :选择文件时触发,该函数有三个参数

  • event:事件对象。
  • queueID:文件的唯一标识,由6为随机字符组成。
  • fileObj:选择的文件对象,有name、size、creationDate、modificationDate、type 5个属性。

代码如下:

$(document).ready(function() 
{ 
$("#uploadify").uploadify({ 
'uploader': 'JS/jquery.uploadify-v2.1.0/uploadify.swf', 
'script': 'UploadHandler.ashx', 
'cancelImg': 'JS/jquery.uploadify-v2.1.0/cancel.png', 
'folder': 'UploadFile', 
'queueID': 'fileQueue', 
'auto': false, 
'multi': true, 
'onInit':function(){alert("1");}, 
'onSelect': function(e, queueId, fileObj) 
{ 
alert("唯一标识:" + queueId + "\r\n" + 
"文件名:" + fileObj.name + "\r\n" + 
"文件大小:" + fileObj.size + "\r\n" + 
"创建时间:" + fileObj.creationDate + "\r\n" + 
"最后修改时间:" + fileObj.modificationDate + "\r\n" + 
"文件类型:" + fileObj.type 
); } 
}); 
});

当选择一个文件后弹出的消息如下图:

JQuery上传插件Uploadify使用详解及错误处理

onSelectOnce :在单文件或多文件上传时,选择文件时触发。该函数有两个参数event,data,data对象有以下几个属性:

fileCount:选择文件的总数。
filesSelected:同时选择文件的个数,如果一次选择了3个文件该属性值为3。
filesReplaced:如果文件队列中已经存在A和B两个文件,再次选择文件时又选择了A和B,该属性值为2。
allBytesTotal:所有选择的文件的总大小。
 

onCancel : 当点击文件队列中文件的关闭按钮或点击取消上传时触发。该函数有event、queueId、fileObj、data四个参数,前三个参数同onSelect 中的三个参数,data对象有两个属性fileCount和allBytesTotal。

fileCount:取消一个文件后,文件队列中剩余文件的个数。
allBytesTotal:取消一个文件后,文件队列中剩余文件的大小。
 

onClearQueue :当调用函数fileUploadClearQueue时触发。有event和data两个参数,同onCancel 中的两个对应参数。

onQueueFull :当设置了queueSizeLimit并且选择的文件个数超出了queueSizeLimit的值时触发。该函数有两个参数event和queueSizeLimit。

onError :当上传过程中发生错误时触发。该函数有event、queueId、fileObj、errorObj四个参数,其中前三个参数同上,errorObj对象有type和info两个属性。

type:错误的类型,有三种‘HTTP', ‘IO', or ‘Security'
info:错误的描述
 

onOpen :点击上传时触发,如果auto设置为true则是选择文件时触发,如果有多个文件上传则遍历整个文件队列。该函数有event、queueId、fileObj三个参数,参数的解释同上。

onProgress :点击上传时触发,如果auto设置为true则是选择文件时触发,如果有多个文件上传则遍历整个文件队列,在onOpen之后触发。该函数有event、queueId、fileObj、data四个参数,前三个参数的解释同上。data对象有四个属性percentage、bytesLoaded、allBytesLoaded、speed:

percentage:当前完成的百分比
bytesLoaded:当前上传的大小
allBytesLoaded:文件队列中已经上传完的大小
speed:上传速率 kb/s
 

onComplete:文件上传完成后触发。该函数有四个参数event、queueId、fileObj、response、data五个参数,前三个参数同上。response为后台处理程序返回的值,在上面的例子中为1或0,data有两个属性fileCount和speed

fileCount:剩余没有上传完成的文件的个数。
speed:文件上传的平均速率 kb/s
注:fileObj对象和上面讲到的有些不太一样,onComplete 的fileObj对象有个filePath属性可以取出上传文件的路径。

 

onAllComplete:文件队列中所有的文件上传完成后触发。该函数有event和data两个参数,data有四个属性,分别为:

filesUploaded :上传的所有文件个数。
errors :出现错误的个数。
allBytesLoaded :所有上传文件的总大小。
speed :平均上传速率 kb/s
 

相关函数介绍

在上面的例子中已经用了uploadifyUpload和uploadifyClearQueue两个函数,除此之外还有几个函数:

uploadifySettings:可以动态修改上面介绍的那些key值,如下面代码

$('#uploadify').uploadifySettings('folder','JS'); 

如果上传按钮的事件写成下面这样,文件将会上传到uploadifySettings定义的目录中

<a href="javascript:$('#uploadify').uploadifySettings('folder','JS');$('#uploadify').uploadifyUpload()">上传</a>

uploadifyCancel:该函数接受一个queueID作为参数,可以取消文件队列中指定queueID的文件。

$('#uploadify').uploadifyCancel(id); 

 

好了,所有的配置都完成了。下面说说我遇到的一些问题。 span style="font-size: 18pt;"> 可能遇到的问题

1.我刚开始配置完成后,并不能正常工作 ,flash(uploadify.swf' )没有加载。后来我查看jquery.uploadify.v2.1.0.js发现该插件是利用swfobject.js动态创建的FLASH,后来我单独做试验还是不能显示flash,无耐之下重启电脑后就可以了。晕倒~~~

2.FLASH终于加载进来了,但上传又失败了。报IOError,如图:

JQuery上传插件Uploadify使用详解及错误处理

百思不得其解,翻遍了各大网络,终于在国外的一网站看到了这么一句using System.IO; 添加之豁然开朗!!

暂时还没有遇到其它问题,后续发现问题再加。
三水点靠木提供的Uploadify下载地址

Javascript 相关文章推荐
可以文本显示的公告栏的js代码
Mar 11 Javascript
超酷的网页音乐播放器DewPlayer使用方法
Dec 18 Javascript
jQuery实现获取元素索引值index的方法
Sep 18 Javascript
jQuery zTree 异步加载添加子节点重复问题
Nov 29 jQuery
微信小程序实现YDUI的ScrollNav组件
Feb 02 Javascript
原生JS实现的简单小钟表功能示例
Aug 30 Javascript
详解swiper在vue中的应用(以3.0为例)
Sep 20 Javascript
微信小程序实现登录遮罩效果
Nov 01 Javascript
30分钟快速实现小程序语音识别功能
Nov 27 Javascript
electron-vue开发环境内存泄漏问题汇总
Oct 10 Javascript
vue实现多级菜单效果
Oct 19 Javascript
Webpack5正式发布,有哪些新特性
Oct 12 Javascript
JavaScript中常见陷阱小结
Apr 27 #Javascript
javascript 动态修改样式和层叠样式表代码
Apr 27 #Javascript
js 绑定带参数的事件以及手动触发事件
Apr 27 #Javascript
javascript 模式设计之工厂模式学习心得
Apr 27 #Javascript
defer属性导致引用JQuery的页面报“浏览器无法打开网站xxx,操作被中止”错误的解决方法
Apr 27 #Javascript
jQuery Lightbox 图片展示插件使用说明
Apr 25 #Javascript
jQuery 表格工具集
Apr 25 #Javascript
You might like
Linux fgetcsv取得的数组元素为空字符串的解决方法
2011/11/25 PHP
php简单开启gzip压缩方法(zlib.output_compression)
2013/04/13 PHP
PHP多文件上传类实例
2015/03/07 PHP
小程序微信退款功能实现方法详解【基于thinkPHP】
2019/05/05 PHP
准确获得页面、窗口高度及宽度的JS
2006/11/26 Javascript
可以用来调试JavaScript错误的解决方案
2010/08/07 Javascript
javascript确认框的三种使用方法
2013/12/17 Javascript
js加载读取内容及显示与隐藏div示例
2014/02/13 Javascript
js触发onchange事件的方法说明
2014/03/08 Javascript
JavaScript函数获取事件源的小例子
2014/05/14 Javascript
JS实现文件动态顺序载入的方法
2015/03/07 Javascript
jQuery实现鼠标划过添加和删除class的方法
2015/06/26 Javascript
网页从弹窗页面单选框传值至父页面代码分享
2015/09/29 Javascript
AngularJS 使用 UI Router 实现表单向导
2016/01/29 Javascript
javascript用正则表达式过滤空格的实现代码
2016/06/14 Javascript
JS实现加载和读取XML文件的方法详解
2017/04/24 Javascript
详解Vuex中mapState的具体用法
2017/09/28 Javascript
node上的redis调用优化示例详解
2018/10/30 Javascript
laydate时间日历插件使用方法详解
2018/11/14 Javascript
JavaScript设计模式之责任链模式实例分析
2019/01/16 Javascript
Vue 列表页带参数进详情页的操作(router-link)
2020/11/13 Javascript
Python基于PycURL实现POST的方法
2015/07/25 Python
python实现图片处理和特征提取详解
2017/11/13 Python
python词云库wordcloud的使用方法与实例详解
2020/02/17 Python
你需要学会的8个Python列表技巧
2020/06/24 Python
馥绿德雅美国官方网站:Rene Furterer头皮护理专家
2019/05/01 全球购物
详解如何解决使用JSON.stringify时遇到的循环引用问题
2021/03/23 Javascript
化学相关工作求职信
2013/10/02 职场文书
四年级下册教学反思
2014/02/01 职场文书
民族学专业职业生涯规划范文:积跬步以至千里
2014/09/11 职场文书
银行员工犯错检讨书
2014/09/16 职场文书
群众路线个人剖析材料及整改措施
2014/11/04 职场文书
2014年宣传工作总结
2014/11/18 职场文书
开会通知短信大全
2015/04/20 职场文书
《狼牙山五壮士》教学反思
2016/02/17 职场文书
Mysql 性能监控及调优
2021/04/06 MySQL