Spring MVC环境中文件上传功能的实现方法详解

文件上传是Web应用程序中常见的需求之一，Spring MVC提供了方便的实现方式。下面将详细讲解在Spring MVC环境下如何实现文件上传功能。

1. 前提条件

在实现文件上传功能之前，我们需要满足以下前提条件：

• Spring MVC已经正确地集成到应用程序中了。
• 应用程序中已经包含文件上传的相关依赖。

2. 配置文件上传相关的Bean

为了实现文件上传，我们需要配置一个MultipartResolver bean。MultipartResolver bean会将上传的文件解析成MultipartFile对象，从而方便处理。

在Spring配置文件中添加以下配置：

<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <property name="maxUploadSize" value="5242880"/> <!--最大上传文件大小为5MB-->
</bean>

其中maxUploadSize属性指定了上传的文件大小的最大限制，默认情况下为1MB。上述配置使用的CommonsMultipartResolver是基于Apache Commons FileUpload实现的。

3. 编写文件上传相关的Controller

在Controller中，我们需要添加一个处理文件上传请求的方法。方法参数中使用@RequestParam注解来接收上传的文件。

@Controller
public class FileUploadController {

    @RequestMapping(value = "/upload", method = RequestMethod.POST)
    public String upload(@RequestParam("file") MultipartFile file) {
        // 处理文件上传逻辑
        return "redirect:/success.html";
    }
}

上述代码中，文件上传POST请求的URL为/upload，请求方法中使用@RequestParam("file")注解来接收名字为"file"的上传文件。

4. 编写文件上传表单

在前端页面中添加文件上传表单，表单中需要指定文件上传POST请求的URL，并指定enctype="multipart/form-data"。

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

上述代码中，表单中包含一个文件上传控件和一个提交按钮，文件上传控件的name属性需要与Controller中@RequestParam注解中的参数名字相同。

5. 完整示例

下面给出一个完整的文件上传示例，实现了上传单个文件和多个文件的功能。

5.1 配置文件上传相关的Bean

<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <property name="maxUploadSize" value="5242880"/> <!--最大上传文件大小为5MB-->
</bean>

5.2 编写Controller

@Controller
public class FileUploadController {

    @RequestMapping(value = "/upload", method = RequestMethod.GET)
    public String showUploadForm() {
        return "upload";
    }

    @RequestMapping(value = "/upload", method = RequestMethod.POST)
    public String upload(@RequestParam("file") MultipartFile file, Model model) {
        String fileName = file.getOriginalFilename();
        try {
            byte[] bytes = file.getBytes();
            BufferedOutputStream stream =
                    new BufferedOutputStream(new FileOutputStream(new File(fileName)));
            stream.write(bytes);
            stream.close();
            model.addAttribute("message", "上传成功：" + fileName);
        } catch (Exception e) {
            e.printStackTrace();
            model.addAttribute("message", "上传失败：" + fileName);
        }
        return "uploadResult";
    }

    @RequestMapping(value = "/multi-upload", method = RequestMethod.GET)
    public String showMultiUploadForm() {
        return "multiUpload";
    }

    @RequestMapping(value = "/multi-upload", method = RequestMethod.POST)
    public String multiUpload(@RequestParam("files") MultipartFile[] files, Model model) {
        String message = "";
        for (MultipartFile file : files) {
            String fileName = file.getOriginalFilename();
            try {
                byte[] bytes = file.getBytes();
                BufferedOutputStream stream =
                        new BufferedOutputStream(new FileOutputStream(new File(fileName)));
                stream.write(bytes);
                stream.close();
                message += "上传成功：" + fileName + "<br>";
            } catch (Exception e) {
                e.printStackTrace();
                message += "上传失败：" + fileName + "<br>";
            }
        }
        model.addAttribute("message", message);
        return "multiUploadResult";
    }
}

上述代码中，Controller中包含两个文件上传方法upload和multiUpload，分别用于单个文件和多个文件的上传。其中多文件上传方法中使用了@RequestParam注解的数组形式来接收上传文件。

5.3 编写前端页面

/upload.jsp:

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

/multiUpload.jsp:

<form action="/multi-upload" method="post" enctype="multipart/form-data">
    <input type="file" name="files" multiple><br>
    <input type="submit" value="上传">
</form>

5.4 运行示例

输入http://localhost:8080/upload访问单文件上传页面，输入http://localhost:8080/multi-upload访问多文件上传页面。

6. 结语

本文详细讲解了Spring MVC环境中文件上传功能的实现方法。文件上传虽然不是很难，但是由于牵涉到文件系统操作，需要注意异常处理的问题。