step-by-step多文件WEB批量上传(swfupload)的完美解决方案

stephen830

浏览: 3010584 次
性别:
来自: 上海

最近访客更多访客>>

jAmEs_

wangzhigang2

Z865785437029

sampou

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

博客分类：

java

Web Flash IE JSP Firefox

★★★ 本篇为原创，需要引用转载的朋友请注明：《 http://stephen830.iteye.com/blog/255583 》谢谢支持！ ★★★

功能完全支持ie和firefox浏览器！同样也支持safari浏览器！

一般的WEB方式文件上传只能一个一个的进行上传，在某些应用上就显得很不人性化，客户们都希望能够1次选择很多文件，然后让系统把选择的文件全部上传。

这里，就将针对这个问题提出一个比较完美的解决方案，利用的技术主要有2个：Flash 和 smartupload。Flash 能够让客户一次选择多个文件，而smartupload负责将选择的文件上传到服务器上。

有些朋友看到这里，就知道了，其实就是swfupload方法，具体信息可以访问swfupload官方网站：http://www.swfupload.org/

让我们先来看看客户端的界面效果图。（多选文件，批量上传，上传进度显示）

要做到图中的效果，其实很方便，看完下面的描述，相信大家都可以实现上图中的效果了。
说明：swfupload2中通过一个png图片与flash插件进行关联，可以修改images下的png图片来（如上图中的[选择文件]图片）自定义显示自己想要的图片样子（不要修改图片名字和格式）。

如果你用的不是java环境，不要紧，只要稍作修改，同样可以使用在其他的环境中。

第1步，要进行下面的过程，必须先准备好Flash插件和smartupload。
Flash插件:相信大家的浏览器早已经安装过了，请检查版本，尽量使用最新的的flash插件。

smartupload:大家可以去看看我的另一篇文章 [上传下载组件SmartUpload使用方法] http://stephen830.iteye.com/blog/255010 里面详细讲述了使用方法，并且提供了具体java类的下载。请先熟悉smartupload，然后再开始下面的步骤。

第2步，前台部分准备客户操作的WEB界面，如下[UploadFileExample.jsp、UploadFileExampleSubmit.jsp]

（关于参数 upload_url: "<%=uploadUrl.toString()%>",
要注意提交文件路径，最好用http://.../UploadFileExample.jsp格式的完整路径，即像我例子中写的那样）

UploadFileExample.jsp

<%@ page contentType="text/html;charset=UTF-8"%>
<%
    double perMaxSize = 1.5;//单个文件允许的max大小
    String sizeUnit = "MB";//perMaxSize数据对应的单位
    String ext = "*.jpg;*.jpeg;*.gif";//允许上传的文件类型
    //文件上传提交的目标页面
	StringBuffer uploadUrl = new StringBuffer("http://");
	uploadUrl.append(request.getHeader("Host"));
	uploadUrl.append(request.getContextPath());
	uploadUrl.append("/admin/swfuploadexample/UploadFileExampleSubmit.jsp");
%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>批量相片上传</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link href="css/default.css" rel="stylesheet" type="text/css" />
<script type="text/javascript" src="js/swfupload.js"></script>
<script type="text/javascript" src="js/swfupload.swfobject.js"></script>
<script type="text/javascript" src="js/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 swfu;

SWFUpload.onload = function () {
	var settings = {
		flash_url : "js/swfupload.swf",
		upload_url: "<%=uploadUrl.toString()%>",
		post_params: {
			"user_id" : "stephen830",
			"pass_id" : "123456"
		},
		file_size_limit : "<%=perMaxSize%> <%=sizeUnit%>",
		file_types : "<%=ext%>",
		file_types_description : "<%=ext%>",
		file_upload_limit : 100,
		file_queue_limit : 0,
		custom_settings : {
			progressTarget : "fsUploadProgress",
			cancelButtonId : "btnCancel",
			uploadButtonId : "btnUpload",
			myFileListTarget : "idFileList"
		},
		debug: false,
		auto_upload:false,

		// Button Settings
		button_image_url : "images/XPButtonUploadText_61x22.png",	// Relative to the SWF file
		button_placeholder_id : "spanButtonPlaceholder",
		button_width: 61,
		button_height: 22,

		// The event handler functions are defined in handlers.js
		swfupload_loaded_handler : swfUploadLoaded,
		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,
		queue_complete_handler : queueComplete,	// Queue plugin event
		
		// SWFObject settings
		minimum_flash_version : "9.0.28",
		swfupload_pre_load_handler : swfUploadPreLoad,
		swfupload_load_failed_handler : swfUploadLoadFailed
	};

	swfu = new SWFUpload(settings);
}

