如何使用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)
介绍
要浏览并选择要上传的文件,您需要在表单中<input type="file">
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
的默认表单enctype。 使用多部分表单数据时, request.getParameter()
和consorts都会返回null
。 这是众所周知的Apache Commons FileUpload进入图片的地方。
不要手动解析它!
你理论上可以根据ServletRequest#getInputStream()
自己解析请求体。 但是,这是一项精确且乏味的工作,需要对RFC2388进行精确的了解。 你不应该自己尝试这样做,或者复制一些在互联网上其他地方找到的本地无库代码。 许多在线资源在这方面都失败了,比如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")
这样的方法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())).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
中至少需要以下文件:
commons-fileupload.jar
commons-io.jar
你最初的尝试很可能失败了,因为你忘记了公共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);
}
// ...
}
事先getReader()
在同一请求中调用getParameter()
, getParameterMap()
, getParameterValues()
, getInputStream()
, getReader()
等非常重要。 否则,servlet容器将读取并解析请求主体,因此Apache Commons FileUpload将获得一个空的请求主体。 另请参见ao ServletFileUpload#parseRequest(request)返回一个空列表。
请注意FilenameUtils#getName()
。 这是获取文件名的MSIE修复程序。 此浏览器不正确地沿名称发送完整文件路径而不是仅发送文件名。
或者,您也可以将其全部包装在一个Filter
,该Filter
会自动解析它,并将这些内容放回到请求的参数映射中,以便您可以继续使用request.getParameter()
常规方法并通过request.getAttribute()
。 你可以在这篇博客文章中找到一个例子。
GlassFish3 getParameter()
bug的解决方法仍然返回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
变量如上面的代码片段所示)正确保存到磁盘或数据库的详细信息,请参阅以下答案:
提供上传的文件
有关将保存的文件从磁盘或数据库正确服务回客户端的详细信息,请参阅以下答案:
Ajax化表单
请教如何使用Ajax(和jQuery)上传以下答案。 请注意,收集表单数据的servlet代码无需为此更改! 只有你的回应方式可能会发生变化,但这是相当微不足道的(即不是转发到JSP,而是根据负责Ajax调用的脚本所期待的打印一些JSON或XML,甚至纯文本)。
希望这一切帮助:)
如果你碰巧使用了Spring MVC,那么就是:(如果有人觉得它有用,我会把它留在这里)。
使用enctype
属性设置为“ multipart/form-data
”的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
测试过了。
您需要将common-io.1.4.jar
文件包含在lib
目录中,或者如果您在任何编辑器(如NetBeans)中工作,则需要转到项目属性并添加JAR文件,您将完成。
要获取common.io.jar
文件,只需将它放到Google上,或者直接转到Apache Tomcat网站,您可以在其中获得免费下载此文件的选项。 但请记住一件事:如果您是Windows用户,请下载二进制ZIP文件。
上一篇: How to upload files to server using JSP/Servlet?
下一篇: Ajax Post Content Type : Application / Json Block the request