使用fileupload组件实现文件上传

这是一个Servlet应用。。

首先是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>
		<servlet-name>UploadServlet</servlet-name>
		<servlet-class>com.jadyer.servlet.FileUploadServlet</servlet-class>
	</servlet>
	<servlet-mapping>
		<servlet-name>UploadServlet</servlet-name>
		<url-pattern>/UploadServlet</url-pattern>
	</servlet-mapping>
	<welcome-file-list>
		<welcome-file>upload.jsp</welcome-file>
	</welcome-file-list>
</web-app>

然后是用来选择所要上传的文件的upload.jsp页面

<%@ page language="java" pageEncoding="UTF-8"%>
<%--
===================================================================================
【上传文件时表单的method和enctype属性】
普通<form>表单的method属性默认为GET，enctype属性默认为application/x-www-form-urlencoded
但在上传文件时，表单method值必须是POST，enctype需要设置为multipart/form-data
并且enctype属性是通过表单上传文件必不可少的参数，上传文件时需将其显式设置为multipart/form-data
默认的application/x-www-form-urlencoded只是用来指明表单数据在提交时，是以字符串信息进行提交的
若未指定multipart/form-data值，将导致request.getParameter("file")只能获得包含路径的文件名
===================================================================================
--%>
<form action="<%=request.getContextPath()%>/UploadServlet" method="POST" enctype="multipart/form-data">
	<table border="9">
		<tr>
			<td>username</td>
			<td><input type="text" name="username"></td>
		</tr>
		<tr>
			<td>password</td>
			<td><input type="password" name="password"></td>
		</tr>
		<tr>
			<td>File11</td>
			<td><input type="file" name="file11"></td>
		</tr>
		<tr>
			<td>File22</td>
			<td><input type="file" name="file22"></td>
		</tr>
		<tr>
			<td></td>
			<td><input type="submit" name="submit" value="上传"></td>
		</tr>
	</table>
</form>

接着是用来显示文件上传结果的result.jsp页面

<%@ page language="java" pageEncoding="UTF-8"%>

<h3>请移步D:/Program Files/tomcat6/webapps/upload/uploadFile/查看所上传的文件</h3>
<table border="9">
	<tr>
		<td>uploadResult</td>
		<td>${requestScope['upload.message']}</td>
	</tr>
	<tr>
		<td>username</td>
		<td>${requestScope.username}</td>
	</tr>
	<tr>
		<td>password</td>
		<td>${requestScope.password}</td>
	</tr>
	<tr>
		<td>File11</td>
		<td>${requestScope.file11}</td>
	</tr>
	<tr>
		<td>File22</td>
		<td>${requestScope.file22}</td>
	</tr>
</table>

最后是用来处理文件上传的核心Servlet

package com.jadyer.servlet;

import java.io.File;
import java.io.IOException;
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.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;

/**
 * 实现文件上传操作的Servlet
 * @author 玄玉
 */
public class FileUploadServlet extends HttpServlet {
	private static final long serialVersionUID = 7291295547319094602L;

