Apache Commons FileUpload: 多文件上传示例与日志配置

在Java编程中，Apache Commons FileUpload是一个非常实用的库，用于处理HTTP请求中的文件上传功能。本文档主要介绍了如何利用org.apache.commons.fileupload进行多文件上传，并结合log4j的日志管理。以下将详细介绍所需准备、代码实现以及注意事项。 准备工作 1. 依赖包下载： 首先，你需要下载Apache Commons IO包，本示例中使用的是2.2版本，它提供了丰富的文件操作工具，包括读写、路径处理等。下载地址通常可以从Apache官网获取，或者通过Maven或Gradle集成到项目中。 2. 日志管理： 建议使用log4j作为日志框架，它提供了灵活的配置和详细的日志记录。你需要下载log4j的相应版本并添加到项目的类路径中，以便于跟踪和调试文件上传过程中的日志信息。 代码示例 创建上传的servlet： ```java import org.apache.commons.fileupload.*; 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; private static Logger logger = Logger.getLogger(FileServlet.class); // ...省略其他import语句... @Override protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // 初始化文件上传工厂 DiskFileItemFactory factory = new DiskFileItemFactory(); // 创建上传处理器，指定临时目录 ServletFileUpload upload = new ServletFileUpload(factory); upload.setSizeMax(10 * 1024 * 1024); // 设置上传文件大小限制，这里10MB try { // 检查请求是否支持多部分上传 if (!ServletFileUpload.isMultipartContent(request)) { logger.info("请求不支持多部分上传"); // 处理非multipart请求逻辑 return; } // 创建一个进度监听器（可选，用于跟踪上传进度） ProgressListener progressListener = new MyProgressListener(); List<FileItem> items = upload.parseRequest(request); logger.info("上传开始"); // 遍历上传的文件项 for (FileItem item : items) { // 检查是否是文件上传 if (item.isFormField()) { // 处理表单字段 String name = item.getFieldName(); String value = item.getString(); logger.debug("处理表单字段: " + name + " = " + value); } else { // 文件上传 String fileName = item.getName(); String tempPath = item TEMPORARY_NAME; // 获取临时文件路径 File targetFile = new File(ServletContext.getRealPath("/") + "/uploads/" + fileName); // 定义目标文件存储路径 OutputStream outputStream = new FileOutputStream(targetFile); item.write(outputStream); outputStream.close(); logger.info("文件上传成功: " + fileName); } } // 清理临时文件 Iterator<FileItem> iterator = items.iterator(); while (iterator.hasNext()) { FileItem fileItem = iterator.next(); if (!fileItem.isFormField()) { fileItem.delete(); } } // 返回响应，告知用户上传完成 response.setContentType("text/plain"); PrintWriter writer = response.getWriter(); writer.println("文件上传成功"); } catch (FileUploadException e) { logger.error("文件上传异常", e); // 处理上传错误 } } private class MyProgressListener implements ProgressListener { // 实现ProgressListener接口，提供上传进度更新的方法 // ...省略具体实现... } } ``` 注意事项 1. 文件上传验证： 在实际应用中，除了检查请求类型外，还需确保上传文件的类型、大小、格式等符合预期，避免安全风险。 2. 临时文件处理： DiskFileItemFactory默认会在服务器的临时目录下保存上传文件，记得在完成后删除这些临时文件，以释放磁盘空间。 3. 安全性： 考虑到文件名注入和路径遍历攻击，确保在存储文件时对文件名进行校验和规范化。 4. 错误处理： 在处理上传过程中可能出现各种异常，如网络问题、磁盘空间不足等，需要捕获并提供合适的错误提示或处理机制。 5. 线程安全： 如果在一个多线程环境中使用，需确保文件上传和清理操作在适当的时间执行，以防止数据竞争。 总结起来，利用Apache Commons FileUpload进行多文件上传，需要配置相应的依赖包，处理好文件上传过程中的日志记录，同时考虑文件验证、临时文件管理和错误处理等问题。以上代码提供了一个基本的示例，实际应用中可能需要根据需求进行调整。