jspsmartupload是由www.jspsmart.com网站开发的一个可免费使用的全功能的文件上传下载组件,适于嵌入执行上传下载操作的jsp文件中。该组件有以下几个特点:
1、使用简单。在jsp文件中仅仅书写三五行java代码就可以搞定文件的上传或下载,方便。
2、能全程控制上传。利用jspsmartupload组件提供的对象及其操作方法,可以获得全部上传文件的信息(包括文件名,大小,类型,扩展名,文件数据等),方便存取。
3、能对上传的文件在大小、类型等方面做出限制。如此可以滤掉不符合要求的文件。
4、下载灵活。仅写两行代码,就能把web服务器变成文件服务器。不管文件在web服务器的目录下或在其它任何目录下,都可以利用jspsmartupload进行下载。
5、能将文件上传到数据库中,也能将数据库中的数据下载下来。这种功能针对的是mysql数据库,因为不具有通用性,所以本文不准备举例介绍这种用法。
jspsmartupload组件可以从www.jspsmart.com网站上自由下载,压缩包的名字是jspsmartupload.zip。下载后,用winzip或winrar将其解压到tomcat的webapps目录下(本文以tomcat服务器为例进行介绍)。解压后,将webapps/jspsmartupload目录下的子目录web-inf名字改为全大写的web-inf,这样一改jspsmartupload类才能使用。因为tomcat对文件名大小写敏感,它要求web应用程序相关的类所在目录为web-inf,且必须是大写。接着重新启动tomcat,这样就可以在jsp文件中使用jspsmartupload组件了。
注意,按上述方法安装后,只有webapps/jspsmartupload目录下的程序可以使用jspsmartupload组件,如果想让tomcat服务器的所有web应用程序都能用它,必须做如下工作:
1.进入命令行状态,将目录切换到tomcat的webapps/jspsmartupload/web-inf目录下。
2.运行jar打包命令:jar cvf jspsmartupload.jar com
(也可以打开资源管理器,切换到当前目录,用winzip将com目录下的所有文件压缩成jspsmartupload.zip,然后将jspsmartupload.zip换名为jspsmartupload.jar文件即可。)
3.将jspsmartupload.jar拷贝到tomcat的shared/lib目录下。
1、method应用post,即method="post"。
2、增加属性:enctype="multipart/form-data"
下面是一个用于上传文件的form表单的例子:
<form method="post" enctype="multipart/form-data" action="/jspsmartupload/upload.jsp"> <input type="file" name="myfile"> <input type="submit"> </form>
// 新建一个smartupload对象 smartupload su = new smartupload(); // 上传初始化 su.initialize(pagecontext); // 设定上传限制 // 1.限制每个上传文件的最大长度。 su.setmaxfilesize(10000); // 2.限制总上传数据的长度。 su.settotalmaxfilesize(20000); // 3.设定允许上传的文件(通过扩展名限制),仅允许doc,txt文件。 su.setallowedfileslist("doc,txt"); // 4.设定禁止上传的文件(通过扩展名限制),禁止上传带有exe,bat, jsp,htm,html扩展名的文件和没有扩展名的文件。 su.setdeniedfileslist("exe,bat,jsp,htm,html,,"); // 上传文件 su.upload(); // 将上传文件全部保存到指定目录 int count = su.save("/upload"); // 利用request对象获取参数之值 su.getrequest().getparameter("test"); // 逐一提取上传文件信息,同时可保存文件。 for (int i=0;i<su.getfiles().getcount();i++) { com.jspsmart.upload.file file = su.getfiles().getfile(i); // 若文件不存在则继续 if (file.ismissing()) continue; // 显示当前文件信息 System.out.pringln("表单项名(fieldname)"+ file.getfieldname()); System.out.pringln("文件长度(size)"+ file. getsize ()); System.out.pringln("文件名(filename)"+ file. getfilename ()); System.out.pringln("文件扩展名(fileext)"+ file. getfileext ()); System.out.pringln("文件全名(filepathname)"+ file. getfilepathname ()); // 另存 file.saveas("/upload/" + myfile.getfilename()); // 另存到以web应用程序的根目录为文件根目录的目录下 file.saveas("/upload/" + myfile.getfilename(),su.save_virtual); // 另存到操作系统的根目录为文件根目录的目录下 file.saveas("c:\\temp\\" + myfile.getfilename(), su.save_physical);
smartupload su = new smartupload(); // 初始化 su.initialize(pagecontext); // 设定contentdisposition为null以禁止浏览器自动打开文件, //保证点击链接后是下载文件。若不设定,则下载的文件扩展名为 //doc时,浏览器将自动用word打开它。扩展名为pdf时, //浏览器将用acrobat打开。 su.setcontentdisposition(null); // 下载文件 su.downloadfile("/upload/如何赚取我的第一桶金.doc");
注意,执行下载的页面,在java脚本范围外(即<% ... %>之外),不要包含html代码、空格、回车或换行等字符,有的话将不能正确下载。 可以测试在上述源码中%><%之间加入一个换行符,再下载一下,保证出错。因为它影响了返回给浏览器的数据流,导致解析出错。
4、 如何下载中文文件
jspsmartupload虽然能下载文件,但对中文支持不足。若下载的文件名中有汉字,则浏览器在提示另存的文件名时,显示的是一堆乱码,很扫人兴。上面的例子就是这样。(这个问题也是众多下载组件所存在的问题,很少有人解决,搜索不到相关资料,可叹!)
为了给jspsmartupload组件增加下载中文文件的支持,我对该组件进行了研究,发现对返回给浏览器的另存文件名进行utf-8编码后,浏览器便能正确显示中文名字了。这是一个令人高兴的发现。于是我对jspsmartupload组件的smartupload类做了升级处理,增加了toutf8string这个方法,改动部分源码如下:
/** * 将文件名中的汉字转为utf8编码的串,以便下载时能正确显示另存的文件名. * * @param s * 原文件名 * @return 重新编码后的文件名 */ public static String toutf8String(String s) { StringBuffer sb = new StringBuffer(); for (int i = 0; i < s.length(); i++) { char c = s.charAt(i); if (c >= 0 && c <= 255) { sb.append(c); } else { byte[] b; try { b = Character.toString().getBytes("utf-8"); } catch (Exception ex) { System.out.println(ex); b = new byte[0]; } for (int j = 0; j < b.length; j++) { int k = b[j]; if (k < 0) k += 256; sb.append("%" + Integer.toHexString(k).toUpperCase()); } } } return sb.toString(); }