Java 从HttpServletRequest取得文件流-CFANZ编程社区

在构建基于 Java 的 Web 应用时，处理用户上传的文件是一项常见的任务。上传的文件通常会作为请求的一部分，以多部分表单数据的形式发送。要在 Java Web 应用中高效地处理这些上传文件，我们通常会利用 HttpServletRequest 对象以及其他相关的工具库。本篇文章将深入探讨如何通过 HttpServletRequest 获取文件流，以及如何在 Java 中处理和保存这些文件。

文件上传的机制

在 HTTP 中，文件通常以多部分表单数据的形式进行上传。这个过程通常涉及 HTML 表单中的 <input type="file"> 标签和表单属性 enctype="multipart/form-data"。当用户提交表单时，浏览器会将文件作为请求体的一部分发送到服务器。

`HttpServletRequest` 的基本使用

HttpServletRequest 是 Java Servlet API 的一部分，它用于表示客户端发送到服务器的 HTTP 请求。它包含请求的头信息、参数、属性以及输入流等信息。要从 HttpServletRequest 中获取上传的文件，我们需要：

确保请求的 Content-Type 是 multipart/form-data。
使用像 Apache Commons FileUpload 或 Servlet 3.0 API 这样的工具处理请求。

使用 Servlet 3.0 API 获取文件

Java Servlet 3.0 提供了一个更简单的方式来处理多部分表单数据。我们可以直接在 Servlet 中使用 @MultipartConfig 注解以及 Part 对象来访问上传的文件。以下是一个示例代码：

java

import java.io.IOException;
import java.io.InputStream;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;

import jakarta.servlet.ServletException;
import jakarta.servlet.annotation.MultipartConfig;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import jakarta.servlet.http.Part;

@MultipartConfig
public class FileUploadServlet extends HttpServlet {
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // 获取上传的文件
        Part filePart = request.getPart("file");
        String fileName = Paths.get(filePart.getSubmittedFileName()).getFileName().toString();
        
        // 保存文件到目标路径
        Path targetPath = Paths.get("/uploads", fileName);
        try (InputStream fileContent = filePart.getInputStream()) {
            Files.copy(fileContent, targetPath);
        }
        
        // 响应客户端
        response.getWriter().println("File " + fileName + " uploaded successfully!");
    }
}

在上面的代码中，我们利用 @MultipartConfig 注解将 FileUploadServlet 标记为能够处理多部分表单数据的 Servlet。然后，通过 request.getPart 方法获取文件部分，并将其保存到服务器文件系统的指定路径。

使用 Apache Commons FileUpload 获取文件

如果你使用的是较旧的 Servlet 版本，或者需要更强大的文件上传处理能力，Apache Commons FileUpload 库是一个理想的选择。以下是使用该库处理文件上传的代码：

添加依赖：

xml

<!-- 在 Maven 的 pom.xml 文件中添加依赖 -->
<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.4</version>
</dependency>

编写处理代码：

java

import java.io.File;
import java.io.IOException;
import java.util.List;

import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;

import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;

public class FileUploadServlet extends HttpServlet {
    private static final long serialVersionUID = 1L;

    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // 检查请求是否为多部分内容
        if (ServletFileUpload.isMultipartContent(request)) {
            DiskFileItemFactory factory = new DiskFileItemFactory();
            ServletFileUpload upload = new ServletFileUpload(factory);

            try {
                // 解析请求中的文件项目
                List<FileItem> formItems = upload.parseRequest(request);

                // 处理每个文件项目
                for (FileItem item : formItems) {
                    if (!item.isFormField()) {
                        String fileName = new File(item.getName()).getName();
                        String filePath = "/uploads/" + fileName;
                        File storeFile = new File(filePath);

                        // 保存文件到服务器文件系统
                        item.write(storeFile);
                        response.getWriter().println("File " + fileName + " uploaded successfully!");
                    }
                }
            } catch (Exception e) {
                e.printStackTrace();
                response.getWriter().println("Error in file upload: " + e.getMessage());
            }
        } else {
            response.getWriter().println("This request does not contain a file.");
        }
    }
}

在这个例子中，我们通过 ServletFileUpload 类来处理多部分表单数据，并使用 FileItem 对象处理文件和普通表单字段。