利用org.apache.commons.fileupload上传多个文件

Apache Commons FileUpload 是一个用于处理 HTTP 请求中多部分（multipart）数据的 Java 库，尤其适合上传文件。在本文中，我们将深入探讨如何利用该库实现多个文件的上传功能。 一、准备工作 在使用 Apache Commons FileUpload 进行文件上传之前，你需要确保以下组件已经准备就绪： 1. **引入依赖**：你需要下载并添加 `org.apache.commons.io` 和 `log4j` 的 JAR 包到你的项目类路径中。在本例中，`io` 包版本为 2.2，而 `log4j` 可用于日志记录，提高程序的可调试性。 2. **配置环境**：如果你选择使用 `log4j`，则需要配置相应的日志配置文件，以便在上传过程中记录重要信息。 二、代码示例 以下是一个简单的 Servlet 示例，用于处理多文件上传： ```java import java.io.File; import java.io.FileOutputStream; import java.io.IOException; import java.io.InputStream; import java.io.OutputStream; import javax.servlet.ServletException; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import org.apache.commons.fileupload.FileItem; import org.apache.commons.fileupload.FileUploadException; import org.apache.commons.fileupload.disk.DiskFileItemFactory; import org.apache.commons.fileupload.servlet.ServletFileUpload; import org.apache.log4j.Logger; public class FileServlet extends HttpServlet { private static final long serialVersionUID = -3396226353127679129L; static Logger logger = Logger.getLogger(FileServlet.class); public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // 配置 DiskFileItemFactory DiskFileItemFactory factory = new DiskFileItemFactory(); String path = request.getRealPath("/fileupload"); factory.setRepository(new File(path)); factory.setSizeThreshold(1024 * 1024); // 设置内存阈值 // 创建 ServletFileUpload 实例 ServletFileUpload upload = new ServletFileUpload(factory); try { List<FileItem> items = upload.parseRequest(request); Iterator<FileItem> iter = items.iterator(); while (iter.hasNext()) { FileItem item = iter.next(); if (item.isFormField()) { // 处理普通表单字段 String name = item.getFieldName(); String value = item.getString(); request.setAttribute(name, value); } else { // 处理文件字段 String fieldName = item.getFieldName(); String fileName = item.getName(); String contentType = item.getContentType(); boolean isInMemory = item.isInMemory(); long sizeInBytes = item.getSize(); // 提取文件名 String savedFileName = fileName.substring(fileName.lastIndexOf("\\") + 1); // 保存文件到服务器 saveFile(item, path, savedFileName); } } } catch (FileUploadException e) { logger.error("File upload failed", e); // 处理异常 } } private void saveFile(FileItem item, String path, String savedFileName) throws IOException { File uploadedFile = new File(path, savedFileName); InputStream is = item.getInputStream(); OutputStream os = new FileOutputStream(uploadedFile); byte[] buffer = new byte[1024]; int length; while ((length = is.read(buffer)) > 0) { os.write(buffer, 0, length); } is.close(); os.close(); } } ``` 在这个示例中： - 我们创建了一个 `DiskFileItemFactory` 对象来配置临时存储和内存阈值。 - 接着，我们使用 `ServletFileUpload` 解析请求中的多部分数据。 - `doPost` 方法遍历所有 `FileItem`，区分普通表单字段和文件字段。对于文件字段，我们保存文件到服务器。 - `saveFile` 方法读取 `FileItem` 中的输入流，将其写入服务器上的文件。 三、关键知识点 1. **DiskFileItemFactory**：这是处理文件上传的基础，它负责在内存或磁盘上存储临时文件，并允许设置内存阈值，超过该阈值后，文件将被写入磁盘。 2. **ServletFileUpload**：解析 HTTP 请求中的多部分数据，生成 `FileItem` 对象，每个对象代表一个表单字段或上传文件。 3. **FileItem**：提供了访问上传文件和表单字段的方法，如 `isFormField()`、`getFieldName()`、`getName()`、`getInputStream()` 等。 4. **上传文件保存**：通常，我们需要将 `FileItem` 的输入流写入服务器指定位置的文件。在上面的示例中，我们使用 `FileOutputStream` 将数据写入到文件系统。 5. **错误处理**：文件上传可能会出现异常，例如 `FileUploadException`。在实际应用中，应捕获这些异常并采取适当的措施，如返回错误信息或重试上传。 Apache Commons FileUpload 提供了一种方便的方式来处理 HTTP 文件上传，通过其提供的工具类和接口，我们可以轻松地在 Java Web 应用中实现多文件上传的功能。注意，在生产环境中，还需要考虑安全性问题，如限制文件大小、检查文件类型以及防止恶意文件上传等。