简介
要浏览并选择要上传的文件，您需要表单中的 HTML <input type="file"> 字段。如HTML specification 中所述，您必须使用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 时相比，a different format 的请求正文中提供二进制多部分表单数据。
在 Servlet 3.0 之前，Servlet API 本身并不支持multipart/form-data。它仅支持application/x-www-form-urlencoded 的默认形式enctype。当使用多部分表单数据时，request.getParameter() 和 consorts 都将返回 null。这就是众所周知的Apache Commons FileUpload 出现的地方。
不要手动解析！
理论上，您可以根据ServletRequest#getInputStream() 自己解析请求正文。然而，这是一项精确而乏味的工作，需要精确了解RFC2388。您不应该尝试自己执行此操作或复制粘贴在 Internet 上其他地方找到的一些本地开发的无库代码。许多在线资源在这方面都失败了，例如roseindia.net。另见uploading of pdf file。您应该使用数百万用户多年来使用（并经过隐式测试！）的真实库。这样的库已经证明了它的稳健性。
如果您已经使用 Servlet 3.0 或更高版本，请使用本机 API
如果您至少使用 Servlet 3.0（Tomcat 7、Jetty 9、JBoss AS 6、GlassFish 3 等），那么您可以使用HttpServletRequest#getPart() 提供的标准 API 来收集单独的多部分表单数据项（大多数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 修复。此浏览器错误地沿名称发送完整的文件路径，而不仅仅是文件名。
如果您想通过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 等）中引入的。如果您还没有使用 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 来解析多部分表单数据请求。它有一个出色的User Guide 和FAQ（仔细检查两者）。还有 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 将获得一个空的请求正文。另见 a.o. ServletFileUpload#parseRequest(request) returns an empty list.
注意FilenameUtils#getName()。这是关于获取文件名的 MSIE 修复。此浏览器错误地沿名称发送完整的文件路径，而不仅仅是文件名。
或者，您也可以将所有内容包装在 Filter 中，它会自动解析所有内容并将内容放回请求的参数映射中，以便您可以继续使用 request.getParameter() 并通过 @ 检索上传的文件987654393@。 You can find an example in this blog article.
getParameter() 的 GlassFish3 错误的解决方法仍然返回 null
请注意，早于 3.1.2 的 Glassfish 版本具有 a 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（上述代码sn-ps中显示的fileContent变量）保存到磁盘或数据库的详细信息，请参阅以下答案：
提供上传的文件
请参阅以下答案，详细了解如何将已保存的文件从磁盘或数据库中正确返回给客户端：
Ajaxifying 表单
前往以下回答如何使用 Ajax（和 jQuery）上传。请注意，不需要为此更改收集表单数据的 servlet 代码！只有您响应的方式可能会改变，但这相当简单（即，不是转发到 JSP，而是打印一些 JSON 或 XML，甚至是纯文本，具体取决于负责 Ajax 调用的脚本所期望的内容）。
希望这一切都有帮助:)