配置文件服务器端 Servlet 类中的文件保存逻辑

配置文件服务器端 Servlet 类中的文件保存逻辑

package cn.foxdevelop.www;

import java.io.File;
import java.io.IOException;
import java.io.PrintWriter;
import java.util.List;

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.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;

public class UploadServlet extends HttpServlet {

    // 上传文件存储目录
    private static final String UPLOAD_DIRECTORY = "upload";

    // 上传配置
    private static final int MEMORY_THRESHOLD = 1024 * 1024 * 3;  // 3MB
    private static final int MAX_FILE_SIZE = 1024 * 1024 * 40;    // 40MB
    private static final int MAX_REQUEST_SIZE = 1024 * 1024 * 50; // 50MB

    public void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        // 检测是否为多媒体上传
        if (!ServletFileUpload.isMultipartContent(request)) {
            // 如果不是则停止
            PrintWriter writer = response.getWriter();
            writer.println("Error: 表单必须包含 enctype=multipart/form-data");
            writer.flush();
            return;
        }

        // 配置上传参数
        DiskFileItemFactory factory = new DiskFileItemFactory();
        // 设置内存临界值 - 超过后将产生临时文件并存储于临时目录中
        factory.setSizeThreshold(MEMORY_THRESHOLD);
        // 设置临时存储目录
        factory.setRepository(new File(System.getProperty("java.io.tmpdir")));

        ServletFileUpload upload = new ServletFileUpload(factory);
        // 设置最大文件上传值
        upload.setFileSizeMax(MAX_FILE_SIZE);
        // 设置最大请求值 (包含文件和表单数据)
        upload.setSizeMax(MAX_REQUEST_SIZE);
        // 中文处理
        upload.setHeaderEncoding("UTF-8");

        // 构造临时路径来存储上传的文件
        // 这个路径相对当前应用的目录
        String uploadPath = request.getServletContext().getRealPath("./")
                + File.separator + UPLOAD_DIRECTORY;

        // 如果目录不存在则创建
        File uploadDir = new File(uploadPath);
        if (!uploadDir.exists()) {
            uploadDir.mkdir();
        }

        try {
            // 解析请求的内容提取文件数据
            @SuppressWarnings("unchecked")
            List<FileItem> formItems = upload.parseRequest(request);

            if (formItems != null && formItems.size() > 0) {
                // 迭代表单数据
                for (FileItem item : formItems) {
                    // 处理不在表单中的字段
                    if (!item.isFormField()) {
                        String fileName = new File(item.getName()).getName();
                        String filePath = uploadPath + File.separator + fileName;
                        File storeFile = new File(filePath);
                        // 在控制台输出文件的上传路径
                        System.out.println(filePath);
                        // 保存文件到硬盘
                        item.write(storeFile);
                        request.setAttribute("message", "文件上传成功!");
                    }
                }
            }
        } catch (Exception ex) {
            request.setAttribute("message", "错误信息: " + ex.getMessage());
        }

        // 跳转到 message.jsp
        request.getServletContext().getRequestDispatcher("/index.jsp").forward(
                request, response);
    }
}Code language: JavaScript (javascript)

关键配置说明

执行流程

1. 通过 ServletFileUpload.isMultipartContent(request) 判断请求是否为 multipart/form-data 类型，如果不是则直接返回错误提示。
2. 配置 DiskFileItemFactory：设置内存临界值和临时文件存储目录。
3. 创建 ServletFileUpload 实例：设置文件大小限制、请求大小限制和编码格式（UTF-8）。
4. 构造上传文件存储路径：基于应用真实路径拼接 upload 目录，若目录不存在则创建。
5. 调用 upload.parseRequest(request) 解析请求，得到 List<FileItem>。
6. 遍历 FileItem 列表，通过 item.isFormField() 判断是否为普通表单字段，对非表单字段（即文件字段）执行保存操作：
   • 使用 item.getName() 获取原始文件名
   • 拼接目标文件路径
   • 调用 item.write(storeFile) 将文件写入磁盘
7. 将上传结果信息存入 request 属性，通过 forward 转发到 index.jsp 显示结果。

注意：item.getName() 在不同浏览器中可能返回完整路径或仅文件名，代码中使用 new File(item.getName()).getName() 确保只取文件名部分。