	public void doPost(HttpServletRequest request, HttpServletResponse response)
			throws ServletException, IOException {
		request.setCharacterEncoding("UTF-8");
		
		//虽然getRealPath()方法已经不赞同被使用了，但是它还是很好用的
		//getRealPath("/uploadFile")指的就是WebRoot下的uploadFile目录
		String path = request.getRealPath("/uploadFile");
		
		// 创建工厂。然后再通过工厂来设置两个相关的属性
		// Create a factory for disk-based file items
		// DiskFileItemFactory factory = new DiskFileItemFactory(yourMaxMemorySize, yourTempDirectory);
		DiskFileItemFactory factory = new DiskFileItemFactory();
		
		// 设置小于1MB的文件就放到内存中，大于等于1MB则写到磁盘中
		// Set yourMaxMemorySize
		factory.setSizeThreshold(1024 * 1024);
		// 设置临时存储目录
		// Set yourTempDirectory
		factory.setRepository(new File(path));
		
		// 通过工厂生成类的实例
		// Create a new file upload handler
		ServletFileUpload upload = new ServletFileUpload(factory);
		
		// 设置允许用户上传文件大小, 单位:字节
		// Set overall request size constraint
		// factory.setSizeMax(yourMaxRequestSize);

		try {
			// parse是解析的意思，parseRequest也就是解析传过来的内容
			// 调用ServletFileUpload类的parseRequest()方法获取所上传的所有文件和参数的集合
			// Parse the request
			List<FileItem> list = upload.parseRequest(request);

			//遍历list对象中的每个FileItem对象，FileItem对象代表表单参数和所上传的文件
			//然后判断它到底是不是File类型的
			for (FileItem item : list) {
				// Process a regular form field
				if (item.isFormField()) {
					String name = item.getFieldName();//获得字段的名字
					String value = item.getString("UTF-8");//使用指定编码获得字段的值
					request.setAttribute(name, value);//用于在result.jsp页面中输出
				} else {
					// Process a file upload
					// If you want to process a file upload in memory, you can use code as: byte[] data = item.get();
					if (null!=item.getName() && !"".equals(item.getName())) {
						//通过FileItem对象的getName()方法所获取的是上传文件在客户端的包含后缀的完整名称
						//并且FileItem对象的getSize()、getContentType()可以获取所上传的文件的大小和类型
						System.out.println("上传文件的名称：" + item.getName());
						System.out.println("上传文件的大小：" + item.getSize());
						System.out.println("上传文件的类型：" + item.getContentType());
						
						System.out.println("-------------------------------------------------");
						
						String value = item.getName();
						int start = value.lastIndexOf("//");
						String fileName = value.substring(start + 1);
						
						//使用FileItem对象writer()方法完成最终的上传文件的保存
						item.write(new File(path, fileName));
						
						//用于在result.jsp中显示所上传的文件名称
						String name = item.getFieldName();
						request.setAttribute(name, fileName);
						
						request.setAttribute("upload.message", "文件上传成功");
					}else{
						request.setAttribute("upload.message", "没有选择上传文件");
					}
				}
			}
		}
		catch (Exception ex) {
			ex.printStackTrace();
			request.setAttribute("upload.message", "文件上传失败");
		}
		request.getRequestDispatcher("result.jsp").forward(request,response);
	}
}
/***************【浅析DiskFileItemFactory类】**************************************************************/
//查看org.apache.commons.fileupload.disk.DiskFileItemFactory的API文档
//观察DiskFileItemFactory的名字，翻译过来就是磁盘文件条目的工厂，因此它肯定是跟磁盘的文件有关系的
//DiskFileItemFactory中有两个setter()方法，分别为setSizeThreshold()和setRepository()方法
/***************【浅析setSizeThreshold()方法】**************************************************************/
//在API文档中setSizeThreshold()的原形是public void setSizeThreshold(int sizeThreshold)
//描述：Sets the size threshold beyond which files are written directly to disk
//翻译：设定上传文件的最大体积。如果超出这个size的话，文件就被直接写到磁盘里面
//也就是说指定上传文件的体积。如果上传的文件小于这个体积，就直接把文件放到内存里面。如果超出这个体积的话，就把文件放到磁盘里面
/***************【浅析setRepository()方法】*****************************************************************/
//在API文档中setRepository()的原形是public void setRepository(java.io.File repository)
//描述：Sets the directory used to temporarily store files that are larger than the configured size threshold
//翻译：设置用来临时的存储文件的目录，而且存储的文件是比配置的threshold要大的文件
//也就是说setRepository()是用来设置临时目录的。一旦上传的文件超出了所设定的大小时，就把这个文件临时的存储到这个目录里面
/***************【浅析ServletFileUpload类】****************************************************************/
//最重要的就是org.apache.commons.fileupload.servlet.ServletFileUpload类，它是真正用来处理上传操作的
//在以前的版本中，使用的是org.apache.commons.fileupload.DiskFileUpload类进行上传的
//DiskFileUpload描述为：Deprecated.Use ServletFileUpload together with DiskFileItemFactory instead
//翻译过来就是：使用ServletFileUpload和DiskFileItemFactory来代替DiskFileUpload
//以前是不用工厂的，直接New出来DiskFileUpload的实例就可以了。但是现在就不要再使用DiskFileUpload类了
//ServletFileUpload类有一个这样的构造方法ServletFileUpload(FileItemFactory fileItemFactory)。它的描述如下
//Constructs an instance of this class which uses the supplied factory to create FileItem instances
//这个构造方法使用的是FileItemFactory类型的参数。查看源码可知DiskFileItemFactory类实现了FileItemFactory
//因此，在构建ServletFileUpload实例的时候，就可以使用DiskFileItemFactory作为构造方法的参数来生成实例
//这样就通过工厂生成了ServletFileUpload类的一个实例了
/***************【浅析parseRequest()方法】******************************************************************/
//在ServletFileUpload类中提供了一个parseRequest()方法，它的源代码如下所示
//--------------------------------------------------------------------------------------------------
//public List /* FileItem */ parseRequest(HttpServletRequest request) throws FileUploadException{  |
//		return parseRequest(new ServletRequestContext(request));                                   |
//}                                                                                                |
//--------------------------------------------------------------------------------------------------
//parseRequest()方法是真正完成上传的处理的，它是非常复杂的一个方法。它接收的是一个HttpServletRequest参数
//我们知道，客户端传过来的东西，都是在request中的。这里的parseRequest()就会解析request，得到java.util.list
//这个List就封装了客户端传过来的表单里面的所有的参数，也包括File类型。它会将这些参数封装成一个集合，便于我们使用
//其中/* FileItem */用来说明所返回的List中都是FileItem类型的。为了兼容JDK1.4，所以它没有用泛型的方式来定义
//注意，一个FileItem对应的是表单中的一个字段，而并不仅仅是表单中的File类型的字段，也不是表单中所有字段的集合
/***************【浅析FileItem接口和它的isFormField()方法】***************************************************/
//通过查看org.apache.commons.fileupload.FileItem的API发现FileItem是一个接口
//但是我们不必关心它是由什么类来具体实现的，这就是面向接口编程的一个好处
//在FileItem接口中有一个boolean isFormField()方法，它的描述如下
//Determines whether or not a FileItem instance represents a simple form field
//翻译过来就是：决定FileItem实例是否代表一个简单的表单字段
//表单字段只有两种，即File类型和非File类型。如果isFormField()返回TRUE则表明是非File的，返回FALSE则表明是File类型的
//所以通过isFormField()方法就可以很明确的判断出所提交的表单，到底是不是一个文件类型。通过该方法就可以将两种类型截然的分开
/***************【FileItem.getName()方法和上传同名文件的冲突问题】**********************************************/
//只有当item为File类型时，调用getName()方法才会返回真正的文件名字，如果是普通的表单类型的话，调用getName()就会返回null
//另外，由于不同的浏览器解析文件地址的时候采取的方式不同，有的浏览器会自动在文件名的前面添加路径，而有的浏览器则只取得文件名
//所以就需要我们对获得的文件名进行手工截取，最后取得的只是文件的名字，而不包含路径，这样最后得到的FileName才是真正的文件名
//注意，这里对获取的文件名的处理非常重要
//为了避免不同用户上传相同文件而导致文件覆盖，我们可以在这里将FileName时间化，即在FileName前面加上new Date().getTime()
//这样保存在服务器上的就是以时间毫秒数开头的文件了，避免了文件的同名现象
//另外也可以使用随机数，但是需要我们自己来设定随机算法，并且随机数在计算时，比较耗内存
//所以当前最常用的就是使用时间来标识上传的文件
/***************【直接调用FileItem接口的write()方法便可以替代以下操作】*****************************************/
//OutputStream os = new FileOutputStream(new File(path, fileName));
//InputStream is = item.getInputStream();
//byte[] buffer = new byte[400];
//int length = 0;
//while ((length = is.read(buffer)) > 0) {
//		os.write(buffer, 0, length);
//}
//os.close();
//is.close();
/********************************************************************************************************/

当文件上传成功时，会保存在本地硬盘中

即LocalDisk//tomcat6//webapps//upload//uploadFile//文件夹中