JQuery上传插件Uploadify使用详解
Uploadify是JQuery的一个上传插件,支持多文件上传,实现的效果非常不错,带进度显示。
如何使用:
1 从官网下载最新的版本http://www.uploadify.com,并解压。
2 创建Web项目,命名为uplodify。
3 将commons-io-1.4.jar、commons-fileupload-1.2.jar放到WEB-INF/lib目录下
4 在项目中创建css、images、js文件夹,将解压包中相应文件拷贝到相应的文件夹。
5 在项目中添加test.jsp作为文件的上传页面。
6 在项目中添加uploadDoc.jsp文件用来处理文件的上传。
7 在项目中添加uploads文件夹,用来存放上传的文件。
一、进行完上面七步后项目的基本结构如下图:
二、test.jsp的代码如下:
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>文件批量上传</title>
<meta http-equiv="pragma" content="no-cache">
<meta http-equiv="cache-control" content="no-cache">
<meta http-equiv="expires" content="0">
<link href="<%=request.getContextPath()%>/css/default.css" rel="stylesheet" type="text/css" />
<link href="<%=request.getContextPath()%>/css/uploadify.css" rel="stylesheet" type="text/css" />
<script type="text/javascript" src="<%=request.getContextPath()%>/js/jquery-1.3.2.min.js"></script>
<script type="text/javascript" src="<%=request.getContextPath()%>/js/swfobject.js"></script>
<script type="text/javascript" src="<%=request.getContextPath()%>/js/jquery.uploadify.v2.1.0.min.js"></script>
<script type="text/javascript">
$(document).ready(function() {
$("#uploadify").uploadify({
'uploader' : 'js/uploadify.swf',
'script' : 'uploadDoc.jsp',
'cancelImg' : 'images/cancel.png',
'folder' : 'uploads',
'queueID' : 'fileQueue',
'fileDesc' : '请选择doc,docx,xls,xlsx文件',
'fileExt' : '*.doc;*.docx;*.xls;*.xlsx',
'sizeLimit' : 1024*1024*10,
'auto' : false,
'multi' : true,
'simUploadLimit' : 2,
'buttonText' : 'BROWSE'
});
});
</script>
</head>
<body>
<div id="fileQueue" ></div>
<input type="file" name="uploadify" id="uploadify" /> <br><br>
[url=javascript:jQuery('#uploadify').uploadifyUpload()]开始上传[/url]
[url=javascript:jQuery('#uploadify').uploadifyClearQueue()]取消所有上传[/url]
</body>
</html>
三、uploadDoc.jsp的代码如下:
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ page import="org.apache.commons.fileupload.*"%>
<%@ page import="org.apache.commons.fileupload.servlet.*"%>
<%@ page import="org.apache.commons.fileupload.disk.*"%>
<%@ page import="java.util.*"%>
<%@ page import="java.io.*"%>
<%
String savePath = this.getServletConfig().getServletContext().getRealPath("");
// 得到项目的工作目录
savePath = savePath + "/uploads/";
File f1 = new File(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) {
return;
}
Iterator<FileItem> it = fileList.iterator();
String name = "";
String extName = "";
while (it.hasNext()) {
FileItem item = 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 {
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);
%>
四、运行之后效果图如下:
五、 选择了三个文件后,点击开始上传,就可以看到uploads文件夹中会增加这两个文件。
上面的代码就简单实现了上传的功能,依靠函数uploadify实现,uploadify函数的参数为json格式,可以对json对象的key值的修改来进行自定义的设置,如multi设置为true或false来控制是否可以进行多文件上传,下面就来介绍下这些key值的意思:
uploader : uploadify.swf 文件的相对路径,该swf文件是一个带有文字BROWSE的按钮,点击后淡出打开文件对话框,默认值:uploadify.swf。
script : 后台处理程序的相对路径 。
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为“请选择doc,docx,xls,xlsx文件”,打开文件选择框效果如下图:
fileExt : 设置可以选择的文件的类型,格式如:'*.doc;*.docx;*.xls;*.xlsx' 。
sizeLimit : 上传文件的大小限制 。
simUploadLimit : 允许同时上传的个数 默认值:1 。
buttonText : 浏览按钮的文本,默认值:BROWSE 。
buttonImg : 浏览按钮的图片的路径 。
hideButton : 设置为true则隐藏浏览按钮的图片 。
rollover : 值为true和false,设置为true时当鼠标移到浏览按钮上时有反转效果。
width : 设置浏览按钮的宽度 ,默认值:110。
height : 设置浏览按钮的高度 ,默认值:30。
wmode : 设置该项为transparent 可以使浏览按钮的flash背景文件透明,并且flash文件会被置为页面的最高层。 默认值:opaque 。
cancelImg :选择文件到文件队列中后的每一个文件上的关闭按钮图标,如下图:
上面介绍的key值的value都为字符串或是布尔类型,比较简单,接下来要介绍的key值的value为一个函数,可以在选择文件、出错或其他一些操作的时候返回一些信息给用户。
onInit : 做一些初始化的工作。
onSelect :选择文件时触发,该函数有三个参数
• event:事件对象。
• queueID:文件的唯一标识,由6为随机字符组成。
• fileObj:选择的文件对象,有name、size、creationDate、modificationDate、type 5个属性。
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定义的目录中
[url=javascript:$('#uploadify').uploadifySettings('folder','JS');$('#uploadify').uploadifyUpload()]上传[/url]
uploadifyCancel:该函数接受一个queueID作为参数,可以取消文件队列中指定queueID的文件。
$('#uploadify').uploadifyCancel(id);
小结:
1、 如你想点击开始上传是需要进行一些验证操作:
(1)连接可如下:
(2)js验证:
2、scriptData参数
可提供URL传递参数。用来传递get参数。例如:
index.jsp?id=1&action=uploadify可以设置成:
‘script’: ‘index.jsp’,
‘scriptData’:{‘id’:1,’action’:'uploadify’},
注:要设置‘method’:‘GET’.
3、uploadifySettings可实现动态传参:
$("#uploadify").uploadifySettings("scriptData",{"name":$("#TextBoxNR").val(), "id": $("#Hidden_ID").val() });
4、script的后台处理程序可以是servlet的地址:
写script的路径时可以这样: 'script' : 'Upload',
5、引插件时的路径问题:
(1)路径要写全写对,否则js插件引不进来
(2)swfobject.js这个插件是用Jquery写的,存放路径中不能有javascript命名的目录,
即:不能是 src="<%=request.getContextPath()%>/javascript/swfobject.js”
引js插件时可以这样:
对上传的文档进行校验:
$(document).ready(function() {
$("#uploadify").uploadify({
'uploader' : '../resources/uploadfile/js/uploadify.swf', //uploadify.swf 文件的相对路径,默认值:uploadify.swf
// 'checkScript' :
// '../resources/uploadfile/checkDoc.jsp?clno=101',
// //用来判断上传选择的文件在服务器是否存在的后台处理程序的相对路径
'script' : '../resources/uploadfile/uploadDoc.jsp', //后台处理程序的相对路径
// 'scriptData' : {"clno" : $("#newclno").val()},
// //传参,使用scriptData需要先设置'method' : 'GET'
'cancelImg' : '../resources/uploadfile/images/cancel.png', //选择文件到文件队列中后的每一个文件上的关闭按钮图标
'folder' : '', //上传文件存放的目录,此处可以在后台认为设置
// 'method' : 'Get', //提交方式Post 或Get 默认为Post
'queueID' : 'fileQueue', //文件队列的ID,该ID与存放文件队列的div的ID一致
'fileDesc' : '请选择doc,docx,xls,xlsx文件', //这个属性值必须设置fileExt属性后才有效,用来设置选择文件对话框中的提示文本
'fileExt' : '*.doc;*.docx;*.xls;*.xlsx', //设置可以选择的文件的类型,格式如:'*.doc;*.xls'
'queueSizeLimit' : 100, //当允许多文件生成时,设置选择文件的个数,默认值:999
'auto' : false, //设置为true当选择文件后就直接上传了,为false需要点击上传按钮才上传
'multi' : true, //设置为true时可以上传多个文件
'sizeLimit' : 1024*1024*10, //上传文件的大小限制,单位为字节
'simUploadLimit' : 2, //允许同时上传的个数 默认值:1
// 'onInit' : function(){alert("1");}, //做一些初始化的工作
'onSelect' : function(event, queueID, fileObj) { //选择文件时触发
saveDocName(fileObj.name);
// $("#uploadify").uploadifySettings('scriptData',
// {"clno" : $("#newclno").val()});
// //可以动态修改上面的那些key值
$("#uploadify").uploadifySettings('script', '../resources/uploadfile/uploadDoc.jsp?clno='+$("#newclno").val());
},
//'onSelectOnce' : function(event,data){ alert("您共选择了"+data.fileCount+"个文件!");}, //在单文件或多文件上传时,选择文件时触发
// 'onOpen' : function(event,queueId,fileObj){}
// //点击上传时触发,如果auto设置为true则是选择文件时触发,如果有多个文件上传则遍历整个文件队列
// 'onComplete' :
// function(event,queueId,fileObj,response,data){}
// //文件上传完成后触发,每个文件上传完成后就会触发
'onAllComplete' : function(event, data) { //文件队列中所有的文件上传完成后触发
alert("上传的文件个数:" + data.filesUploaded + "\r\n" +
"出现错误的个数:" + data.errors + "\r\n" +
"文件大小:" + data.allBytesLoaded
);
reDnameString();
},
'onCancel' : function(event,queueId,fileObj,data) { //当点击文件队列中文件的关闭按钮或点击取消上传时触发
// alert("删除:"+fileObj.name);
cancelDoc(fileObj.name);
},
'buttonText' : 'BROWSE' // 浏览按钮的文本,默认值:BROWSE。暂不支持中文,若要用中文,可使用buttonImg属性
// 'buttonImg' : '', //浏览按钮的图片的路径 。
// 'hideButton' : '', //设置为true则隐藏浏览按钮的图片 。
// 'rollover' : true //值为true和false,设置为true时当鼠标移到浏览按钮上时有反转效果。
});
});
var saveDoc = new Array(); // 暂存文件的名称的数组
var conflictDoc = new Array(); // 暂存与数据库冲突的文件
function saveDocName(dname){ //将上传的文件队列保存到暂存数组saveDoc中
saveDoc.push(dname); // 入栈操作
}
function cancelDoc(cancelName) { //取消队列中的上传文件时将暂存数组saveDoc中相应的值删除
var count = saveDoc.length; // 获取暂存文件的个数
var index;
for(var i=0; i < count; i++ ){
var doc = saveDoc[i];
if(cancelName == doc) {
index = i; // 查找到删除的文件所在的位置
}
}
saveDoc.splice(index,1); // 删除下标为index的元素
var newCount = saveDoc.length; // 获取暂存文件的个数
if(newCount > 0) {
saveConflict(newCount); //判断是否有冲突并将冲突文件保存到暂存数组saveConflict
var conflictCount = conflictDoc.length; // 获取冲突文件的个数
if(conflictCount > 0) {
handleConflict(conflictCount); //处理冲突
} else {
document.getElementById("conflict").innerHTML = "";
}
} else {
document.getElementById("conflict").innerHTML = ""; // 若将上传列表清空了,则将校验信息清空
}
}
function checkConflict(){ //点击校验按钮时检查是否有冲突,并将冲突的文件保存到conflictDoc数组中
var clno = null;
clno = $("#clno").val();
if(clno.length > 0) {
var count = saveDoc.length; // 获取暂存文件的个数
if(count > 0) {
saveConflict(count); //判断是否有冲突并将冲突文件保存到暂存数组saveConflict
var conflictCount = conflictDoc.length; // 获取冲突文件的个数
if(conflictCount > 0) {
handleConflict(conflictCount); //处理冲突
} else {
document.getElementById("conflict").innerHTML = ""; // 将校验信息清空
alert("经校验没有冲突,请上传!");
}
} else {
document.getElementById("conflict").innerHTML = ""; // 将校验信息清空
alert("请先选择上传的文件!");
}
} else {
alert("请先选择上传文件的归属目录!");
}
}
function saveConflict(count) { //判断是否有冲突并将冲突文件保存到暂存数组saveConflict
conflictDoc = []; // 将冲突数组清空
var jsonStr = document.getElementById("formAdd:dnameString").value; // 获取文件种类下的文档字符串
jsonStr = eval(jsonStr); // 将字符串转换为json字符串格式
for(var i=0; i < count; i++ ){
var doc = saveDoc[i]; // 取出暂存的文件名
var isConflict; // 冲突文件名
for(var j=0; j < jsonStr.length; j++) {
isConflict = jsonStr[j].dname; // 取出json串中的文档名称
if(doc == isConflict) {
conflictDoc.push(doc); // 若文件冲突,将冲突的文件名保存下来
}
}
}
}
function handleConflict(conflictCount) { //处理冲突
document.getElementById("conflict").innerHTML = "";
var divdev = document.getElementById("conflict");
var table = document.createElement("table"); //创建table
table.setAttribute("style","width:95%;border: 1px solid red;");
for(var i=0; i < conflictCount; i++) { //将冲突文件显示在页面上
var tr = document.createElement("tr");
var td = document.createElement("td");
td.setAttribute("style","width:70%;");
var span = document.createElement("span");
span.setAttribute("style","color:red;");
span.innerHTML = conflictDoc[i];
td.appendChild(span);
var td2 = document.createElement("td");
td2.setAttribute("style","width:30%;");
var span2 = document.createElement("span");
span2.setAttribute("style","color:red;");
span2.innerHTML = "若上传将会覆盖原文件!";
td2.appendChild(span2);
tr.appendChild(td);
tr.appendChild(td2);
table.appendChild(tr);
}
divdev.appendChild(table);
}
function check() { //点击上传按钮时进行非空校验,上传后将暂存数组saveDoc,conflictDoc清空
var clno = null;
clno = $("#clno").val();
if(clno.length > 0) {
var count = saveDoc.length; // 获取暂存文件的个数
if(count > 0) {
$('#uploadify').uploadifyUpload();
} else {
alert("请先选择上传的文件!");
}
} else {
alert("请先选择上传文件的归属目录!");
}
}
function reDnameString() { //上传完成后清空暂存数组,并刷新json串dnameStrin
document.getElementById("conflict").innerHTML = ""; //上传完成后将冲突列表清空
saveDoc = []; // 上传后将暂存的数组清空
conflictDoc = []; // 上传后将冲突数组清空
document.getElementById("formAdd:uploadAfter").click(); //刷新dnameString的值
}
页面上的按钮:
1.校验按钮:
<a4j:commandLink value=" 校验" style="color:red;font-family:黑体;font-size:15px;" οnclick="checkConflict();"/>
2.确认按钮:
<h:commandButton type="button" value="确认上传" οnclick="return check();" />
3.上传完后刷新页面上保存数据库中已有文件的json串dnameString:
<h:inputHidden id="dnameString" value="#{klbInfoRegBaseBean.dnameString}"/>
<a4j:commandLink id="uploadAfter" actionListener="#{klbInfoRegBaseBean.selectDocList}" reRender="dnameString">
<a4j:actionparam name="paraminfo" value="document.getElementById('clno').value" assignTo="#{klbInfoRegBaseBean.clno}" noEscape="true"/>
</a4j:commandLink>
4.显示冲突信息的div:
<div id="conflict"></div>
5.文档区域及隐藏区域:
<div id="fileQueue" ></div>
<input type="file" name="uploadify" id="uploadify" />
<input id="clno" type="hidden" value="" />
<input id="newclno" type="hidden" value="" />
<input id="dname" type="hidden" value="" />
Uploadify是JQuery的一个上传插件,支持多文件上传,实现的效果非常不错,带进度显示。
如何使用:
1 从官网下载最新的版本http://www.uploadify.com,并解压。
2 创建Web项目,命名为uplodify。
3 将commons-io-1.4.jar、commons-fileupload-1.2.jar放到WEB-INF/lib目录下
4 在项目中创建css、images、js文件夹,将解压包中相应文件拷贝到相应的文件夹。
5 在项目中添加test.jsp作为文件的上传页面。
6 在项目中添加uploadDoc.jsp文件用来处理文件的上传。
7 在项目中添加uploads文件夹,用来存放上传的文件。
一、进行完上面七步后项目的基本结构如下图:
二、test.jsp的代码如下:
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>文件批量上传</title>
<meta http-equiv="pragma" content="no-cache">
<meta http-equiv="cache-control" content="no-cache">
<meta http-equiv="expires" content="0">
<link href="<%=request.getContextPath()%>/css/default.css" rel="stylesheet" type="text/css" />
<link href="<%=request.getContextPath()%>/css/uploadify.css" rel="stylesheet" type="text/css" />
<script type="text/javascript" src="<%=request.getContextPath()%>/js/jquery-1.3.2.min.js"></script>
<script type="text/javascript" src="<%=request.getContextPath()%>/js/swfobject.js"></script>
<script type="text/javascript" src="<%=request.getContextPath()%>/js/jquery.uploadify.v2.1.0.min.js"></script>
<script type="text/javascript">
$(document).ready(function() {
$("#uploadify").uploadify({
'uploader' : 'js/uploadify.swf',
'script' : 'uploadDoc.jsp',
'cancelImg' : 'images/cancel.png',
'folder' : 'uploads',
'queueID' : 'fileQueue',
'fileDesc' : '请选择doc,docx,xls,xlsx文件',
'fileExt' : '*.doc;*.docx;*.xls;*.xlsx',
'sizeLimit' : 1024*1024*10,
'auto' : false,
'multi' : true,
'simUploadLimit' : 2,
'buttonText' : 'BROWSE'
});
});
</script>
</head>
<body>
<div id="fileQueue" ></div>
<input type="file" name="uploadify" id="uploadify" /> <br><br>
[url=javascript:jQuery('#uploadify').uploadifyUpload()]开始上传[/url]
[url=javascript:jQuery('#uploadify').uploadifyClearQueue()]取消所有上传[/url]
</body>
</html>
三、uploadDoc.jsp的代码如下:
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ page import="org.apache.commons.fileupload.*"%>
<%@ page import="org.apache.commons.fileupload.servlet.*"%>
<%@ page import="org.apache.commons.fileupload.disk.*"%>
<%@ page import="java.util.*"%>
<%@ page import="java.io.*"%>
<%
String savePath = this.getServletConfig().getServletContext().getRealPath("");
// 得到项目的工作目录
savePath = savePath + "/uploads/";
File f1 = new File(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) {
return;
}
Iterator<FileItem> it = fileList.iterator();
String name = "";
String extName = "";
while (it.hasNext()) {
FileItem item = 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 {
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);
%>
四、运行之后效果图如下:
五、 选择了三个文件后,点击开始上传,就可以看到uploads文件夹中会增加这两个文件。
上面的代码就简单实现了上传的功能,依靠函数uploadify实现,uploadify函数的参数为json格式,可以对json对象的key值的修改来进行自定义的设置,如multi设置为true或false来控制是否可以进行多文件上传,下面就来介绍下这些key值的意思:
uploader : uploadify.swf 文件的相对路径,该swf文件是一个带有文字BROWSE的按钮,点击后淡出打开文件对话框,默认值:uploadify.swf。
script : 后台处理程序的相对路径 。
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为“请选择doc,docx,xls,xlsx文件”,打开文件选择框效果如下图:
fileExt : 设置可以选择的文件的类型,格式如:'*.doc;*.docx;*.xls;*.xlsx' 。
sizeLimit : 上传文件的大小限制 。
simUploadLimit : 允许同时上传的个数 默认值:1 。
buttonText : 浏览按钮的文本,默认值:BROWSE 。
buttonImg : 浏览按钮的图片的路径 。
hideButton : 设置为true则隐藏浏览按钮的图片 。
rollover : 值为true和false,设置为true时当鼠标移到浏览按钮上时有反转效果。
width : 设置浏览按钮的宽度 ,默认值:110。
height : 设置浏览按钮的高度 ,默认值:30。
wmode : 设置该项为transparent 可以使浏览按钮的flash背景文件透明,并且flash文件会被置为页面的最高层。 默认值:opaque 。
cancelImg :选择文件到文件队列中后的每一个文件上的关闭按钮图标,如下图:
上面介绍的key值的value都为字符串或是布尔类型,比较简单,接下来要介绍的key值的value为一个函数,可以在选择文件、出错或其他一些操作的时候返回一些信息给用户。
onInit : 做一些初始化的工作。
onSelect :选择文件时触发,该函数有三个参数
• event:事件对象。
• queueID:文件的唯一标识,由6为随机字符组成。
• fileObj:选择的文件对象,有name、size、creationDate、modificationDate、type 5个属性。
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定义的目录中
[url=javascript:$('#uploadify').uploadifySettings('folder','JS');$('#uploadify').uploadifyUpload()]上传[/url]
uploadifyCancel:该函数接受一个queueID作为参数,可以取消文件队列中指定queueID的文件。
$('#uploadify').uploadifyCancel(id);
小结:
1、 如你想点击开始上传是需要进行一些验证操作:
(1)连接可如下:
(2)js验证:
2、scriptData参数
可提供URL传递参数。用来传递get参数。例如:
index.jsp?id=1&action=uploadify可以设置成:
‘script’: ‘index.jsp’,
‘scriptData’:{‘id’:1,’action’:'uploadify’},
注:要设置‘method’:‘GET’.
3、uploadifySettings可实现动态传参:
$("#uploadify").uploadifySettings("scriptData",{"name":$("#TextBoxNR").val(), "id": $("#Hidden_ID").val() });
4、script的后台处理程序可以是servlet的地址:
写script的路径时可以这样: 'script' : 'Upload',
5、引插件时的路径问题:
(1)路径要写全写对,否则js插件引不进来
(2)swfobject.js这个插件是用Jquery写的,存放路径中不能有javascript命名的目录,
即:不能是 src="<%=request.getContextPath()%>/javascript/swfobject.js”
引js插件时可以这样:
对上传的文档进行校验:
$(document).ready(function() {
$("#uploadify").uploadify({
'uploader' : '../resources/uploadfile/js/uploadify.swf', //uploadify.swf 文件的相对路径,默认值:uploadify.swf
// 'checkScript' :
// '../resources/uploadfile/checkDoc.jsp?clno=101',
// //用来判断上传选择的文件在服务器是否存在的后台处理程序的相对路径
'script' : '../resources/uploadfile/uploadDoc.jsp', //后台处理程序的相对路径
// 'scriptData' : {"clno" : $("#newclno").val()},
// //传参,使用scriptData需要先设置'method' : 'GET'
'cancelImg' : '../resources/uploadfile/images/cancel.png', //选择文件到文件队列中后的每一个文件上的关闭按钮图标
'folder' : '', //上传文件存放的目录,此处可以在后台认为设置
// 'method' : 'Get', //提交方式Post 或Get 默认为Post
'queueID' : 'fileQueue', //文件队列的ID,该ID与存放文件队列的div的ID一致
'fileDesc' : '请选择doc,docx,xls,xlsx文件', //这个属性值必须设置fileExt属性后才有效,用来设置选择文件对话框中的提示文本
'fileExt' : '*.doc;*.docx;*.xls;*.xlsx', //设置可以选择的文件的类型,格式如:'*.doc;*.xls'
'queueSizeLimit' : 100, //当允许多文件生成时,设置选择文件的个数,默认值:999
'auto' : false, //设置为true当选择文件后就直接上传了,为false需要点击上传按钮才上传
'multi' : true, //设置为true时可以上传多个文件
'sizeLimit' : 1024*1024*10, //上传文件的大小限制,单位为字节
'simUploadLimit' : 2, //允许同时上传的个数 默认值:1
// 'onInit' : function(){alert("1");}, //做一些初始化的工作
'onSelect' : function(event, queueID, fileObj) { //选择文件时触发
saveDocName(fileObj.name);
// $("#uploadify").uploadifySettings('scriptData',
// {"clno" : $("#newclno").val()});
// //可以动态修改上面的那些key值
$("#uploadify").uploadifySettings('script', '../resources/uploadfile/uploadDoc.jsp?clno='+$("#newclno").val());
},
//'onSelectOnce' : function(event,data){ alert("您共选择了"+data.fileCount+"个文件!");}, //在单文件或多文件上传时,选择文件时触发
// 'onOpen' : function(event,queueId,fileObj){}
// //点击上传时触发,如果auto设置为true则是选择文件时触发,如果有多个文件上传则遍历整个文件队列
// 'onComplete' :
// function(event,queueId,fileObj,response,data){}
// //文件上传完成后触发,每个文件上传完成后就会触发
'onAllComplete' : function(event, data) { //文件队列中所有的文件上传完成后触发
alert("上传的文件个数:" + data.filesUploaded + "\r\n" +
"出现错误的个数:" + data.errors + "\r\n" +
"文件大小:" + data.allBytesLoaded
);
reDnameString();
},
'onCancel' : function(event,queueId,fileObj,data) { //当点击文件队列中文件的关闭按钮或点击取消上传时触发
// alert("删除:"+fileObj.name);
cancelDoc(fileObj.name);
},
'buttonText' : 'BROWSE' // 浏览按钮的文本,默认值:BROWSE。暂不支持中文,若要用中文,可使用buttonImg属性
// 'buttonImg' : '', //浏览按钮的图片的路径 。
// 'hideButton' : '', //设置为true则隐藏浏览按钮的图片 。
// 'rollover' : true //值为true和false,设置为true时当鼠标移到浏览按钮上时有反转效果。
});
});
var saveDoc = new Array(); // 暂存文件的名称的数组
var conflictDoc = new Array(); // 暂存与数据库冲突的文件
function saveDocName(dname){ //将上传的文件队列保存到暂存数组saveDoc中
saveDoc.push(dname); // 入栈操作
}
function cancelDoc(cancelName) { //取消队列中的上传文件时将暂存数组saveDoc中相应的值删除
var count = saveDoc.length; // 获取暂存文件的个数
var index;
for(var i=0; i < count; i++ ){
var doc = saveDoc[i];
if(cancelName == doc) {
index = i; // 查找到删除的文件所在的位置
}
}
saveDoc.splice(index,1); // 删除下标为index的元素
var newCount = saveDoc.length; // 获取暂存文件的个数
if(newCount > 0) {
saveConflict(newCount); //判断是否有冲突并将冲突文件保存到暂存数组saveConflict
var conflictCount = conflictDoc.length; // 获取冲突文件的个数
if(conflictCount > 0) {
handleConflict(conflictCount); //处理冲突
} else {
document.getElementById("conflict").innerHTML = "";
}
} else {
document.getElementById("conflict").innerHTML = ""; // 若将上传列表清空了,则将校验信息清空
}
}
function checkConflict(){ //点击校验按钮时检查是否有冲突,并将冲突的文件保存到conflictDoc数组中
var clno = null;
clno = $("#clno").val();
if(clno.length > 0) {
var count = saveDoc.length; // 获取暂存文件的个数
if(count > 0) {
saveConflict(count); //判断是否有冲突并将冲突文件保存到暂存数组saveConflict
var conflictCount = conflictDoc.length; // 获取冲突文件的个数
if(conflictCount > 0) {
handleConflict(conflictCount); //处理冲突
} else {
document.getElementById("conflict").innerHTML = ""; // 将校验信息清空
alert("经校验没有冲突,请上传!");
}
} else {
document.getElementById("conflict").innerHTML = ""; // 将校验信息清空
alert("请先选择上传的文件!");
}
} else {
alert("请先选择上传文件的归属目录!");
}
}
function saveConflict(count) { //判断是否有冲突并将冲突文件保存到暂存数组saveConflict
conflictDoc = []; // 将冲突数组清空
var jsonStr = document.getElementById("formAdd:dnameString").value; // 获取文件种类下的文档字符串
jsonStr = eval(jsonStr); // 将字符串转换为json字符串格式
for(var i=0; i < count; i++ ){
var doc = saveDoc[i]; // 取出暂存的文件名
var isConflict; // 冲突文件名
for(var j=0; j < jsonStr.length; j++) {
isConflict = jsonStr[j].dname; // 取出json串中的文档名称
if(doc == isConflict) {
conflictDoc.push(doc); // 若文件冲突,将冲突的文件名保存下来
}
}
}
}
function handleConflict(conflictCount) { //处理冲突
document.getElementById("conflict").innerHTML = "";
var divdev = document.getElementById("conflict");
var table = document.createElement("table"); //创建table
table.setAttribute("style","width:95%;border: 1px solid red;");
for(var i=0; i < conflictCount; i++) { //将冲突文件显示在页面上
var tr = document.createElement("tr");
var td = document.createElement("td");
td.setAttribute("style","width:70%;");
var span = document.createElement("span");
span.setAttribute("style","color:red;");
span.innerHTML = conflictDoc[i];
td.appendChild(span);
var td2 = document.createElement("td");
td2.setAttribute("style","width:30%;");
var span2 = document.createElement("span");
span2.setAttribute("style","color:red;");
span2.innerHTML = "若上传将会覆盖原文件!";
td2.appendChild(span2);
tr.appendChild(td);
tr.appendChild(td2);
table.appendChild(tr);
}
divdev.appendChild(table);
}
function check() { //点击上传按钮时进行非空校验,上传后将暂存数组saveDoc,conflictDoc清空
var clno = null;
clno = $("#clno").val();
if(clno.length > 0) {
var count = saveDoc.length; // 获取暂存文件的个数
if(count > 0) {
$('#uploadify').uploadifyUpload();
} else {
alert("请先选择上传的文件!");
}
} else {
alert("请先选择上传文件的归属目录!");
}
}
function reDnameString() { //上传完成后清空暂存数组,并刷新json串dnameStrin
document.getElementById("conflict").innerHTML = ""; //上传完成后将冲突列表清空
saveDoc = []; // 上传后将暂存的数组清空
conflictDoc = []; // 上传后将冲突数组清空
document.getElementById("formAdd:uploadAfter").click(); //刷新dnameString的值
}
页面上的按钮:
1.校验按钮:
<a4j:commandLink value=" 校验" style="color:red;font-family:黑体;font-size:15px;" οnclick="checkConflict();"/>
2.确认按钮:
<h:commandButton type="button" value="确认上传" οnclick="return check();" />
3.上传完后刷新页面上保存数据库中已有文件的json串dnameString:
<h:inputHidden id="dnameString" value="#{klbInfoRegBaseBean.dnameString}"/>
<a4j:commandLink id="uploadAfter" actionListener="#{klbInfoRegBaseBean.selectDocList}" reRender="dnameString">
<a4j:actionparam name="paraminfo" value="document.getElementById('clno').value" assignTo="#{klbInfoRegBaseBean.clno}" noEscape="true"/>
</a4j:commandLink>
4.显示冲突信息的div:
<div id="conflict"></div>
5.文档区域及隐藏区域:
<div id="fileQueue" ></div>
<input type="file" name="uploadify" id="uploadify" />
<input id="clno" type="hidden" value="" />
<input id="newclno" type="hidden" value="" />
<input id="dname" type="hidden" value="" />