【Java组件 Commons-FileUpload 文件上传详解】
在Java Web开发中，文件上传是一个常见的需求，Apache Commons FileUpload组件提供了一种高效且易于使用的解决方案。这个组件使得开发者能够方便地处理HTTP请求中的多部分数据，包括文件上传。下面我们将详细介绍如何使用Commons FileUpload来实现文件上传功能。
Commons FileUpload是Apache Commons项目的一部分，可以从官方网站（http://commons.apache.org/fileupload/）获取最新版本的jar包。通常，你需要将其添加到你的项目类路径中，例如，将`commons-fileupload-1.x.jar`复制到Tomcat服务器的`webapps/你的webapp/WEB-INF/lib`目录下。
创建一个Servlet，如`FileUploadServlet`，来处理文件上传请求。在这个例子中，我们定义了一个私有变量`uploadDir`作为上传文件的存储位置，如`"C:\\temp"`。在`doPost`方法中，我们将实现文件上传逻辑：
```java
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
ServletFileUpload upload = new ServletFileUpload();
// 设置最大文件大小为1MB
upload.setFileSizeMax(1024 * 1024);
FileItemIterator it = upload.getItemIterator(req);
try {
while (it.hasNext()) {
FileItemStream item = it.next();
if (!item.isFormField()) {
handleFileItem(item);
}
}
req.getRequestDispatcher("success.jsp").forward(req, resp);
} catch (FileUploadException e) {
throw new ServletException("Cannot upload file.", e);
}
}
```
在`handleFileItem`方法中，我们处理每个上传的文件项。对于非表单字段（即上传的文件），我们打开文件流并将其内容写入到指定的目录。这里，我们利用UUID生成一个唯一的文件名以避免文件重名：
```java
void handleFileItem(FileItemStream item) throws IOException {
System.out.println("upload file: " + item.getName());
File newUploadFile = new File(uploadDir + "/" + UUID.randomUUID().toString());
byte[] buffer = new byte[4096];
InputStream input = null;
OutputStream output = null;
try {
input = item.openStream();
output = new BufferedOutputStream(new FileOutputStream(newUploadFile));
for (;;) {
int n = input.read(buffer);
if (n == -1) break;
output.write(buffer, 0, n);
}
} finally {
if (input != null) {
try {
input.close();
} catch (IOException ioe) {}
}
if (output != null) {
try {
output.close();
} catch (IOException ioe) {}
}
}
}
```
在这个例子中，我们使用了`ServletFileUpload`类来解析请求，设置最大文件大小，然后迭代每个`FileItemStream`。对于每个文件项，我们打开输入流，创建一个新的输出流到目标文件，然后逐块读取输入流并将数据写入输出流。确保输入流和输出流都被正确关闭。
在实际应用中，你可能还需要处理其他细节，比如验证文件类型、检查文件大小、处理异常等。此外，文件保存路径应考虑安全性，避免使用绝对路径，可以使用相对路径或者配置文件来动态设置。成功上传后，你可以重定向用户到一个确认页面，如`success.jsp`，显示上传结果。
总结来说，Apache Commons FileUpload组件提供了处理文件上传的强大功能，通过简单的API，开发者可以轻松地在Java Web应用中集成文件上传功能。通过以上步骤，你可以快速实现一个基本的文件上传服务，但记得根据具体需求进行扩展和优化。
