Java中使用fileupload组件实现文件上传功能的实例代码

介绍

在Java Web开发中，文件上传功能是一个非常常见和基础的功能。而使用fileupload组件实现文件上传，不仅方便易用，而且功能强大，能够满足大多数文件上传需求。

本文将介绍如何使用fileupload组件实现文件上传功能的实例代码并附有完整代码和两个示例供您参考。在实现文件上传的过程中，我们需要引入Apache Commons FileUpload组件和Apache Commons IO组件。下面我们将详细讲解这个过程。

步骤

1. 下载和引入Apache Commons FileUpload组件和Apache Commons IO组件到项目中。可以在 Maven 中直接使用以下代码：

    <dependency>
        <groupId>commons-fileupload</groupId>
        <artifactId>commons-fileupload</artifactId>
        <version>1.4</version>
    </dependency>
    <dependency>
        <groupId>commons-io</groupId>
        <artifactId>commons-io</artifactId>
        <version>2.8.0</version>
    </dependency>

1. 在HTML表单中添加上传文件的输入框：

    <form action="upload" method="post" enctype="multipart/form-data">
        <input type="file" name="file">
        <input type="submit" value="Upload">
    </form>

其中，form的action属性设为上传文件处理的Handler，这里设为"upload"。input元素的name属性为"file"，后面在Java代码中需要通过这个名字来获取上传的文件数据。

1. 在Java代码中，接收表单提交的数据，并处理上传文件的操作。

代码示例1：上传文件并保存到指定目录

    @PostMapping("upload")
    public String upload(HttpServletRequest request) throws IOException, ServletException {
        // 使用DiskFileItemFactory创建FileItem对象
        DiskFileItemFactory factory = new DiskFileItemFactory();
        // 定义文件缓存路径和缓存大小限制
        factory.setRepository(new File("C:/temp"));
        factory.setSizeThreshold(1024 * 1024 * 10);
        // 使用ServletFileUpload解析表单数据
        ServletFileUpload upload = new ServletFileUpload(factory);
        // 设置单个文件的大小限制，这里限制为10MB
        upload.setFileSizeMax(1024 * 1024 * 10);

        List<FileItem> formItems = upload.parseRequest(request);
        if (formItems != null && formItems.size() > 0) {
            // 迭代表单数据
            for (FileItem item : formItems) {
                // 处理普通表单字段
                if (item.isFormField()) {
                    String fieldName = item.getFieldName();
                    String fieldValue = item.getString();
                    // handle form field ...
                }
                // 处理上传的文件
                else {
                    String fileName = item.getName();
                    String filePath = "C:/upload/" + fileName;
                    File storeFile = new File(filePath);
                    // 在控制台输出文件的上传路径
                    System.out.println(storeFile.getAbsolutePath());
                    // 保存文件到磁盘
                    item.write(storeFile);
                }
            }
        }
        return "upload_success";
    }

代码解释：

该代码使用了DiskFileItemFactory和ServletFileUpload类完成文件上传的操作。

• DiskFileItemFactory。创建FileItem对象，并来设置缓存区及其大小等
• ServletFileUpload。解析上传的文件，包括获取多个上传的文件及其名字等信息。

在代码中，我们首先通过DiskFileItemFactory设置了缓存路径为"C:/temp"，缓存大小为10 MB。创建了ServletFileUpload类对象后，我们也设置了最大上传文件大小为10MB。

接着，我们调用upload.parseRequest(request)方法获取表单数据。然后，我们遍历FileItem集合，并使用isFormField方法判断如果这个FileItem对象表示一个上传的文件，则把文件保存到指定目录中。

代码示例2：上传文件并读取文件内容

在这个示例中，我们通过上传文件并读取文件内容的方式获取上传文件的内容。

    @PostMapping("upload")
    public String upload(HttpServletRequest request) throws IOException, ServletException {
        String fileName = null;
        InputStream fileContent = null;
        try {
            Part filePart = request.getPart("file"); // 获取上传文件的Part
            fileName = Paths.get(filePart.getSubmittedFileName()).getFileName().toString();
            fileContent = filePart.getInputStream(); // 获取上传文件的输入流
            // 处理上传文件的内容
            String fileContentStr = new String(fileContent.readAllBytes(), "UTF-8");
            System.out.println("上传的文件内容：" + fileContentStr);
        } catch (IOException | ServletException e) {
            e.printStackTrace();
        } finally {
            if (fileContent != null) {
                fileContent.close();
            }
        }
        return "upload_success";
    }

代码解释：

我们使用Java Servlet 3 API的Part类来访问上传文件的内容。在代码中，我们通过文件名获取了上传文件的输入流，从而获取了文件内容。注意，这里我们使用了readAllBytes方法读取文件内容并且指定了编码格式为UTF-8。

结束语

这样，我们就完成了Java中使用fileupload组件实现文件上传功能的实例代码。在实际应用中，我们可以根据实际需要，对代码进行适当修改，以满足不同的上传需求。