ahxu-commons-fileuploadex-beta1及相关内容先参见http://blog.csdn.net/ahxu/archive/2004/08/17/76997.aspx
ahxu-commons-fileuploadex-beta2的改动:
1.重写了内部实现结构,使运行更省资源,更稳定。
2.修正一些bug,接口做了一些调整,使之应用更简单!
说明:
ahxu-commons-fileuploadex-beta1中的接口依然保留,但有些不建议再使用,将在正式版中取消,现在依然保留是为了与前一版本兼容,现在用户依然可以使用,建议新用户不要使用!
一、ahxu-commons-fileuploadex-beta2的安装:
1.下载apache的commons-fileupload-1.0组件
下载地址:http://apache.linuxforum.net/dist/jakarta/commons/fileupload/binaries/commons-fileupload-1.0.zip
2. 下载ahxu的ahxu-commons-fileuploadex-1.0组件
下载地址:http://www.lizonghan.com/ahxu/ahxu-commons-fileuploadex-beta2.jar
3. 将此二个.jar文件放入一个已配置好的web应用的WEB-INF\lib目录下,例如:test\WEB-INF\lib
二、ahxu-commons-fileuploadex-beta2的测试:
1.下载应用测试代码upload-jsp.rar,下载地址http://www.lizonghan.com/ahxu/upload2-jsp.rar ,解压放在此web应用的根目录,例如:test2.运行测试upload.jsp,要求IE5.0以上,例如:http://127.0.0.1/test/upload.jsp
3.选择一个或二个大点儿的文件,最好几百M,然后上传,上传过程中会弹出一个进度对话框,如图
4.文件上传完毕后将显示上传结果,进度对话框自动关闭。
三、有用的upload-jsp.rar:
upload-jsp.rar中包含的4个文件:upload.jsp、receive.jsp、progressbar.jsp、progressdetail.jsp
1.upload.jsp——文件上传表单页面;
此页面包含了文件上传的form表单,当然也可以是你的应用中任何你喜欢的有文件上传form表单的页面。此页面在submit时调用javascript函数uploadBegin()弹出进度显示对话框(显示progressbar.jsp);你也可以根据需要自己定制,例如不用对话框,用iframe等。但form的onSubmit时要调用uploadBegin(),如:
<script language="javascript">
function uploadBegin(){
theFeats = "height=200,width=320,location=no,menubar=no,resizable=no,scrollbars=no,status=no,toolbar=no";
strAppVersion = navigator.appVersion;
if (document.uploadForm.file1.value != "")
{
if (strAppVersion.indexOf('MSIE') != -1 && strAppVersion.substr(strAppVersion.indexOf('MSIE')+5,1) > 4)
{
winstyle = "dialogWidth=320px; dialogHeight:200px; center:yes";
window.showModelessDialog(<%="\""+response.encodeURL("progressbar.jsp")+"\""%>,window,winstyle);
}
}
}
</script>
<form action=<%="\""+response.encodeURL("receive.jsp")+"\""%> enctype="multipart/form-data" method="post" name="uploadForm" id="uploadForm" onsubmit="uploadBegin();">
2.receive.jsp——文件上传接收页,即服务器端接收上传数据并处理上传数据的页面,可以用servlet来代替;
<%
List fileItemList=null;
/*创建组件*/
DiskFileUploadEx fu = new DiskFileUploadEx();
/*设置允许上传的最大值,超过此值将不进行上传*/
fu.setSizeMax(1024*1000*1000);
/*设置设允许上传的文件类型*/
fu.setAllowFiles(".txt;.jpg;.rm;.rmvb;.htm");
try{
/*执行上传过程,并得到上传后文件列表*/
fileItemList=fu.parseRequestEx(request);
Iterator fileItemListIte=fileItemList.iterator();
while(fileItemListIte.hasNext())
{
FileItem file=(FileItem)fileItemListIte.next();
out.println(file.getName()+"<br>");
}
out.println("上传成功");
}catch (Exception e){
out.println("上传失败<br>");
out.println(e.getMessage());
/*显示不被允许上传的文件列表 begin*/
if(e instanceof DiskFileUploadEx.InvalidFileUploadException){
out.println("<p>以下文件不被允许:</p>");
Iterator unAllowFileS=((DiskFileUploadEx.InvalidFileUploadException)e).getInvalidFileList().iterator();
while(unAllowFileS.hasNext()){
out.println((String)unAllowFileS.next()+"<br>");
}
/*显示不被允许上传的文件列表 end */
}
}
finally{
/*上传完成后的清理工作*/
fu.dispose();
}
%>
3.progressbar.jsp——文件上传进度显示页,如图1;
你也可以根据自己的需要定制自己样式的进度显示页面。
4.progressdetail.jsp——文件上传进度数据读取页,用来构造上传进度信息,供progressbar.jsp读取显示,无需修改
四、简单应用部署的总结:
1.下载安装apache的commons-fileupload-1.0组件及ahxu-commons-fileuploadex-beta2组件;
2.编辑上传表单文件,注意要复制upload.jsp的uploadBegin(),以及form表单的onsubmit="uploadBegin();"
3.复制progressbar.jsp、progressdetail.jsp无需修改;
4.根据需要编辑receive.jsp页的内容。
五、ahxu.commons.upload.DiskFileUploadEx 的扩展应用接口
ahxu.commons.upload
Class DiskFileUploadExjava.lang.Object
|-org.apache.commons.fileupload.FileUploadBase
|-org.apache.commons.fileupload.DiskFileUpload
|-ahxu.commons.upload.DiskFileUploadEx
public class DiskFileUploadEx
extends org.apache.commons.fileupload.DiskFileUpload
DiskFileUploadEx类继承自org.apache.commons.fileupload.DiskFileUpload,以下所列应用接口均为原org.apache.commons.fileupload.DiskFileUpload没有的接口,而有原相关内容请参见org.apache.commons.fileupload文档,
Method Summary
void
clear(javax.servlet.http.HttpServletRequest req)
Deprecated. 同dispose,原beta1中使用,建议不要使用
void
dispose()
上传后清理工作
java.lang.String
得到允许上传的文件类型
int
boolean
得到是否允许上载除file以外的field的设置开关值
java.util.List
parseRequestEx(javax.servlet.http.HttpServletRequest req)
parseRequest的扩展,完成上传操作 根据allowField值决定是否接收除file以外的其它field,并检查上传的文件是否为允许的文件
java.util.List
parseRequestExSessionReport(javax.servlet.http.HttpServletRequest req)
Deprecated. 同parseRequestEx,原beta1中使用,建议不要使用
void
setAllowField(boolean allow)
设置开关值,是否允许上载除file以外的field的内容
void
setAllowFiles(java.lang.String allowFiles)
设置允许上传的文件类型,默认是null,可以上传任何类型
void
setReportLimitSize(int reportLimitSize)
设置最小报告长度,这个参数影响报告频度,默认是10K
FAQ:
1.如何从beta1升级beta2?
答:
1).下载beta2并安装。
2).下载upload2-jsp.rar 用其中的 progressdetail.jsp覆盖原beta1的同名文件。
3).其它可不变,也可将原接收代码内的parseRequestExSessionReport替换成parseRequestEx,将clear(javax.servlet.http.HttpServletRequest req) 替换成dispose() 。
2.示例代码并没有保存文件到硬盘或数据库,我该怎么保存?
答:这方面的内容为org.apache.commons.fileupload组件的应用内容,网上相关的内容有很多,这里就不在累述了。