应用jspsmartupload组件实行文件上传下载

应用jspsmartupload组件实行文件上传 

 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、       应用jspsmartupload组件实行文件上传   

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>  

 

 

2、       上传处理

 // 新建一个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);

 

3、       下载处理

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();
}