JSP 文件上传

JSP 可以与 HTML form 标签一起使用，来允许用户上传文件到服务器。上传的文件可以是文本文件或图像文件或任何文档。

本章节我们使用 Servlet 来处理文件上传，使用到的文件有：

upload.jsp : 文件上传表单。
message.jsp : 上传成功后跳转页面。
UploadServlet.java : 上传处理 Servlet。
需要引入的 jar 文件：commons-fileupload-1.2.1.jar、commons-io-1.4.jar。

结构图如下所示：

接下来我们详细介绍。

创建一个文件上传表单

下面的 HTML 代码创建了一个文件上传表单。以下几点需要注意：

表单 method 属性应该设置为 POST 方法，不能使用 GET 方法。
表单 enctype 属性应该设置为 multipart/form-data.
表单 action 属性应该设置为在后端服务器上处理文件上传的 Servlet 文件。下面的实例使用了 UploadServlet Servlet 来上传文件。
上传单个文件，您应该使用单个带有属性 type="file" 的 <input .../> 标签。为了允许多个文件上传，请包含多个 name 属性值不同的 input 标签。输入标签具有不同的名称属性的值。浏览器会为每个 input 标签关联一个浏览按钮。

upload.jsp 文件代码如下：

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<% String url = request.getRequestURL().toString(); %>
<% String basePath = request.getContextPath() + "/"; %>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
	<title>This is <%= url.substring(url.lastIndexOf("/")+1) %></title>
</head>
<body>
	<h1>文件上传实例</h1>
	<form action="<%=basePath %>UploadServlet" method="post" enctype="multipart/form-data">
		<span>选择一个文件：</span>
		<input type="file" name="uploadFile"/>
		<br/><br/>
		<input type="submit" value="上传">
	</form>
</body>
</html>

编写后台 Servlet

以下是 UploadServlet 的源代码，同于处理文件上传，在这之前我们先确保依赖包已经引入到项目的 WEB-INF/lib 目录下：

下面的实例依赖于 FileUpload，所以一定要确保在您的 classpath 中有最新版本的 commons-fileupload.x.x.jar 文件。可以从 http://commons.apache.org/proper/commons-fileupload/ 下载。
FileUpload 依赖于 Commons IO，所以一定要确保在您的 classpath 中有最新版本的 commons-io-x.x.jar 文件。可以从 http://commons.apache.org/proper/commons-io/ 下载。

你可以直接下载本站提供的两个依赖包：

UploadServlet 的源代码如下所示：

package com.yang.test;

import java.io.File;
import java.io.IOException;
import java.io.PrintWriter;
import java.util.List;

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
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.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;

/**
 * Servlet implementation class UploadServlet
 */
@WebServlet("/UploadServlet")
public class UploadServlet extends HttpServlet {
	private static final long serialVersionUID = 1L;

//	上传文件的目录
	private static final String UPLOAD_DIRECTORY = "uploadFile";

//	上传配置
	private static final int MEMORY_THRESHOLD = 1024 * 1014 * 3; // 3M
	private static final int MAX_FILE_SIZE = 1024 * 1024 * 40; // 40M
	private static final int MAX_REQUEST_SIZE = 1024 * 1024 * 50; // 50M

	public UploadServlet() {
		super();
	}

	protected void doGet(HttpServletRequest request, HttpServletResponse response)
			throws ServletException, IOException {
		response.sendRedirect(request.getContextPath()+"/upload/upload.jsp");
//		doPost(request, response);
	}

	/**
	 * 上传及保存文件
	 */
	protected void doPost(HttpServletRequest request, HttpServletResponse response)
			throws ServletException, IOException {
		
//		监测是否为多媒体上传
		if (!ServletFileUpload.isMultipartContent(request)) {
//			如果不是则停止
			PrintWriter writer = response.getWriter();
			writer.println("Error：表单中必须包含ectype=multipart/form-data");
			writer.flush();
			return;
		}
//		配置上传参数
		DiskFileItemFactory factory = new DiskFileItemFactory();
//		设置内存临界值-超出临界值后将产生临时文件并存储到临时目录中
		factory.setSizeThreshold(MEMORY_THRESHOLD);
//		设置临时存储目录
        factory.setRepository(new File(System.getProperty("java.io.tmpdir")));
		ServletFileUpload upload = new ServletFileUpload(factory);
//		设置最大文件上传值
		upload.setFileSizeMax(MAX_FILE_SIZE);
//		设置最大请求值(包含文件和表单数据)
		upload.setSizeMax(MAX_REQUEST_SIZE);
//		中文处理
		upload.setHeaderEncoding("UTF-8");
//		构造临时路径来存储上传的文件
//		这个文件相当于当前应用的目录
		String uploadPath = getServletContext().getRealPath("/") +UPLOAD_DIRECTORY;
//		如果目录不存在则创建
		File uploadDir = new File(uploadPath);
		if (!uploadDir.exists()) {
			uploadDir.mkdir();
		}
		    
		try {
			@SuppressWarnings("unchecked")
			List<FileItem> formItems = upload.parseRequest(request);
			if (formItems != null && formItems.size() > 0) {
//				迭代表单数据
				for(FileItem item : formItems) {
//					处理不在表单中的字段
					if (!item.isFormField()) {
						String fileName = new File(item.getName()).getName();
						String filePath = uploadPath + File.separator + fileName;
						File storeFile = new File(filePath);
//						在控制台上输出文件的上传路径
						System.out.println(filePath);
//						保存到硬盘
						item.write(storeFile);
						request.setAttribute("message", "文件上传成功");
					}
				}
			}
		} catch (Exception e) {
			request.setAttribute("message", "错误信息" + e.getMessage());
			
		}
//		上传成功跳转到message.jsp
		request.getRequestDispatcher("/upload/message.jsp").forward(request, response);
	}

}

message.jsp 文件代码如下：

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<% String url = request.getRequestURL().toString(); %>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
	<title>This is <%= url.substring(url.lastIndexOf("/")+1) %></title>
</head>
<body>
	<h1>文件上传的结果是：<%=request.getAttribute("message") %></h1>
</body>
</html>

编译和运行 Servlet

编译上面的 Servlet UploadServlet，尝试使用您在上面创建的 HTML 表单来上传文件。当您在浏览器中访问：http://127.0.0.1:8888/JspProject/upload/upload.jsp，演示如下所示：