Apache Commons FileUpload 是一个 Java 库，用于处理 HTTP 请求中的多部分数据，即通常在文件上传场景中出现的数据格式。这个库使得开发者能够轻松地在服务器端接收并处理上传的文件。在本案例中，我们将探讨如何使用 Apache Commons FileUpload 实现文件上传功能。
我们需要在项目中包含两个关键的 JAR 包：`commons-fileupload.jar` 和 `commons-io.jar`。`commons-fileupload.jar` 提供了文件上传的核心功能，而 `commons-io.jar` 则提供了与文件操作相关的辅助类。
在实现文件上传功能时，我们创建一个继承自 `HttpServlet` 的 `UploadServlet` 类。在这个类中，定义了两个静态变量：`uploadPath` 用于指定文件保存的最终路径，`tempPath` 用于存放临时文件的目录。`init()` 方法中初始化 `tempPathFile` 对象，确保临时文件目录存在。
在 `doPost()` 方法中，我们执行实际的文件上传逻辑：
1. 创建 `DiskFileItemFactory` 对象，用于配置文件上传时的内存和磁盘策略。`setSizeThreshold()` 设置了内存缓冲区的大小，当上传的数据超过这个阈值时，文件将被写入到临时目录。`setRepository()` 指定了临时文件存储的位置。
2. 使用 `ServletFileUpload` 对象处理多部分请求。`setSizeMax()` 设置了允许的最大文件大小，防止大文件导致服务器溢出。
3. `parseRequest(request)` 方法解析 HTTP 请求，返回一个 `List<FileItem>`，其中包含了所有上传的文件项。
4. 遍历 `FileItem` 列表，对于每个文件项，检查其名称 `fileName` 是否非空。如果非空，表示这是一个文件项，而非表单字段。创建一个 `File` 对象表示完整的文件路径，然后使用 `fi.write(savedFile)` 将文件内容写入到目标位置。
5. 如果没有异常发生，控制台会打印 "upload succeed"，表明文件上传成功。如果有异常，可以捕获并处理，例如跳转到错误页面。
需要注意的是，此示例仅适用于单个文件上传。对于多文件上传，`parseRequest()` 返回的 `List<FileItem>` 将包含多个文件项，需要在循环中处理每个文件。此外，为了提高安全性，应该对上传的文件名进行验证和重命名，以防止恶意文件覆盖服务器上的重要文件或利用路径遍历漏洞。
总结起来，Apache Commons FileUpload 提供了一个方便的 API 来处理文件上传，通过配置内存和磁盘策略，可以有效地管理上传过程。在实际应用中，还需要考虑其他因素，如文件类型的检查、上传进度的显示、错误处理等，以提供更完善的文件上传功能。
