Servlet 文件上传

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

本文使用到的文件有：

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

结构图如下所示：

图片.png

注意：Servlet3.0 已经内置了文件上传这一特性，开发者不再需要将 Commons FileUpload 组件导入到工程中去。

接下来我们详细介绍。

创建一个文件上传表单

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

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

upload.jsp 文件代码如下：

<%@pagelanguage="java"contentType="text/html;charset=UTF-8"pageEncoding="UTF-8"%><!DOCTYPEhtmlPUBLIC"-//W3C//DTDHTML4.01Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"><html><head><metahttp-equiv="Content-Type"content="text/html;charset=UTF-8"><title>文件上传示例-基础教程网</title></head><body><h1>文件上传示例-基础教程网</h1><formmethod="post"action="/TomcatTest/UploadServlet"enctype="multipart/form-data">选择一个文件:<inputtype="file"name="uploadFile"/><br/><br/><inputtype="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 的源代码如下所示：

packagecom.nhooo.test;importjava.io.File;importjava.io.IOException;importjava.io.PrintWriter;importjava.util.List;importjavax.servlet.ServletException;importjavax.servlet.annotation.WebServlet;importjavax.servlet.http.HttpServlet;importjavax.servlet.http.HttpServletRequest;importjavax.servlet.http.HttpServletResponse;importorg.apache.commons.fileupload.FileItem;importorg.apache.commons.fileupload.disk.DiskFileItemFactory;importorg.apache.commons.fileupload.servlet.ServletFileUpload;/***ServletimplementationclassUploadServlet*/@WebServlet("/UploadServlet")publicclassUploadServletextendsHttpServlet{privatestaticfinallongserialVersionUID=1L;//上传文件存储目录privatestaticfinalStringUPLOAD_DIRECTORY="upload";//上传配置privatestaticfinalintMEMORY_THRESHOLD=1024*1024*3;//3MBprivatestaticfinalintMAX_FILE_SIZE=1024*1024*40;//40MBprivatestaticfinalintMAX_REQUEST_SIZE=1024*1024*50;//50MB/***上传数据及保存文件*/protectedvoiddoPost(HttpServletRequestrequest,HttpServletResponseresponse)throwsServletException,IOException{//检测是否为多媒体上传if(!ServletFileUpload.isMultipartContent(request)){//如果不是则停止PrintWriterwriter=response.getWriter();writer.println("Error:表单必须包含enctype=multipart/form-data");writer.flush();return;}//配置上传参数DiskFileItemFactoryfactory=newDiskFileItemFactory();//设置内存临界值-超过后将产生临时文件并存储于临时目录中factory.setSizeThreshold(MEMORY_THRESHOLD);//设置临时存储目录factory.setRepository(newFile(System.getProperty("java.io.tmpdir")));ServletFileUploadupload=newServletFileUpload(factory);//设置最大文件上传值upload.setFileSizeMax(MAX_FILE_SIZE);//设置最大请求值(包含文件和表单数据)upload.setSizeMax(MAX_REQUEST_SIZE);//中文处理upload.setHeaderEncoding("UTF-8");//构造临时路径来存储上传的文件//这个路径相对当前应用的目录StringuploadPath=request.getServletContext().getRealPath("./")+File.separator+UPLOAD_DIRECTORY;//如果目录不存在则创建FileuploadDir=newFile(uploadPath);if(!uploadDir.exists()){uploadDir.mkdir();}try{//解析请求的内容提取文件数据@SuppressWarnings("unchecked")List<FileItem>formItems=upload.parseRequest(request);if(formItems!=null&&formItems.size()>0){//迭代表单数据for(FileItemitem:formItems){//处理不在表单中的字段if(!item.isFormField()){StringfileName=newFile(item.getName()).getName();StringfilePath=uploadPath+File.separator+fileName;FilestoreFile=newFile(filePath);//在控制台输出文件的上传路径System.out.println(filePath);//保存文件到硬盘item.write(storeFile);request.setAttribute("message","文件上传成功!");}}}}catch(Exceptionex){request.setAttribute("message","错误信息:"+ex.getMessage());}//跳转到message.jsprequest.getServletContext().getRequestDispatcher("/message.jsp").forward(request,response);}}

message.jsp 文件代码如下：

<%@pagelanguage="java"contentType="text/html;charset=UTF-8"pageEncoding="UTF-8"%><!DOCTYPEhtmlPUBLIC"-//W3C//DTDHTML4.01Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"><html><head><metahttp-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 文件中创建所需的条目，如下所示：

<?xmlversion="1.0"encoding="UTF-8"?><web-appxmlns: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/javaeehttp://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.nhooo.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 ，演示如下所示：

图片.png

编辑于2024-05-20 14:34