介绍

要浏览并选择要上传的文件，您需要<input type="file">表单中的 HTML 字段。如HTML
规范中所述，您必须使用该POST方法，并且enctype必须将表单的属性设置为"multipart/form- data".

<form action="upload" method="post" enctype="multipart/form-data">
    <input type="text" name="description" />
    <input type="file" name="file" />
    <input type="submit" />
</form>

提交此类表单后，请求正文中的二进制多部分表单数据的格式与enctype未设置时不同。

在 Servlet 3.0（2009 年 12 月）之前，Servlet API 本身并不支持multipart/form-data. 它仅支持默认形式
enctype application/x-www-form- urlencoded。使用多部分表单数据时，request.getParameter()and consorts
将全部返回。null这就是著名的Apache Commons
FileUpload出现的地方。

不要手动解析它！

理论上，您可以根据自己解析请求正文ServletRequest#getInputStream()。然而，这是一项精确而乏味的工作，需要对RFC2388有准确的了解。您不应该尝试自己执行此操作或复制粘贴在
Internet 上其他地方找到的一些本地开发的无库代码。许多在线资源在这方面都失败了，例如roseindia.net。另请参阅上传 pdf
文件。您应该使用数百万用户多年来使用（并经过隐式测试！）的真实库。这样的库已经证明了它的健壮性。

如果您已经使用 Servlet 3.0 或更新版本，请使用本机 API

如果您至少使用 Servlet 3.0（Tomcat 7、Jetty 9、JBoss AS 6、GlassFish 3 等，它们自 2010
年以来就已经存在），那么您可以使用提供的标准
APIHttpServletRequest#getPart()来收集单独的多部分表单数据项（大多数Servlet
3.0 实现 实际上 为此使用了 Apache Commons
FileUpload！）。此外，正常的表单域也可以通过getParameter()通常的方式获得。

首先注释您的 servlet
以@MultipartConfig使其识别和支持multipart/form- data请求，从而开始getPart()工作：

@WebServlet("/upload")
@MultipartConfig
public class UploadServlet extends HttpServlet {
    // ...
}

然后，doPost()按如下方式实现：

protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    String description = request.getParameter("description"); // Retrieves <input type="text" name="description">
    Part filePart = request.getPart("file"); // Retrieves <input type="file" name="file">
    String fileName = Paths.get(filePart.getSubmittedFileName()).getFileName().toString(); // MSIE fix.
    InputStream fileContent = filePart.getInputStream();
    // ... (do your job here)
}

注意Path#getFileName(). 这是关于获取文件名的 MSIE 修复。此浏览器错误地沿名称发送完整文件路径，而不仅仅是文件名。

如果您想通过任一方式上传多个文件multiple="true"，

<input type="file" name="files" multiple="true" />

或具有多个输入的老式方式，

<input type="file" name="files" />
<input type="file" name="files" />
<input type="file" name="files" />
...

那么你可以如下收集它们（不幸的是没有这样的方法request.getParts("files")）：

protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    // ...
    List<Part> fileParts = request.getParts().stream().filter(part -> "files".equals(part.getName()) && part.getSize() > 0).collect(Collectors.toList()); // Retrieves <input type="file" name="files" multiple="true">

    for (Part filePart : fileParts) {
        String fileName = Paths.get(filePart.getSubmittedFileName()).getFileName().toString(); // MSIE fix.
        InputStream fileContent = filePart.getInputStream();
        // ... (do your job here)
    }
}

当您还没有使用 Servlet 3.1 时，手动获取提交的文件名

请注意，这Part#getSubmittedFileName()是在
Servlet 3.1 中引入的（Tomcat 8、Jetty 9、WildFly 8、GlassFish 4 等，它们自 2013
年以来就已经存在）。如果您还没有使用 Servlet 3.1（真的吗？），那么您需要一个额外的实用程序方法来获取提交的文件名。