</script>
</head>
<body bgcolor="#FCFCFC" topmargin="0px" leftmargin="10px" rightmargin="10px" scroll="yes">
<table width="100%" cellspacing="4" cellpadding="4" border="0" bgcolor="#FCFCFC">
	<tr> 
	<td class="DH1">
	<table width="100%" cellspacing="4" cellpadding="4" border="0" bgcolor="#FCFCFC">
	<tr>
	<td class="DH2">
	<STRONG>批量上传相片 （支持的相片类型：<%=ext%>；单个相片最大不能超过：<%=perMaxSize%> <%=sizeUnit%>）</STRONG> 
	</td><td class="DH2" align="right"></td>
	</tr>
	</table>
<div id="content">
	<form id="form1" action="UploadFileExampleSubmit.jsp" method="post" enctype="multipart/form-data">
		<table width="90%" cellspacing="0" cellpadding="0" border="0"><tr><td>
		<span id="spanButtonPlaceholder"></span>
		<input id="btnUpload" type="button" value="上传相片" class="btn" />
		<input id="btnCancel" type="button" value="取消全部上传" disabled="disabled" class="btn" /></td>
		</tr></table>
		<table id="idFileList" class="uploadFileList"><tr class="uploadTitle"><td><B>文件名</B></td><td><B>文件大小</B></td><td width=100px><B>状态</B></td><td width=35px>&nbsp;</td></tr></table>
		等待上传 <span id="idFileListCount">0</span> 个 ，成功上传 <span id="idFileListSuccessUploadCount">0</span> 个
		<div id="divSWFUploadUI" style="visibility: hidden;"></div>
		<noscript style="display: block; margin: 10px 25px; padding: 10px 15px;">
			很抱歉，相片上传界面无法载入，请将浏览器设置成支持JavaScript。
		</noscript>
		<div id="divLoadingContent" class="content" style="background-color: #FFFF66; border-top: solid 4px #FF9966; border-bottom: solid 4px #FF9966; margin: 10px 25px; padding: 10px 15px; display: none;">
			相片上传界面正在载入，请稍后...
		</div>
		<div id="divLongLoading" class="content" style="background-color: #FFFF66; border-top: solid 4px #FF9966; border-bottom: solid 4px #FF9966; margin: 10px 25px; padding: 10px 15px; display: none;">
			相片上传界面载入失败，请确保浏览器已经开启对JavaScript的支持，并且已经安装可以工作的Flash插件版本。
		</div>
		<div id="divAlternateContent" class="content" style="background-color: #FFFF66; border-top: solid 4px #FF9966; border-bottom: solid 4px #FF9966; margin: 10px 25px; padding: 10px 15px; display: none;">
			很抱歉，相片上传界面无法载入，请安装或者升级您的Flash插件。
			请访问： <a href="http://www.adobe.com/shockwave/download/download.cgi?P1_Prod_Version=ShockwaveFlash" target="_blank">Adobe网站</a> 获取最新的Flash插件。
		</div>
	</form>
</div>
</td></tr></table>
</body>
</html>

UploadFileExample.jsp对应的处理页面 --> UploadFileExampleSubmit.jsp

(1)请确保已经看完我的另一篇文章（上传下载组件SmartUpload使用方法 http://stephen830.iteye.com/admin/blogs/255010），先搞好这个才能开始下面的操作
(2)写一个对应上传方法类，com.soft4j.bo.PhotoMgr.java，其中的方法就是文章下面提到的public static String fileUpload(SmartUpload su,PageContext pageContext) throws Exception {...}

这2点弄好了,ok，可以继续。（如果没有准备java文件，下面的UploadFileExampleSubmit.jsp会报错）

注意在（UploadFileExampleSubmit.jsp）中：上传成功后必须返回“successed”，失败的话则返回失败的原因。

<%@ page contentType="text/html;charset=UTF-8"%><%@ page import="com.soft4j.httpupload4j.SmartUpload"%><%@ page import="com.soft4j.bo.PhotoMgr"%><%
	String pageErrorInfo = null;
	SmartUpload su = null;
	try{
		su = new SmartUpload();
		su.initialize(pageContext);
		su.upload();
		pageErrorInfo = PhotoMgr.fileUpload(su,pageContext);
		if(pageErrorInfo==null){
			out.print("successed");
		}
	}catch(Exception e){
		pageErrorInfo = e.getMessage();
	}finally{
		su = null;
		if(pageErrorInfo!=null){
			out.print(pageErrorInfo);
		}
	}
%>

第3步准备后台的文件上传功能。也就是上面文件[UploadFileExampleSubmit.jsp]中用到的[PhotoMgr.fileUpload(su,pageContext)]方法。

