用commons-fileupload-1.2 实现文件上传

前几天搞文件上传, Google到了Apache 的 commons-fileupload-1.2.jar 上传组件, 研究了API然后结合Hibernate实现了上传图片
并保存到MySQL数据库. 今天重新写了一遍, 由于不需要保存到数据库了, 就实现了保存成文件格式.

我的这个FileUpload web工程源文件下载如下 : FileUpload.rar . 解压到当前文件夹后直接剪切到 Tomcat 主目录下的 webapps
目录下, 启动 Tomcat 后在浏览器输入 http://localhost:8080/FileUpload/upload.html 查看演示.

我是用Eclipse 开发. 首先, 下载两个开发包: commons-fileupload 和 commons-io(这个在应用commons-fileupload时会用到).
这两个开发包(jar文件) 在我前面提供的FileUpload 工程下的WEB-INF/lib下可以找到, 你也可以到官方下载:
到 http://commons.apache.org/downloads/download_fileupload.cgi 下载 commons-fileupload-1.2.jar
组件包 (直接下载地址: http://apache.mirror.phpchina.com/commons/fileupload/binaries/commons-fileupload-1.2-bin.zip),
到 http://commons.apache.org/downloads/download_io.cgi 下载 commons-io-1.3.2 组件包(直接下载地址:
http://apache.mirror.phpchina.com/commons/io/binaries/commons-io-1.3.2-bin.zip).

启动Eclipse, 新建Web Project, 取名 FileUpload. 然后在WebRoot文件夹(Web根文件夹)下新建两个文件夹(New->Folder) :
ImagesUploaded 和 ImagesUploadTemp, 分别用来存放上传文件和上传时的临时文件,稍后代码里会用到.

在WebRoot 文件夹下新建文件upload.html, 用来提供上传用的form. 源代码如下:
右击src, 新建一个Servlet: FileUploadServlet, 路径设为src/FileUploadServlet . 保存后WebRoot/WEB-INF/web.xml 更新为:

web.xml<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5"
xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
<servlet>
<description>This is the description of my J2EE component</description>
<display-name>This is the display name of my J2EE component</display-name>
<servlet-name>FileUploadServlet</servlet-name>
<servlet-class>FileUploadServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>FileUploadServlet</servlet-name>
<url-pattern>/FileUploadServlet</url-pattern>
</servlet-mapping>
<welcome-file-list>
<welcome-file>upload.html</welcome-file>
</welcome-file-list>
</web-app>


其中,我把<welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> 的欢迎文件设为了upload.html,
这样等完成后可能直接用http://localhost:8080/FileUpload/ 来访问upload.html. 不改的话, 可以在http://localhost:8080/FileUpload/upload.html
页面上传文件. 在写FileUploadServlet 之前, 先将之前下载的commons-fileupload 和commons-io 组件包压缩文件解压出来, 把里面的
commons-fileupload-1.2.jar (lib文件夹下) 和 commons-io-1.3.2.jar 拷到WebRoot/WEB-INF/lib 文件夹下, 以便使用它们的功能.

FileUploadServlet.java 的源代码如下, 附有详细注解:
FileUploadServlet.java import java.io.File;
import java.io.IOException;
import java.io.PrintWriter;
import java.util.Iterator;
import java.util.List;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.FileUploadException;
import org.apache.commons.fileupload.FileUploadBase.SizeLimitExceededException;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;
public class FileUploadServlet extends HttpServlet {
public FileUploadServlet() {
super();
}
public void destroy() {
super.destroy(); // Just puts "destroy" string in log
// Put your code here
}
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
doPost(request, response);
}
public void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
final long MAX_SIZE = 3 * 1024 * 1024;// 设置上传文件最大为 3M
// 允许上传的文件格式的列表
final String[] allowedExt = new String[] { "jpg", "jpeg", "gif", "txt",
"doc", "docx", "mp3", "wma", "m4a" };
response.setContentType("text/html");
// 设置字符编码为UTF-8, 这样支持汉字显示
response.setCharacterEncoding("UTF-8");
// 实例化一个硬盘文件工厂,用来配置上传组件ServletFileUpload
DiskFileItemFactory dfif = new DiskFileItemFactory();
dfif.setSizeThreshold(4096);// 设置上传文件时用于临时存放文件的内存大小,这里是4K.多于的部分将临时存在硬盘
dfif.setRepository(new File(request.getRealPath("/")
+ "ImagesUploadTemp"));// 设置存放临时文件的目录,web根目录下的ImagesUploadTemp目录
// 用以上工厂实例化上传组件
ServletFileUpload sfu = new ServletFileUpload(dfif);
// 设置最大上传尺寸
sfu.setSizeMax(MAX_SIZE);
PrintWriter out = response.getWriter();
// 从request得到 所有 上传域的列表
List fileList = null;
try {
fileList = sfu.parseRequest(request);
} catch (FileUploadException e) {// 处理文件尺寸过大异常
if (e instanceof SizeLimitExceededException) {
out.println("文件尺寸超过规定大小:" + MAX_SIZE + "字节<p />");
out.println("<a href=\"upload.html\" target=\"_top\">返回</a>");
return;
}
e.printStackTrace();
}
// 没有文件上传
if (fileList == null || fileList.size() == 0) {
out.println("请选择上传文件<p />");
out.println("<a href=\"upload.html\" target=\"_top\">返回</a>");
return;
}
// 得到所有上传的文件
Iterator fileItr = fileList.iterator();
// 循环处理所有文件
while (fileItr.hasNext()) {
FileItem fileItem = null;
String path = null;
long size = 0;
// 得到当前文件
fileItem = (FileItem) fileItr.next();
// 忽略简单form字段而不是上传域的文件域(<input type="text" />等)
if (fileItem == null || fileItem.isFormField()) {
continue;
}
// 得到文件的完整路径
path = fileItem.getName();
// 得到文件的大小
size = fileItem.getSize();
if ("".equals(path) || size == 0) {
out.println("请选择上传文件<p />");
out.println("<a href=\"upload.html\" target=\"_top\">返回</a>");
return;
}
// 得到去除路径的文件名
String t_name = path.substring(path.lastIndexOf("\\") + 1);
// 得到文件的扩展名(无扩展名时将得到全名)
String t_ext = t_name.substring(t_name.lastIndexOf(".") + 1);
// 拒绝接受规定文件格式之外的文件类型
int allowFlag = 0;
int allowedExtCount = allowedExt.length;
for (; allowFlag < allowedExtCount; allowFlag++) {
if (allowedExt[allowFlag].equals(t_ext))
break;
}
if (allowFlag == allowedExtCount) {
out.println("请上传以下类型的文件<p />");
for (allowFlag = 0; allowFlag < allowedExtCount; allowFlag++)
out.println("*." + allowedExt[allowFlag]
+ "   ");
out.println("<p /><a href=\"upload.html\" target=\"_top\">返回</a>");
return;
}
long now = System.currentTimeMillis();
// 根据系统时间生成上传后保存的文件名
String prefix = String.valueOf(now);
// 保存的最终文件完整路径,保存在web根目录下的ImagesUploaded目录下
String u_name = request.getRealPath("/") + "ImagesUploaded/"
+ prefix + "." + t_ext;
try {
// 保存文件
fileItem.write(new File(u_name));
out.println("文件上传成功. 已保存为: " + prefix + "." + t_ext
+ "   文件大小: " + size + "字节<p />");
out.println("<a href=\"upload.html\" target=\"_top\">继续上传</a>");
} catch (Exception e) {
e.printStackTrace();
}
}
}
public void init() throws ServletException {
// Put your code here
}
}



保存后部署项目(MyEclipse下直接点击Deploy J2EE...按钮, 然后选择Tomcat服务器). 没有MyEclipse的话, 把WebRoot 拷到
Tomcat 主目录下的webapps 目录下, 并重命名为 FileUpload 然后启动Tomcat. (或直接下载我在文章开始提供的工程打包rar文件).
最后打开浏览器, 输入url:
http://localhost:8080/FileUpload/upload.html .