首页 > 代码库 > JQUery利用Uploadify插件实现文件异步上传(十一)

JQUery利用Uploadify插件实现文件异步上传(十一)

一:简介:
Uploadify是JQuery的一个上传插件,实现的效果非常好,带进度显示 ,且Ajax异步,能一次性上传多个文件,功能强大,使用简单
1.支持单文件或多文件上传,可控制并发上传的文件数
2.在服务器端支持各种语言与之配合使用,诸如PHP,.NET,Java……
3.通过参数可配置上传文件类型及大小限制
4.通过参数可配置是否选择文件后自动上传
5.易于扩展,可控制每一步骤的回调函数(onSelect, onCancel……)
6.通过接口参数和CSS控制外观
 
二:官方下载

http://www.uploadify.com/download/

官方文档

http://www.uploadify.com/documentation/

 官方演示

http://www.uploadify.com/demo/
 
三:使用的方法:
Step1:引入相关js和css
<link href="http://www.mamicode.com/JS/jquery.uploadify-v2.1.0/example/css/default.css"
     rel="stylesheet" type="text/css" />
    <link href="http://www.mamicode.com/JS/jquery.uploadify-v2.1.0/uploadify.css"
     rel="stylesheet" type="text/css" />
 
    <script type="text/javascript"
     src="http://www.mamicode.com/JS/jquery.uploadify-v2.1.0/jquery-1.3.2.min.js"></script>
 
    <script type="text/javascript"
     src="http://www.mamicode.com/JS/jquery.uploadify-v2.1.0/swfobject.js"></script>
 
    <script type="text/javascript"
   src="http://www.mamicode.com/JS/jquery.uploadify-v2.1.0/jquery.uploadify.v2.1.0.min.js"></script>
 
 
Step2:前台HTML代码
<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>

 
Step3:前台JS
<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>

Step4:后台UploadHandler类的ProcessRequest方法代码如下:
 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");   
    }  

四:其他属性
uploader : uploadify.swf 文件的相对路径,该swf文件是一个带有文字BROWSE的按钮,点击后淡出打开文件对话框,默认值:uploadify.swf。

script :   后台处理程序的相对路径 。默认值:uploadify.php

fileDataName :设置一个名字,在服务器处理程序中根据该名字来取上传文件的数据。默认为Filedata

method : 提交方式Post 或Get 默认为Post

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

 
常用事件
onInit : 做一些初始化的工作。
onSelect :选择文件时触发,该函数有三个参数
event:事件对象。
queueID:文件的唯一标识,由6为随机字符组成。
fileObj:选择的文件对象,有name、size、creationDate、modificationDate、type 5个属性。

$("#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 ); }

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);

 
在Asp.net中是通过在web.config中加一个配置
 <httpRuntime maxRequestLength="1000000" executionTimeout="300"/>

 
具体代码:
<%@ Page Language="C#" AutoEventWireup="true"  CodeFile="Default.aspx.cs" Inherits="_Default" %><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head id="Head1" runat="server">    <title>Uploadify</title>    <link href="http://www.mamicode.com/JS/jquery.uploadify-v2.1.0/example/css/default.css"     rel="stylesheet" type="text/css" />    <link href="http://www.mamicode.com/JS/jquery.uploadify-v2.1.0/uploadify.css"     rel="stylesheet" type="text/css" />    <script type="text/javascript"     src="http://www.mamicode.com/JS/jquery.uploadify-v2.1.0/jquery-1.3.2.min.js"></script>    <script type="text/javascript"     src="http://www.mamicode.com/JS/jquery.uploadify-v2.1.0/swfobject.js"></script>    <script type="text/javascript"   src="http://www.mamicode.com/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,                //‘fileExt‘: "*.bmp;*.jpg",                //‘fileDesc‘: "请选择.bmp或.jpg格式的图片",                ‘onInit‘: function() { $("#msg").html(""); },                ‘onSelectOnce ‘: function(event, queueId, data) {                    //alert("ok");                    $("#msg").html("共上传" + data.fileCount + "个文件,文件大小共" + data.allBytesTotal + "个字节!");                },                ‘onCancel‘: function(event, queueId, fileObj, data) {                    $("#msg").html("共上传" + data.fileCount + "个文件,文件大小共" + data.allBytesTotal + "个字节!");                },                ‘onProgress‘: function(event, queueId, fileObj, data) {                    $("#msg").html("当前完成的百分比:" + data.percentage + ",已经上传完:" + data.allBytesLoaded + ",总共大小为:" + data.bytesLoaded + ",上传的速度:" + data.speed + "(kb/s)");                }            });        });      </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>    <p id="msg"></p></body></html>

 

一般处理页面:
<%@ WebHandler Language="C#" Class="UploadHandler" %>using System;using System.Web;public class UploadHandler : IHttpHandler {    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 (!System.IO.Directory.Exists(uploadPath))            {                System.IO.Directory.CreateDirectory(uploadPath);            }            file.SaveAs(uploadPath + file.FileName);            //下面这句代码缺少的话,上传成功后上传队列的显示不会自动消失            context.Response.Write("1");        }        else        {            context.Response.Write("0");        }    }    #region IHttpHandler 成员    public bool IsReusable    {        get { throw new NotImplementedException(); }    }    #endregion}

 

 

JQUery利用Uploadify插件实现文件异步上传(十一)