private static String getSubmittedFileName(Part part) {
    for (String cd : part.getHeader("content-disposition").split(";")) {
        if (cd.trim().startsWith("filename")) {
            String fileName = cd.substring(cd.indexOf('=') + 1).trim().replace("\"", "");
            return fileName.substring(fileName.lastIndexOf('/') + 1).substring(fileName.lastIndexOf('\\') + 1); // MSIE fix.
        }
    }
    return null;
}



String fileName = getSubmittedFileName(filePart);

请注意有关获取文件名的 MSIE 修复。此浏览器错误地沿名称发送完整文件路径，而不仅仅是文件名。

如果您还没有使用 Servlet 3.0，请使用 Apache Commons FileUpload

如果您还没有使用 Servlet 3.0（是不是该升级了？它已经在十多年前发布了！），通常的做法是使用Apache Commons
FileUpload来解析多部分表单数据请求。它有一个优秀的用户指南和常见问题解答（仔细阅读两者）。还有
O’Reilly (” cos “)
MultipartRequest，但它有一些（小）错误，并且多年来不再积极维护。我不建议使用它。Apache Commons FileUpload
仍在积极维护中，目前非常成熟。

为了使用 Apache Commons FileUpload，您的 webapp 中至少需要有以下文件/WEB-INF/lib：

• commons-fileupload.jar
• commons-io.jar

您最初的尝试很可能失败了，因为您忘记了公共 IO。

以下是使用 Apache Commons FileUpload 时doPost()的启动示例：UploadServlet

protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    try {
        List<FileItem> items = new ServletFileUpload(new DiskFileItemFactory()).parseRequest(request);
        for (FileItem item : items) {
            if (item.isFormField()) {
                // Process regular form field (input type="text|radio|checkbox|etc", select, etc).
                String fieldName = item.getFieldName();
                String fieldValue = item.getString();
                // ... (do your job here)
            } else {
                // Process form file field (input type="file").
                String fieldName = item.getFieldName();
                String fileName = FilenameUtils.getName(item.getName());
                InputStream fileContent = item.getInputStream();
                // ... (do your job here)
            }
        }
    } catch (FileUploadException e) {
        throw new ServletException("Cannot parse multipart request.", e);
    }

    // ...
}

事先不要在同一个请求上调用getParameter(), getParameterMap(), getParameterValues(),
getInputStream(),等，这一点非常重要。getReader()否则 servlet 容器将读取并解析请求正文，因此 Apache
Commons FileUpload 将获得一个空的请求正文。另请参阅 ao
ServletFileUpload#parseRequest(request)返回一个空列表。

注意FilenameUtils#getName(). 这是关于获取文件名的 MSIE 修复。此浏览器错误地沿名称发送完整文件路径，而不仅仅是文件名。

或者，您也可以将所有内容包装在一个Filter自动解析所有内容并将内容放回请求的参数映射中，以便您可以继续使用request.getParameter()通常的方式并通过request.getAttribute().

GlassFish3getParameter()仍然返回的错误的解决方法null

请注意，早于 3.1.2 的 Glassfish
版本有一个错误，其中getParameter()仍然返回null.
如果您的目标是这样一个容器并且无法升级它，那么您需要getPart()借助此实用方法从中提取值：

private static String getValue(Part part) throws IOException {
    BufferedReader reader = new BufferedReader(new InputStreamReader(part.getInputStream(), "UTF-8"));
    StringBuilder value = new StringBuilder();
    char[] buffer = new char[1024];
    for (int length = 0; (length = reader.read(buffer)) > 0;) {
        value.append(buffer, 0, length);
    }
    return value.toString();
}



String description = getValue(request.getPart("description")); // Retrieves <input type="text" name="description">

保存上传的文件（不要使用getRealPath()也不part.write()！）

InputStream有关将获得的（fileContent如上面代码片段中所示的变量）正确保存到磁盘或数据库的详细信息

Ajaxifying 表单

前往以下答案如何使用 Ajax（和 jQuery）上传。请注意，不需要为此更改收集表单数据的 servlet
代码！只有您响应的方式可能会改变，但这相当简单（即，不是转发到 JSP，而是打印一些 JSON 或 XML 甚至纯文本，具体取决于负责 Ajax
调用的脚本所期望的内容）。

希望这一切都有帮助:)