swfupload多文件上传控件的使用

时间:2022-04-23 04:53:13

         swfupload是一个基于flash的多文件上传组件,前端是采用javascript脚本编写的,它与flash脚本进行交互,以实现多文件的上传功能。因前端是js脚本,所以在做web页面集成时很方便,以下通过对swfupload自带的demo进行一些修改,以实现简单的多文件上传功能。然后再简单介绍下,通过修改js源码,以满足不同的个性化需要。

         swfupload目前的最新版本是v2.2.0.1,其官方源码地址:http://code.google.com/p/swfupload/,demo在线演示地址:http://demo.swfupload.org/v220/index.htm。该页面提供了多种上传演示界面,以适应不同的应用场景,这里不一一介绍。下载源码和demo的例子之后,在samples包中有demos和samples两个子文件夹。打开demos子目录,其下包含多个demo,因源码中的demo都是采用的php编写的,在这里,我们以multiinstancedemo作为模版,对其进行简单的改造,实现一个java编写的多文件上传的功能。

        首先介绍下demo的目录结构,在multiinstancedemo中包含如下文件:

swfupload多文件上传控件的使用

        js目录中包含两个js文件:fileprogress.js和handlers.js,这两个文件的作用从名字上就能大概知道一些了,fileprogress.js主要是用来控制文件上传时的进度条显示的功能,而handlers.js则是配合fileprogress.js对文件上传时的各种处理功能。

swfupload多文件上传控件的使用

       其中,index.php是用于显示上传组件的前端页面,upload.php则是当index.php页面点击上传按钮之后,将文件上传进行处理的页面。js目录里的两个js文件则是在index.php页面中引用的两个js文件,最后那个图片资源文件,则是一个表示不同状态下的上传按钮。注意,这里仅介绍了multiinstancedemo目录下的文件,它们仅仅是一些前端处理的功能,真正的核心并不在这里,所以在该项目中,还需要其他的几个资源文件才能实现多文件上传的功能。通过打开index.php文件可以看到它还引用了其他的一些核心资源,从以下代码中就能看出来。

swfupload多文件上传控件的使用swfupload多文件上传控件的使用

        从以上代码中,我们可以看到,除了上面介绍的fileprogress.js和handlers.js文件之外,还有swfuoload.js、swfupload.queue.js,这两个文件则是与上传相关的功能了,比如前期验证,上传文件的个性化设置等等功能。除了js文件,还有一个css样式文件,控制页面以及控制条的显示样式等,这里就不作详细介绍。最后,剩下最重要的两个flash控件swfupload.swf和swfupload_fp9.swf,它们表示支持不同的flash版本,具体的介绍请看官方文档。但是swfupload也有个限制,不支持低于某个版本的flash,实际使用该控件时,一旦检测到低于该版本时,将会弹出相应的提示。

       在这里再多说一句,以上仅仅是介绍了multiinstancedemo需要的必备文件,实际上,swfupload的不同demo中使用的文件不尽相同。因此,其他的文件功能在本文中不作介绍,欲知详情,请自行阅读官方文档。好了,言归正传, 既然已经知道一个完整的多文件上传需要哪些必备的控件,接下来就是动手改造项目的过程了。首先新建一个java的web项目,然后将上面提到的几个资源文件在webcontent中部署好,包括index.php和upload.php文件。然后将index.php改成index.jsp,并修改其源码,将php部分的源码都删掉,仅留下html代码即可。示例代码如下:

<%@ page language="java" contentType="text/html; charset=utf-8"
pageEncoding="utf-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>SWFUpload Demos - Multi-Instance Demo</title>
<link href="css/default.css" rel="stylesheet" type="text/css" />
<script type="text/javascript" src="swfupload/swfupload.js"></script>
<script type="text/javascript" src="swfupload/swfupload.queue.js"></script>
<script type="text/javascript" src="js/fileprogress.js"></script>
<script type="text/javascript" src="js/handlers.js"></script>
<script type="text/javascript">
var upload1;