/**
	 * 文件上传方法.
	 * @param su
	 * @param pageContext
	 * @return
	 * @throws Exception
	 */
	public static String fileUpload(SmartUpload su,PageContext pageContext) throws Exception {
	    com.soft4j.httpupload4j.File suFile = null;
	    int fileCount = 0;
	    try {
	    	//获取传递过来的参数
	    	String userId = su.getRequest().getParameter("user_id");
	    	String passId = su.getRequest().getParameter("pass_id");

	        String fileExt = "";
	        int fileSize = 0;
	        String AllowedExtensions = ",jpg,jpeg,gif,";//允许上传的文件类型
	        double maxFileSize = 1.5*1024;//单文件最大大小，单位KB
	        //校验文件类型和大小
	        for (int i=0; i<su.getFiles().getCount();i++) {
	            suFile = su.getFiles().getFile(i);
	            if (suFile.isMissing())
	                continue;
	            //校验文件大小
	            fileSize = suFile.getSize()/1024;//字节转换成KB
	            if(fileSize==0) fileSize=1;
	            if(maxFileSize<fileSize) throw new Exception("单个上传相片的容量不能超过["+maxFileSize+"KB]");
	
	            //校验文件类型
	            if (suFile.getFileExt() == null
	                    || "".equals(suFile.getFileExt())) {
	                fileExt = ",,";
	            } else {
	                fileExt = "," + suFile.getFileExt().toLowerCase() + ",";
	            }
	            if (!"".equals(AllowedExtensions)
	                    && AllowedExtensions.indexOf(fileExt) == -1) {
	                throw new Exception("您上传的文件[" + suFile.getFileName()
	                        + "]的类型为系统禁止上传的文件类型，不能上传！");
	            }
	            fileCount++;
	        }
	        if (fileCount==0) throw new Exception("请选择上传的文件");
	        //准备保存文件
	        String filePath="D:\\tomcat\\webapps\\test\\photo\\";//这里填写项目中存放上传文件的物理路径
	        for (int i=0; i<su.getFiles().getCount();i++) {
	            suFile = su.getFiles().getFile(i);
	            suFile.saveAs(filePath+suFile.getFileName(),SmartUpload.SAVE_PHYSICAL);//保存文件
	        }
	        //成功返回null
	        return null;
	    } finally {
	    	//
	    }
	}

备注：关于jsp页面和java方法我不做过多的说明了，应该已经比较清楚了。

本文自发布后，受到了很多朋友的关注，也为不少的朋友提供了帮助，我很高兴。
下面将朋友们遇到的一些问题作汇总后需要注意的一些地方列了出来：

<1> 功能实现需要flash插件支持。
flash版本为 flash 9.0.124 或者 flash 10.0.12.36 版本（这是最新的flash10插件）. 如果不是的话，可以去flash官网 http://www.adobe.com/shockwave/download/download.cgi?P1_Prod_Version=ShockwaveFlash 进行在线安装。

<2> UploadFileExample.jsp 中的 upload_url参数设置。
参数需要使用 http://....../UploadFileExampleSubmit.jsp 这样的完整路径.

<3> 关于获取参数 post_params中的参数值。
post_params: {"user_id" : "stephen830","pass_id" : "123456"} 中的参数，不能使用普通的request.getParameter("")方法来获取，
而必须用你的上传方法对应的特定方法来获取，比如，我这里用smartupload，则获取方法就是String userId = su.getRequest().getParameter("user_id");

<4> 上传后不管成功还是失败，都需要有返回值。
这个返回值将传递到对应js中。返回值在UploadFileExampleSubmit.jsp中设置，成功则 out.print("successed"); 失败则 out.print(pageErrorInfo);//pageErrorInfo为错误信息。

该返回值将传递给js目录下的handlers.js文件，具体的方法是 function uploadSuccess(file, serverData) {...} 。

有些朋友的上传成功后out.print("successed"); 发现js收到的"successed"前面会有隐藏字符，遇到这种情况可以更改function uploadSuccess(file, serverData) {...} 中的
var isSuccess = (serverData.indexOf("successed")==0?true:false);
改为
var isSuccess = (serverData.indexOf("successed")>-1?true:false);
就可以了。

<5> 附件中增加一个完整的测试功能例子。
附件名 PROJECT_swfupload.zip 下载 http://stephen830.iteye.com/upload/attachment/53105/e0e90839-a760-3adb-acdd-aa3b972d090c.zip

附录：swfupload 文件批量上传压缩包 swfupload.zip（支持最新的flash10插件） （附件中没有java类，请自己准备1个java类，将上面的方法复制进去）

