Servlet-文件上传

关注

原创最新推荐文章于 2026-02-26 21:22:31 发布 662 阅读 AI 写同款· GEO 优化 ›

Servlet实现文件上传详解与实战 文件上传 1.客户端编程要上传文件，必须利用mutipart/form-data 设置HTML表单的enctype 属性值 Select a file 如果想上传多个文件，则不得不使用文件input元素，在input元素加入multipel属性，以便生成一个按钮供选择多个文件同样效果 2. 阅读详情

Servlet-文件上传

创建文件上传表单
编写后端Servlet
编译并运行Servlet

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

创建文件上传表单

下面以HTM代码创建一个上传文件表单。以下是要注意的重点：

表单方法属性应设置为POST方法，并且不能使用GET方法，因为GET方法上传数据量非常小，一般限制在 2 KB 左右；
表单enctype属性应设置为multipart / form-data。
表单操作属性应设置为Servlet文件，该文件将处理后端服务器上的文件上传。
要上传单个文件，应使用属性类型为“ file”的单个<input … />标记。要允许上传多个文件，请为名称属性添加多个输入标签，这些输入标签具有不同的值。浏览器将“浏览”按钮与每个按钮相关联。

以下示例是使用UploadServlet servlet上传文件，在eclipse软件中创建Upload的动态web项目，以下为index.html文件。

<html>
   <head>
   	  <meta charset="utf-8" />
      <title>文件上传表单</title>
   </head>
   
   <body>
      <h3>文件上传表单:</h3>
      请选择文件: <br />
      <form action = "UploadServlet" method = "post" enctype = "multipart/form-data">
         <input type = "file" name = "file" size = "50" />
         <br />
         <input type = "submit" value = "上传文件" />
      </form>
   </body>
</html>

这将显示以下结果，该结果将允许从本地PC选择文件，并且当用户单击“上传文件”时，表单将与所选的文件一起提交：
在这里插入图片描述

编写后端Servlet

以下是servlet UploadServlet，它将负责接受上传的文件并将其存储在目录/webapps/data中。也可以使用外部配置（例如web.xml中的context-param元素）添加此目录名称，如下所示：

<web-app>
   ....
   <context-param> 
      <description>Location to store uploaded file</description> 
      <param-name>file-upload</param-name> 
      <param-value>
         D:\apache-tomcat-8.5(1)\webapps\data\
      </param-value> 
   </context-param>
   ....
</web-app>

以下是UploadServlet的源代码，它可以一次处理多个文件的上传。在继续之前，请确保以下内容：

以下示例取决于FileUpload，因此我们需要在类路径中具有commons-fileupload.xxjar文件的最新版本。我们可以从https://commons.apache.org/fileupload/下载。
FileUpload取决于Commons IO，因此我们需要在类路径中具有commons-io-xxjar文件的最新版本。我们可以从https://commons.apache.org/io/下载。
在测试以下示例时，应上传大小小于maxFileSize的文件，否则将不会上传文件。
我们还要预先创建目录D:\temp和D:\apache-tomcat-8.5(1)\webapps\data\。

package servlet;

import java.io.*;
import java.util.*;
 
import javax.servlet.ServletConfig;
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.FileUploadException;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;
import org.apache.commons.io.output.*;

public class UploadServlet extends HttpServlet {
   
   private boolean isMultipart;
   private String filePath;
   private int maxFileSize = 50 * 1024 * 1024; //50mb
   private int maxMemSize = 4 * 1024 * 1024;//4mb
   private File file ;

   public void init( ){
      //获取文件的存储位置。
      filePath = getServletContext().getInitParameter("file-upload"); 
   }
   
   public void doPost(HttpServletRequest request, HttpServletResponse response)
      throws ServletException, java.io.IOException {
   
      //检查我们是否有文件上传请求
      isMultipart = ServletFileUpload.isMultipartContent(request);
      response.setHeader("contentType","text/html;charset=UTF-8");
      response.setContentType("text/html");
      response.setCharacterEncoding("UTF-8");
      java.io.PrintWriter out = response.getWriter( );
   
      if( !isMultipart ) {
         out.println("<html>");
         out.println("<head>");
         out.println("<title>Servlet文件上传示例</title>");  
         out.println("</head>");
         out.println("<body>");
         out.println("<p>没有文件上传</p>"); 
         out.println("</body>");
         out.println("</html>");
         return;
      }
  
      DiskFileItemFactory factory = new DiskFileItemFactory();
   
      //将存储在内存中的最大大小
      factory.setSizeThreshold(maxMemSize);
   
      //保存大于maxMemSize的数据的位置。
      factory.setRepository(new File("D:\\temp"));

      //创建一个新的文件上传处理程序
      ServletFileUpload upload = new ServletFileUpload(factory);
   
      //要上传的最大文件大小。
      upload.setSizeMax( maxFileSize );

      try { 
         //解析请求以获取文件项。
         List fileItems = upload.parseRequest(request);
	
         //处理上传的文件项
         Iterator i = fileItems.iterator();

         out.println("<html>");
         out.println("<head>");
         out.println("<title>Servlet文件上传示例</title>");  
         out.println("</head>");
         out.println("<body>");
   
         while ( i.hasNext () ) {
            FileItem fi = (FileItem)i.next();
            if ( !fi.isFormField () ) {
               //获取上传的文件参数
               String fieldName = fi.getFieldName();
               String fileName = fi.getName();
               String contentType = fi.getContentType();
               boolean isInMemory = fi.isInMemory();
               long sizeInBytes = fi.getSize();
            
               //读写文件
               if( fileName.lastIndexOf("\\") >= 0 ) {
                  file = new File( filePath + fileName.substring( fileName.lastIndexOf("\\"))) ;
               } else {
                  file = new File( filePath + fileName.substring(fileName.lastIndexOf("\\")+1)) ;
               }
               fi.write( file ) ;
               out.println("被上传的文件: " + fileName + "<br>");
            }
         }
         out.println("</body>");
         out.println("</html>");
         } catch(Exception ex) {
            System.out.println(ex);
         }
      }
      
      public void doGet(HttpServletRequest request, HttpServletResponse response)
         throws ServletException, java.io.IOException {

         throw new ServletException("GET method used with " +
            getClass( ).getName( )+": POST method required.");
      }
   
}

编译并运行Servlet

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

<servlet>
   <servlet-name>UploadServlet</servlet-name>
   <servlet-class>UploadServlet</servlet-class>
</servlet>

<servlet-mapping>
   <servlet-name>UploadServlet</servlet-name>
   <url-pattern>/UploadServlet</url-pattern>
</servlet-mapping>