Java Servlet 文件上傳 · JavaTutorialNetwork 中文系列教程

# Java Servlet 文件上傳 > 原文： [https://javatutorial.net/java-servlet-file-upload](https://javatutorial.net/java-servlet-file-upload) 本示例演示如何使用 Java Servlet 上傳文件始終可以將文件上傳到 Java EE Servlet，但是要完成該工作需要付出很大的努力。 Apache Foundation 甚至構建了一個稱為 Commons FileUpload 的庫，以使此任務更易于實現。盡管如此，Servlet 3.0 規范彌補了這一差距，并且自 Java EE 6 起，多部分配置選項已添加到 Servlet 中，從而在`HttpServletRequest`中引入了`getPart`和`getParts`方法。如果您有興趣使用 WebServices 將文件上傳到服務器，則可以查看本[教程](https://javatutorial.net/java-file-upload-rest-service)。 ## Servlet 文件上傳示例 Servlet 文件上載示例演示了`MultipartConfig`注解的用法，并使用戶能夠上載一個或兩個文件。該示例項目的結構非常簡單。它由一個 servlet 文件`FileUploadServlet.java`，`pom.xml`和可選的`web.xml`組成，這些文件用于在構建時處理依賴項。正如我們在 [Servlet 注釋示例](https://javatutorial.net/servlet-annotation-example)中討論的那樣，您可以在注釋和部署描述符之間進行選擇，以設置 Servlet 配置。本示例使用注釋。下圖顯示了項目結構 ![Servlet file upload project structure](https://img.kancloud.cn/e9/d5/e9d58c3ccdad649a9cd820113f6cb7a3_230x221.jpg) Servlet 文件上傳項目結構在 Maven 的`pom.xml`文件中，我們需要聲明的唯一依賴項是`javax.servlet` ```java <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>net.javatutorial.tutorials</groupId> <artifactId>ServletFileUpload</artifactId> <version>1</version> <packaging>war</packaging> <name>ServletFileUpload</name> <url>https://javatutorial.net</url> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> </properties> <dependencies> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>3.1.0</version> <scope>provided</scope> </dependency> </dependencies> <build> <finalName>fileuploader</finalName> <sourceDirectory>src/main/java</sourceDirectory> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-war-plugin</artifactId> <version>2.3</version> <configuration> <warSourceDirectory>src/main/webapp</warSourceDirectory> </configuration> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.1</version> <configuration> <source>1.8</source> <target>1.8</target> </configuration> </plugin> </plugins> </build> </project> ``` 文件上傳 servlet 是我們項目的核心。它只有兩種方法 - `goGet`（顯示上載表格）和`doPost`（完成整個上載工作）。 ```java package net.javatutorial.tutorials; import java.io.File; import java.io.IOException; import java.io.PrintWriter; import javax.servlet.ServletException; import javax.servlet.annotation.MultipartConfig; import javax.servlet.annotation.WebServlet; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import javax.servlet.http.Part; @WebServlet(name = "uploadServlet", urlPatterns = { "/upload" }, loadOnStartup = 1) @MultipartConfig(fileSizeThreshold = 6291456, // 6 MB maxFileSize = 10485760L, // 10 MB maxRequestSize = 20971520L // 20 MB ) public class FileUploadServlet extends HttpServlet { private static final long serialVersionUID = 5619951677845873534L; private static final String UPLOAD_DIR = "uploads"; @Override protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { response.setContentType("text/html"); response.setCharacterEncoding("UTF-8"); PrintWriter writer = response.getWriter(); writer.append("<!DOCTYPE html>\r\n") .append("<html>\r\n") .append(" <head>\r\n") .append(" <title>File Upload Form</title>\r\n") .append(" </head>\r\n") .append(" <body>\r\n"); writer.append("<h1>Upload file</h1>\r\n"); writer.append("<form method=\"POST\" action=\"upload\" ") .append("enctype=\"multipart/form-data\">\r\n"); writer.append("<input type=\"file\" name=\"fileName1\"/><br/><br/>\r\n"); writer.append("<input type=\"file\" name=\"fileName2\"/><br/><br/>\r\n"); writer.append("<input type=\"submit\" value=\"Submit\"/>\r\n"); writer.append("</form>\r\n"); writer.append(" </body>\r\n").append("</html>\r\n"); } @Override protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { response.setContentType("text/html"); response.setCharacterEncoding("UTF-8"); // gets absolute path of the web application String applicationPath = request.getServletContext().getRealPath(""); // constructs path of the directory to save uploaded file String uploadFilePath = applicationPath + File.separator + UPLOAD_DIR; // creates upload folder if it does not exists File uploadFolder = new File(uploadFilePath); if (!uploadFolder.exists()) { uploadFolder.mkdirs(); } PrintWriter writer = response.getWriter(); // write all files in upload folder for (Part part : request.getParts()) { if (part != null && part.getSize() > 0) { String fileName = part.getSubmittedFileName(); String contentType = part.getContentType(); // allows only JPEG files to be uploaded if (!contentType.equalsIgnoreCase("image/jpeg")) { continue; } part.write(uploadFilePath + File.separator + fileName); writer.append("File successfully uploaded to " + uploadFolder.getAbsolutePath() + File.separator + fileName + "<br>\r\n"); } } } } ``` `@MultipatrtConfig`注解使 Servlet 可以接受文件上傳。有 3 個重要屬性： * `fileSizeThreshold` – 在將文件寫入`temp`目錄之前要超出的文件大小。如果文件小于此閾值，則文件將在請求完成之前駐留在內存中。 * `maxFileSize` – 這是允許上傳的文件的最大大小。在上面的示例中，不允許用戶上傳大于 10 MB 的文件 * `maxRequestSize` – 是我們嘗試通過一個請求上傳的所有文件的大小的總和。在上面的示例中，我們將該值設置為 20 MB，這意味著無論文件數量多少，我們總共可以上傳 20MB 您可能要指定或不指定第四個屬性。它稱為`location`，它指向 Web 容器應存儲臨時文件的目錄。但是，如果您未指定此屬性，則容器將使用默認的`temp`文件夾。我們重寫`doGet`方法以顯示具有兩個文件選擇器字段的簡單形式。您可能需要添加其他輸入字段，因為多部分附件允許這樣做。 ![The form to upload files](https://img.kancloud.cn/bb/82/bb82ef9ee925895173351f082a122f90_237x181.jpg) 表格上傳文件在`doPost`方法中，我們首先構造要存儲上載文件的文件夾的路徑。比我們使用`request.getParts()`遍歷用戶選擇上傳的文件，最后將它們存儲到所需位置。構建并部署后，您可以在以下瀏覽器中訪問應用程序：`http://localhost:8080/fileuploader/upload` 您可以在我們的 GitHub 存儲庫的[中找到該項目](https://github.com/JavaTutorialNetwork/Tutorials/tree/master/ServletFileUpload)。