为方便了解和调试功能，在附件中增加了一个完整的工程Example，附件名（PROJECT_swfupload.zip），大家可以直接使用来测试功能。

最后感谢朋友 flyfan，taiwei 对本篇的建议！
-------------------------------------------------------------
分享知识分享快乐,分享知识，分享快乐，希望文章能给需要的朋友带来小小的帮助。

swfupload.zip (44.4 KB)
下载次数: 3373

PROJECT_swfupload.zip (99.3 KB)
下载次数: 3659

查看图片附件

64
顶

4
踩

分享到：

感谢朋友们在阅读文章的时候能为我指出毛病 ... | java生成条形码

2008-10-21 06:50
浏览 41887
评论(153)
分类:企业架构
查看更多

13 楼 stephen830 2008-10-23

yiminghe 写道

以后不能再用这种方法了，其实很简单动态生成 file标签就可以了

首先感谢上面朋友的意见!

其实我写文章的目标,是让大家都能看得懂,都能从中学习到东西.只要你是刚学的新手,你也看得懂.不需要额外的技术.不能为了看懂这个,还要去了解其他的东西.至于这个自己怎么操作和更好的优化实现,可以自己控制.

12 楼 yiminghe 2008-10-23

以后不能再用这种方法了，其实很简单

动态生成 file标签就可以了

11 楼 anreddy 2008-10-22

收藏先！慢慢再看！

10 楼 stephen830 2008-10-21

flyfan 写道

引用
Adobe Flash Player 10.0.12.36&nbsp; 我安装了这个了.. 还是不行呢...加我QQ吧 27465487Adobe Flash Player 10好像已经不支持swfupload了，换9.0的吧详情请看：http://www.iteye.com/news/3652-javascript-and-flash-10-interactive-bad-news

非常感谢flyfan朋友的指出，想不到新的flash10插件已经不再支持此项了，真是很遗憾。要实现此功能的朋友可以安装我文章附件中的flash9.0.123插件。

9 楼 flyfan 2008-10-21

引用

Adobe Flash Player 10.0.12.36  我安装了这个了.. 还是不行呢...加我QQ吧 27465487

Adobe Flash Player 10好像已经不支持swfupload了，换9.0的吧
详情请看：http://www.iteye.com/news/3652-javascript-and-flash-10-interactive-bad-news

8 楼 stephen830 2008-10-21

kyunghao 写道

Adobe Flash Player 10.0.12.36  我安装了这个了.. 还是不行呢...加我QQ吧 27465487

你的插件已经是最新的了，可能浏览器的设置有问题，我你先换朋友的机器试下。

7 楼 kyunghao 2008-10-21

可以了~~~OK 了谢谢!

6 楼 xinyuexiaodi 2008-10-21

SmartUpload 性能要差一些，建议用commons-fileupload.jar,commons-io.jar

5 楼 kyunghao 2008-10-21

Adobe Flash Player 10.0.12.36 我安装了这个了.. 还是不行呢...加我QQ吧 27465487

4 楼 stephen830 2008-10-21

kyunghao 写道

现在可以了..可还有一个问题,单机选择图片按钮的话~~总出现
相片上传界面载入失败，请确保浏览器已经开启对JavaScript的支持，并且已经安装可以工作的Flash插件版本。  
为什么呢?

造成的原因可能是你的Flash插件不是9.0版本。请先卸载你的flash，安装最新的flash插件

3 楼 kyunghao 2008-10-21

2 楼 stephen830 2008-10-21

kyunghao 写道

<%@ page import="com.soft4j.httpupload4j.SmartUpload"%>
<%@ page import="com.soft4j.bo.PhotoMgr"%>
在JSP中这二个出现错误怎么回事呢???

关于 com.soft4j.httpupload4j.SmartUpload ，请看看我的另一篇文章（上传下载组件SmartUpload使用方法 http://stephen830.iteye.com/admin/blogs/255010），先搞好这个才能开始本篇

关于com.soft4j.bo.PhotoMgr ，请自己写个对应的PhotoMgr.java类，方法就是文章中说到的
public static String fileUpload(SmartUpload su,PageContext pageContext) throws Exception {...}
这2点弄好了，就一切ok了。

1 楼 kyunghao 2008-10-21

<%@ page import="com.soft4j.httpupload4j.SmartUpload"%>
<%@ page import="com.soft4j.bo.PhotoMgr"%>
在JSP中这二个出现错误怎么回事呢???

« 上一页 1 2 … 6 7 8 下一页 »

发表评论

您还没有登录,请您登录后再发表评论

最近访客更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论