协慌网

 登录 贡献 社区

如何使用 JSP / Servlet 将文件上传到服务器？

如何使用 JSP / Servlet 将文件上传到服务器？我尝试了这个：

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

但是，我只得到文件名，而不得到文件内容。当我将enctype="multipart/form-data"到<form> ，然后request.getParameter()返回null 。

在研究期间，我偶然发现了Apache Common FileUpload 。我尝试了这个：

FileItemFactory factory = new DiskFileItemFactory();
ServletFileUpload upload = new ServletFileUpload(factory);
List items = upload.parseRequest(request); // This line is where it died.

不幸的是，该 servlet 抛出了一个异常，没有明确的消息和原因。这是堆栈跟踪：

SEVERE: Servlet.service() for servlet UploadServlet threw exception
javax.servlet.ServletException: Servlet execution threw an exception
    at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:313)
    at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)
    at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:233)
    at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:191)
    at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:127)
    at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:102)
    at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:109)
    at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:298)
    at org.apache.coyote.http11.Http11Processor.process(Http11Processor.java:852)
    at org.apache.coyote.http11.Http11Protocol$Http11ConnectionHandler.process(Http11Protocol.java:588)
    at org.apache.tomcat.util.net.JIoEndpoint$Worker.run(JIoEndpoint.java:489)
    at java.lang.Thread.run(Thread.java:637)

答案

介绍

要浏览并选择要上传的文件，您需要在表单中有一个 HTML <input type="file">字段。如 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 之前，Servlet API 本身不支持multipart/form-data 。它仅支持application/x-www-form-urlencoded的默认表单编码。使用多部分表单数据时， request.getParameter()和 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 等），则可以使用提供的标准 API HttpServletRequest#getPart()来收集单个多部分表单数据项（大多数 Servlet 3.0 实作实际上是在此幕后使用 Apache Commons FileUpload！）。同样，正常形式的字段也可以通过getParameter()以常规方式使用。

@MultipartConfig注释 servlet，以使其识别并支持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 修复程序。该浏览器错误地沿名称发送了完整的文件路径，而不仅仅是文件名。

如果您使用<input type="file" name="file" multiple="true" />进行多文件上传，请按以下方式收集它们（不幸的是，没有诸如request.getParts("file") ）：

protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    // ...
    List<Part> fileParts = request.getParts().stream().filter(part -> "file".equals(part.getName()) && part.getSize() > 0).collect(Collectors.toList()); // Retrieves <input type="file" name="file" 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 等）。如果尚未使用 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中包含以下文件：

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

这是一个启动示例，使用 Apache Commons FileUpload 时， UploadServlet doPost()

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 将获得一个空的请求主体。另请参见ServletFileUpload＃parseRequest（request）返回一个空列表。

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

另外，您也可以将所有内容包装在Filter ，该 Filter 会自动对其进行解析，然后将其放回请求的参数图中，以便您可以继续按常规方式request.getParameter() request.getAttribute() 。您可以在此博客文章中找到示例。

getParameter() GlassFish3 错误的变通办法仍返回null

请注意，低于 3.1.2 的 Glassfish 版本有一个 bug，其中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变量）保存到磁盘或数据库中：

提供上传的文件

请访问以下答案，详细了解如何将已保存的文件从磁盘或数据库正确地提供给客户端：

拼凑形式

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

希望这对您有所帮助:)

如果您碰巧使用 Spring MVC，这是怎么做的：（如果有人觉得有用，我将其保留在这里）。

使用enctype属性设置为 “ multipart/form-data ” 的表单（与 BalusC 的答案相同）

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

在控制器中，将请求参数file映射为MultipartFile类型，如下所示：

@RequestMapping(value = "/upload", method = RequestMethod.POST)
public void handleUpload(@RequestParam("file") MultipartFile file) throws IOException {
    if (!file.isEmpty()) {
            byte[] bytes = file.getBytes(); // alternatively, file.getInputStream();
            // application logic
    }
}

MultipartFile的getOriginalFilename()和getSize()获得文件名和大小。

我已经用 Spring 4.1.1.RELEASE测试了它。

在 Tomcat 6 o 7 中没有组件或外部库

在 web.xml文件中启用上载：

http://joseluisbz.wordpress.com/2014/01/17/manually-installing-php-tomcat-and-httpd-lounge/#Enabling%20File%20Uploads 。

<servlet>
    <servlet-name>jsp</servlet-name>
    <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class>
    <multipart-config>
      <max-file-size>3145728</max-file-size>
      <max-request-size>5242880</max-request-size>
    </multipart-config>
    <init-param>
        <param-name>fork</param-name>
        <param-value>false</param-value>
    </init-param>
    <init-param>
        <param-name>xpoweredBy</param-name>
        <param-value>false</param-value>
    </init-param>
    <load-on-startup>3</load-on-startup>
</servlet>

如您所见：

<multipart-config>
      <max-file-size>3145728</max-file-size>
      <max-request-size>5242880</max-request-size>
    </multipart-config>

使用 JSP 上传文件。档案：

在 html 文件中

<form method="post" enctype="multipart/form-data" name="Form" >

  <input type="file" name="fFoto" id="fFoto" value="" /></td>
  <input type="file" name="fResumen" id="fResumen" value=""/>

在 JSP 文件或Servlet 中

InputStream isFoto = request.getPart("fFoto").getInputStream();
    InputStream isResu = request.getPart("fResumen").getInputStream();
    ByteArrayOutputStream baos = new ByteArrayOutputStream();
    byte buf[] = new byte[8192];
    int qt = 0;
    while ((qt = isResu.read(buf)) != -1) {
      baos.write(buf, 0, qt);
    }
    String sResumen = baos.toString();

根据 servlet 要求编辑代码，例如max-file-size ， max-request-size和其他可以设置的选项...