介绍
要浏览并选择要上传的文件，您需要在表单中显示一个 HTML 字段。如 HTML 规范中所述，您必须使用该方法，并且表单的属性必须设置为 。<input type="file">POSTenctype"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 本身并不支持 。它仅支持 的默认格式 enctype 。使用多部分表单数据时，和 consorts 都将返回。这就是众所周知的Apache Commons FileUpload进入画面的地方。multipart/form-dataapplication/x-www-form-urlencodedrequest.getParameter()null
不要手动解析它！
理论上，您可以根据 ServletRequest#getInputStream（） 自行解析请求正文。但是，这是一项精确而繁琐的工作，需要对RFC2388的精确了解。你不应该尝试自己做这件事，或者复制粘贴一些在互联网上其他地方找到的本土无库代码。许多在线资源在这方面都失败了，例如 roseindia.net。另请参阅上传 pdf 文件。你应该使用一个真正的库，它被数百万用户使用（并隐式测试！）多年。这样的库已经证明了它的稳健性。
如果您已经在使用 Servlet 3.0 或更高版本，请使用本机 API
如果你至少使用Servlet 3.0（Tomcat 7，Jetty 9，JBoss AS 6，GlassFish 3等，它们自2010年以来就已经存在），那么你可以使用提供的标准API HttpServletRequest#getPart（）来收集单个多部分表单数据项（大多数Servlet 3.0实现实际上使用Apache Commons FileUpload为此掩护！此外，普通表单字段按常规方式提供。getParameter()
首先用@MultipartConfig注释你的 servlet，以便让它识别和支持请求，从而开始工作：multipart/form-datagetPart()
@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)
}
请注意.这是用于获取文件名的 MSIE 修复程序。此浏览器错误地沿名称发送完整的文件路径，而不仅仅是文件名。Path#getFileName()
如果您想通过以下方式上传多个文件，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”），但它有一些（小）错误，并且多年来不再积极维护。我不建议使用它。Apache Commons FileUpload仍在积极维护，目前非常成熟。MultipartRequest
为了使用Apache Commons FileUpload，您需要在Web应用程序中至少包含以下文件：/WEB-INF/lib
您最初的尝试失败很可能是因为您忘记了共享资源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);
}
// ...
}
非常重要的是，您不要事先在同一请求上调用 、、 、 、 等。否则，Servlet容器将读取并解析请求正文，因此Apache Commons FileUpload将获得一个空的请求正文。另请参阅 a.o. ServletFileUpload#parseRequest（request） 返回一个空列表。getParameter()getParameterMap()getParameterValues()getInputStream()getReader()
请注意.这是用于获取文件名的 MSIE 修复程序。此浏览器错误地沿名称发送完整的文件路径，而不仅仅是文件名。FilenameUtils#getName()
或者，您也可以将这一切包装在一个中，自动解析所有内容，并将内容放回请求的参数映射中，以便您可以继续使用通常的方式并通过 检索上传的文件。您可以在此博客文章中找到一个示例。Filterrequest.getParameter()request.getAttribute()
GlassFish3 仍然返回的错误解决方法getParameter()null
请注意，早于3.1.2的Glassfish版本有一个错误，其中仍然返回 。如果您的目标是这样的容器并且无法升级它，则需要借助以下实用程序方法从中提取值：getParameter()nullgetPart()
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()
有关将获得的（如上面的代码片段中所示的变量）正确保存到磁盘或数据库的详细信息，请转到以下答案：InputStreamfileContent
提供上传的文件
请转到以下答案，了解有关将保存的文件从磁盘或数据库正确提供给客户端的详细信息：
对表单进行混杂
前往以下答案如何使用Ajax（和jQuery）上传。请注意，用于收集表单数据的 servlet 代码不需要为此进行更改！只有您的响应方式可能会改变，但这是相当微不足道的（即，根据负责Ajax调用的脚本所期望的任何内容，只需打印一些JSON或XML甚至纯文本，而不是转发到JSP）。
希望这一切都有助于:)