window.onload = function() {
upload1 = new SWFUpload({
// Backend Settings
upload_url : "upload.jsp",
post_params : {
"PHPSESSID" : "123456"
},

// File Upload Settings
file_size_limit : "10000",
file_types : "*.*",
file_types_description : "All Files",
file_upload_limit : 5, // 上传文件的总个数
file_queue_limit : 0, // 每次能上传的文件个数

// Event Handler Settings (all my handlers are in the Handler.js file)
swfupload_preload_handler : preLoad,
swfupload_load_failed_handler : loadFailed,
file_dialog_start_handler : fileDialogStart,
file_queued_handler : fileQueued,
file_queue_error_handler : fileQueueError,
file_dialog_complete_handler : fileDialogComplete,
upload_start_handler : uploadStart,
upload_progress_handler : uploadProgress,
upload_error_handler : uploadError,
upload_success_handler : uploadSuccess,
upload_complete_handler : uploadComplete,

// Button Settings
button_image_url : "XPButtonUploadText_61x22.png",
button_placeholder_id : "spanButtonPlaceholder1",
button_width : 61,
button_height : 22,

// Flash Settings
flash_url : "swfupload/swfupload.swf",
flash9_url : "swfupload/swfupload_fp9.swf",

custom_settings : {
progressTarget : "fsUploadProgress1",
cancelButtonId : "btnCancel1"
},

// Debug Settings
debug : false
});

}
</script>
</head>
<body>
<div id="header">
<h1 id="logo">
<a href="./">SWFUpload</a>
</h1>
<div id="version">v2.5.0</div>
</div>
<div id="content">
<h2>Multi-Instance Demo</h2>
<form id="form1" action="index.jsp" method="post"
enctype="multipart/form-data">
<p>This page demonstrates how multiple instances of SWFUpload can
be loaded on the same page. It also demonstrates the use of the
graceful degradation plugin and the queue plugin.</p>
<table>
<tr valign="top">
<td>
<div>
<div class="fieldset flash" id="fsUploadProgress1">
<span class="legend">Large File Upload Site</span>
</div>
<div style="padding-left: 5px;">
<span id="spanButtonPlaceholder1"></span> <input id="btnCancel1"
type="button" value="Cancel Uploads"
onclick="cancelQueue(upload1);" disabled="disabled"
style="margin-left: 2px; height: 22px; font-size: 8pt;" /> <br />
</div>
</div>
</td>
</tr>
</table>
</form>
</div>
</body>
</html>

这里简要介绍下代码中的几个要点:

upload_url : "upload.jsp", 上传文件的后台处理url,这里就是upload.jsp。如果是采用的j2ee,这里可以是具体的链接或者相对路径,比如http://xxx/xxx/upload.do等等。

post_params : {"PHPSESSID" : "123456"}, 提交的url时,可附带一些参数。

// File Upload Settings
file_size_limit : "10000", 文件上传的大小限制,0表示无限制。
file_types : "*.*", 文件上传的格式限制,当前表示无限制。
file_types_description : "All Files",  上传的文件描述。
file_upload_limit : 5,  上传文件的总个数。
file_queue_limit : 0,   每次能上传的文件个数,0表示无限制,但是他会受到上传总个数的限制。

以下是一些事件的设置,这些方法都在handlers.js中,这里我们不对其修改。
// Event Handler Settings (all my handlers are in the Handler.js file)
swfupload_preload_handler : preLoad,
swfupload_load_failed_handler : loadFailed,
file_dialog_start_handler : fileDialogStart,
file_queued_handler : fileQueued,
file_queue_error_handler : fileQueueError,
file_dialog_complete_handler : fileDialogComplete,
upload_start_handler : uploadStart,
upload_progress_handler : uploadProgress,
upload_error_handler : uploadError,
upload_success_handler : uploadSuccess,
upload_complete_handler : uploadComplete,

// Button Settings
button_image_url : "XPButtonUploadText_61x22.png", 上传按钮的图片
button_placeholder_id : "spanButtonPlaceholder1",  上传按钮的id值,与下面的html代码相关联
button_width : 61,  按钮宽度
button_height : 22,  按钮的高度

以下是对flash版本的设置
// Flash Settings
flash_url : "swfupload/swfupload.swf",
flash9_url : "swfupload/swfupload_fp9.swf",

