Servlet 文件上傳
Servlet 可以與HTML form 標籤一起使用,來允許用戶上傳文件到服務器。 上傳的文件可以是文本文件或圖像文件或任何文檔。
本文使用到的文件有:
- upload.jsp : 文件上傳表單。
- message.jsp : 上傳成功後跳轉頁面。
- UploadServlet.java : 上傳處理Servlet。
- 需要引入的jar 文件:commons-fileupload-1.3.2、commons-io-2.5.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"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>文件上传实例 - 本教程</title> </head> <body> <h1>文件上传实例 - 本教程</h1> <form method="post" action="/TomcatTest/UploadServlet" enctype="multipart/form-data"> 选择一个文件: <input type="file" name="uploadFile" /> <br/><br/> <input type="submit" value="上传" /> </form> </body> </html>
編寫後台Servlet
以下是UploadServlet 的源代碼,同於處理文件上傳,在這之前我們先確保依賴包已經引入到項目的WEB-INF/lib 目錄下:
- 下面的實例依賴於FileUpload,所以一定要確保在您的classpath中有最新版本的commons-fileupload.xxjar文件。 可以從http://commons.apache.org/proper/commons-fileupload/下載。
- FileUpload依賴於Commons IO,所以一定要確保在您的classpath中有最新版本的commons-io-xxjar文件。 可以從http://commons.apache.org/proper/commons-io/下載。
你可以直接下載本站提供的兩個依賴包:
UploadServlet 的源代碼如下所示:
package com.w3big.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.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 = "upload"; // 上传配置 private static final int MEMORY_THRESHOLD = 1024 * 1024 * 3; // 3MB private static final int MAX_FILE_SIZE = 1024 * 1024 * 40; // 40MB private static final int MAX_REQUEST_SIZE = 1024 * 1024 * 50; // 50MB /** * 上传数据及保存文件 */ protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // 检测是否为多媒体上传 if (!ServletFileUpload.isMultipartContent(request)) { // 如果不是则停止 PrintWriter writer = response.getWriter(); writer.println("Error: 表单必须包含 enctype=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); // 构造临时路径来存储上传的文件 // 这个路径相对当前应用的目录 String uploadPath = getServletContext().getRealPath("./") + File.separator + 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 ex) { request.setAttribute("message", "错误信息: " + ex.getMessage()); } // 跳转到 message.jsp getServletContext().getRequestDispatcher("/message.jsp").forward( request, response); } }
message.jsp 文件代碼如下:
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>文件上传结果</title> </head> <body> <center> <h2>${message}</h2> </center> </body> </html>
編譯和運行Servlet
編譯上面的Servlet UploadServlet,並在web.xml 文件中創建所需的條目,如下所示:
<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5"> <servlet> <display-name>UploadServlet</display-name> <servlet-name>UploadServlet</servlet-name> <servlet-class>com.w3big.test.UploadServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>UploadServlet</servlet-name> <url-pattern>/TomcatTest/UploadServlet</url-pattern> </servlet-mapping> </web-app>
現在嘗試使用您在上面創建的HTML 表單來上傳文件。 當您在瀏覽器中訪問:http://localhost:8080/TomcatTest/upload.jsp ,演示如下所示: