课程表

JSP 基础教程

JSP 高级教程

工具箱
速查手册

JSP 文件上传

当前位置：免费教程 » Java相关 » JSP

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

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

  • 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 文件代码如下：

  1. <%@ page language="java" contentType="text/html; charset=UTF-8"
  2.     pageEncoding="UTF-8"%>
  3. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
  4.     "http://www.w3.org/TR/html4/loose.dtd">
  5. <html>
  6. <head>
  7. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  8. <title>文件上传实例 - W3xue教程</title>
  9. </head>
  10. <body>
  11. <h1>文件上传实例 - W3xue教程</h1>
  12. <form method="post" action="/TomcatTest/UploadServlet" enctype="multipart/form-data">
  13. 	选择一个文件:
  14. 	<input type="file" name="uploadFile" />
  15. 	<br/><br/>
  16. 	<input type="submit" value="上传" />
  17. </form>
  18. </body>
  19. </html>

编写后台 Servlet

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

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

UploadServlet 的源代码 如下所示：

  1. package com.w3xue.test;
  2.  
  3. import java.io.File;
  4. import java.io.IOException;
  5. import java.io.PrintWriter;
  6. import java.util.List;
  7.  
  8. import javax.servlet.ServletException;
  9. import javax.servlet.annotation.WebServlet;
  10. import javax.servlet.http.HttpServlet;
  11. import javax.servlet.http.HttpServletRequest;
  12. import javax.servlet.http.HttpServletResponse;
  13.  
  14. import org.apache.commons.fileupload.FileItem;
  15. import org.apache.commons.fileupload.disk.DiskFileItemFactory;
  16. import org.apache.commons.fileupload.servlet.ServletFileUpload;
  17.  
  18.  
  19. /**
  20.  * Servlet implementation class UploadServlet
  21.  */
  22. @WebServlet("/UploadServlet")
  23. public class UploadServlet extends HttpServlet {
  24.     private static final long serialVersionUID = 1L;
  25.      
  26.     // 上传文件存储目录
  27.     private static final String UPLOAD_DIRECTORY = "upload";
  28.  
  29.     // 上传配置
  30.     private static final int MEMORY_THRESHOLD   = 1024 * 1024 * 3;  // 3MB
  31.     private static final int MAX_FILE_SIZE      = 1024 * 1024 * 40; // 40MB
  32.     private static final int MAX_REQUEST_SIZE   = 1024 * 1024 * 50; // 50MB
  33.  
  34.     /**
  35.      * 上传数据及保存文件
  36.      */
  37.     protected void doPost(HttpServletRequest request,
  38. 		HttpServletResponse response) throws ServletException, IOException {
  39. 		// 检测是否为多媒体上传
  40. 		if (!ServletFileUpload.isMultipartContent(request)) {
  41. 		    // 如果不是则停止
  42. 		    PrintWriter writer = response.getWriter();
  43. 		    writer.println("Error: 表单必须包含 enctype=multipart/form-data");
  44. 		    writer.flush();
  45. 		    return;
  46. 		}
  47.  
  48.         // 配置上传参数
  49.         DiskFileItemFactory factory = new DiskFileItemFactory();
  50.         // 设置内存临界值 - 超过后将产生临时文件并存储于临时目录中
  51.         factory.setSizeThreshold(MEMORY_THRESHOLD);
  52.         // 设置临时存储目录
  53.         factory.setRepository(new File(System.getProperty("java.io.tmpdir")));
  54.  
  55.         ServletFileUpload upload = new ServletFileUpload(factory);
  56.          
  57.         // 设置最大文件上传值
  58.         upload.setFileSizeMax(MAX_FILE_SIZE);
  59.          
  60.         // 设置最大请求值 (包含文件和表单数据)
  61.         upload.setSizeMax(MAX_REQUEST_SIZE);
  62.  
  63.         // 构造临时路径来存储上传的文件
  64.         // 这个路径相对当前应用的目录
  65.         String uploadPath = getServletContext().getRealPath("./") + File.separator + UPLOAD_DIRECTORY;
  66.        
  67.          
  68.         // 如果目录不存在则创建
  69.         File uploadDir = new File(uploadPath);
  70.         if (!uploadDir.exists()) {
  71.             uploadDir.mkdir();
  72.         }
  73.  
  74.         try {
  75.             // 解析请求的内容提取文件数据
  76.             @SuppressWarnings("unchecked")
  77.             List<FileItem> formItems = upload.parseRequest(request);
  78.  
  79.             if (formItems != null && formItems.size() > 0) {
  80.                 // 迭代表单数据
  81.                 for (FileItem item : formItems) {
  82.                     // 处理不在表单中的字段
  83.                     if (!item.isFormField()) {
  84.                         String fileName = new File(item.getName()).getName();
  85.                         String filePath = uploadPath + File.separator + fileName;
  86.                         File storeFile = new File(filePath);
  87.                         // 在控制台输出文件的上传路径
  88.                         System.out.println(filePath);
  89.                         // 保存文件到硬盘
  90.                         item.write(storeFile);
  91.                         request.setAttribute("message",
  92.                             "文件上传成功!");
  93.                     }
  94.                 }
  95.             }
  96.         } catch (Exception ex) {
  97.             request.setAttribute("message",
  98.                     "错误信息: " + ex.getMessage());
  99.         }
  100.         // 跳转到 message.jsp
  101.         getServletContext().getRequestDispatcher("/message.jsp").forward(
  102.                 request, response);
  103.     }
  104. }

message.jsp 文件代码如下：

  1. <%@ page language="java" contentType="text/html; charset=UTF-8"
  2.     pageEncoding="UTF-8"%>
  3. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
  4.     "http://www.w3.org/TR/html4/loose.dtd">
  5. <html>
  6. <head>
  7. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  8. <title>文件上传结果</title>
  9. </head>
  10. <body>
  11.     <center>
  12.         <h2>${message}</h2>
  13.     </center>
  14. </body>
  15. </html>

编译和运行 Servlet

编译上面的 Servlet UploadServlet，并在 web.xml 文件中创建所需的条目，如下所示：

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3.     xmlns="http://java.sun.com/xml/ns/javaee"
  4.     xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
  5.     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
  6.         http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
  7.     id="WebApp_ID" version="2.5">
  8.   <servlet>
  9.     <display-name>UploadServlet</display-name>
  10.     <servlet-name>UploadServlet</servlet-name>
  11.     <servlet-class>com.w3xue.test.UploadServlet</servlet-class>
  12.   </servlet>
  13.    
  14.   <servlet-mapping>
  15.     <servlet-name>UploadServlet</servlet-name>
  16.     <url-pattern>/TomcatTest/UploadServlet</url-pattern>
  17.   </servlet-mapping>
  18. </web-app>

现在尝试使用您在上面创建的 HTML 表单来上传文件。当您在浏览器中访问：http://localhost:8080/TomcatTest/upload.jsp ，演示如下所示：

转载本站内容时，请务必注明来自W3xue，违者必究。
 友情链接：直通硅谷 　点职佳 　北美留学生论坛

本站QQ群：前端 618073944 | Java 606181507 | Python 626812652 | C/C++ 612253063 | 微信 634508462 | 苹果 692586424 | C#/.net 182808419 | PHP 305140648 | 运维 608723728

W3xue 的所有内容仅供测试，对任何法律问题及风险不承担任何责任。通过使用本站内容随之而来的风险与本站无关。
关于我们  |  意见建议  |  捐助我们  |  报错有奖  |  广告合作、友情链接（目前9元/月）请联系QQ：27243702 沸活量
皖ICP备17017327号-2　皖公网安备34020702000426号