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 相关文章推荐
jQuery 一个图片切换的插件
Oct 09 Javascript
namespace.js Javascript的命名空间库
Oct 11 Javascript
jQuery循环滚动展示代码 可应用到文字和图片上
May 11 Javascript
JavaScript获取鼠标移动时的坐标(兼容IE8、chome谷歌、Firefox)
Sep 13 Javascript
javascript引用赋值(地址传值)用法实例
Jan 13 Javascript
JS实现图片放大镜效果的方法
Feb 27 Javascript
基于JavaScript实现动态添加删除表格的行
Feb 01 Javascript
微信小程序 开发之快递查询功能的实现
Jan 09 Javascript
Angular开发实践之服务端渲染
Mar 29 Javascript
Angular 容器部署的方法
Apr 17 Javascript
Vue加载json文件的方法简单示例
Jan 28 Javascript
react ant Design手动设置表单的值操作
Oct 31 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
Smarty+QUICKFORM小小演示
2007/02/25 PHP
php反射应用示例
2014/02/25 PHP
php 批量添加多行文本框textarea一行一个
2014/06/03 PHP
php生成不重复随机数、数组的4种方法分享
2015/03/30 PHP
PHP+Ajax实时自动检测是否联网的方法
2015/07/01 PHP
Smarty日期时间操作方法示例
2016/11/15 PHP
node.js中的http.response.removeHeader方法使用说明
2014/12/14 Javascript
Bootstrap Fileinput文件上传组件用法详解
2016/05/10 Javascript
微信小程序 Canvas增强组件实例详解及源码分享
2017/01/04 Javascript
three.js实现围绕某物体旋转
2017/01/25 Javascript
原生JS实现图片翻书效果
2017/02/16 Javascript
JavaScript中一些特殊的字符运算
2017/08/17 Javascript
JS基于对象的特性实现去除数组中重复项功能详解
2017/11/17 Javascript
给localStorage设置一个过期时间的方法分享
2018/11/06 Javascript
深入浅析Vue.js 中的 v-for 列表渲染指令
2018/11/19 Javascript
JavaScript基础之静态方法和实例方法分析
2018/12/26 Javascript
ES5和ES6中类的区别总结
2020/12/21 Javascript
[01:42]辉夜杯战队访谈宣传片—FANTUAN
2015/12/25 DOTA
[10:53]2018DOTA2国际邀请赛寻真——EG
2018/08/11 DOTA
[46:42]DOTA2-DPC中国联赛正赛 Aster vs Magma BO3 第二场 3月5日
2021/03/11 DOTA
Python单元测试框架unittest使用方法讲解
2015/04/13 Python
Python2.6版本中实现字典推导 PEP 274(Dict Comprehensions)
2015/04/28 Python
用python编写第一个IDA插件的实例
2018/05/29 Python
python2 与 pyhton3的输入语句写法小结
2018/09/10 Python
pandas去除重复列的实现方法
2019/01/29 Python
Python简直是万能的,这5大主要用途你一定要知道!(推荐)
2019/04/03 Python
Python对ElasticSearch获取数据及操作
2019/04/24 Python
解决python 3 urllib 没有 urlencode 属性的问题
2019/08/22 Python
基于PyQT实现区分左键双击和单击
2020/05/19 Python
python如何控制进程或者线程的个数
2020/10/16 Python
想学画画?python满足你!
2020/12/24 Python
实习生个人找工作的自我评价
2013/10/30 职场文书
财务与信息服务专业推荐信
2013/11/28 职场文书
2014年个人思想工作总结
2014/11/27 职场文书
文明旅游倡议书
2015/04/28 职场文书
HTML中的表单元素介绍
2022/02/28 HTML / CSS