以下是对上传进度条的设置
custom_settings : {
progressTarget : "fsUploadProgress1",  与上面的上传按钮一样,该值与html相关联
cancelButtonId : "btnCancel1"  取消上传的按钮,与html相关联
},

// Debug Settings
debug : false  swfupload支持debug的模式


         接下来,我们编写上传的文件处理代码,也就是把上传的文件存入本地服务器的代码,java中实现的方式有很多种,比如使用smartupload或者是其他的方式都可以,这里只列出涉及到swfupload的部分:

                        // 获取上传的文件
MultipartHttpServletRequest multipartRequest = (MultipartHttpServletRequest) request;

// 参数Filedata是表单的名字,在swfupload.js中this.ensureDefault("file_post_name", "Filedata");
MultipartFile multipartFile = multipartRequest.getFile("Filedata");

String fileName = multipartFile.getOriginalFilename();
……
将得到的文件流存入本地服务器

        上面的注释已经解释得很清楚了,multipartRequest.getFile("Filedata");中的参数需要获取上传文件的表单的名字。通常,我们在定义上传文件的表单时,一般都是这样写:<input type="file" name="fileName" />请选择要上传的文件,这里的表单名字就是fileName。而在index.jsp中,按钮是引用的id占位的方式,在js上也没有显式定义表单名,所以通过源码,我们可以看到表单的名字在swfupload.js中的默认定义:this.ensureDefault("file_post_name", "Filedata");。因此,方法中的参数就是FileData,当然,如果在index.jsp中显式定义该表单的名字,则方法中应该填写修改过后的名字。显式定义的方法很简单,在index.jsp的js部分,我们把该属性定义在upload_url : "upload.jsp",代码之后,具体位置没有限制,只要定义在new SWFUpload()之中就可以,如:file_post_name: "fileName",就这么一行代码就完成了显式定义。

        按照上面的步骤完善过后,一个简单的多文件上传功能基本大功告成了。接下来再简单介绍下swfupload的其他几个方面,其实,swfupload的多文件上传,仅仅是可以选择多个文件,但是在上传的处理过程中,它是每上传一个文件就调用一次upload.jsp页面。可以做一个简单的测试,通过multipartFile对象可以获取上传文件的个数,或者是将

String fileName = multipartFile.getOriginalFilename();中定义的fileName打印出来,结果是只有一个文件。

        在上面的例子中,我们并没有将服务器端的处理结果返回给前端页面,而swfupload是支持返回服务器端的结果给前端的。服务器端返回的数据保存在handlers.js中的uploadSuccess(file, serverData)方法中的serverData参数中。这里需要注意,上传的处理页面的返回数据应尽量简单,如果处理页面是一个带有html标签的页面,那么将同时返回这些标签字段。既然是处理页面,那么无须用户访问该页面。因此,如无特殊要求,处理页面应尽可能避免加入html标签,仅添加java代码即可,如下是例子:

<%@ page language="java" contentType="text/html; charset=utf-8"
pageEncoding="utf-8"%>
<%
response.getWriter().write("返回给客户端的值");
%>

如果请求url是个jsp,则可以直接使用out.println("返回值")作为输出语句。

         swfupload在上传文件时,会以进度条的方式显示当前文件显示的进度,以及上传的结果。进度条中的内容可以定制,比如可以显示上传速率,已上传大小,文件大小,上传所需时间等等功能。如果是多个文件同时上传,则当上传完成之后,隔几秒钟,该进度条会被后面的进度条覆盖。这里就有一个问题,如果上传失败的文件,我们需要提示用户该文件上传失败,以及上传失败的原因。但swfupload默认并没有这样,它不管你成功失败,每个进度条在指定的时间间隔后就被后面的进度条覆盖了。我们通过修改源码以满足定制需求,在fileprogress.js中,找到FileProgress.prototype.setError = function () {}这段代码,将如下代码屏蔽即可:

var oSelf = this;
this.setTimer(setTimeout(function () {
oSelf.disappear();
}, 10000));

       最后,因为swfupload是国外的开源控件,所以,如果想给用户展示中文的提示,那就需要用户自己去汉化。