SpringMVC 通过commons-fileupload实现文件上传功能

SpringMVC 通过commons-fileupload实现文件上传功能

SpringMVC是Java Web开发中广泛使用的MVC框架，而文件上传是Web开发中频繁使用的功能之一。通过常用的文件上传组件commons-fileupload，可以方便地实现SpringMVC的文件上传功能。

添加commons-fileupload依赖

首先需要在项目的pom.xml文件中添加commons-fileupload依赖：

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

编写上传文件的HTML表单

编写上传文件的HTML表单，如下所示：

<form action="/uploadFile" method="post" enctype="multipart/form-data">
    <input type="file" name="file">
    <button type="submit">上传文件</button>
</form>

其中，enctype属性需要设置为multipart/form-data，这是因为在文件上传过程中需要传输二进制文件内容，而enctype属性可以指定表单以二进制格式提交。

编写SpringMVC Controller

编写SpringMVC的Controller，上传文件的过程在Controller中完成。下面给出一个简单的Controller代码示例。

@Controller
public class FileUploadController {

    @PostMapping("/uploadFile")
    public String uploadFile(@RequestParam("file") MultipartFile file) {
        if (file.isEmpty()) {
            // 如果文件为空，返回错误信息
            return "文件为空";
        }

        try {
            // 获取上传文件的字节流
            byte[] bytes = file.getBytes();

            // 上传文件处理逻辑，这里略去

            // 处理完毕，返回成功信息
            return "上传成功";
        } catch (IOException e) {
            // 发生异常，返回错误信息
            return "上传失败：" + e.getMessage();
        }
    }
}

以上代码中，@PostMapping注解用于指定上传文件的API路径，@RequestParam注解用于获取文件流。getBytes()方法可以获取上传文件的字节流，即文件内容。

在实际应用中，还需要对上传文件进行一些检查和处理，例如检查文件大小和类型，以及将文件保存到服务器本地。这里不加赘述，感兴趣的读者可以自行查阅文档。下面是一个完整的上传文件的Controller代码示例。

@Controller
public class FileUploadController {

    @Autowired
    private Environment env;

    @PostMapping("/uploadFile")
    public String uploadFile(@RequestParam("file") MultipartFile file) {
        if (file.isEmpty()) {
            return "文件为空";
        }

        try {
            String uploadPath = env.getProperty("upload.path");

            // 判断上传文件大小是否超过限制
            long fileSizeLimit = 1024 * 1024 * 10; // 10 MB
            if (file.getSize() > fileSizeLimit) {
                return "上传失败：文件大小超出限制";
            }

            // 判断上传文件类型是否合法
            String fileType = file.getContentType();
            List<String> allowedTypes = Arrays.asList("image/jpeg", "image/png", "image/gif");
            if (!allowedTypes.contains(fileType)) {
                return "上传失败：文件类型不合法";
            }

            // 将上传文件保存到服务器本地
            String originalFilename = file.getOriginalFilename();
            String extension = originalFilename.substring(originalFilename.lastIndexOf(".") + 1);
            String newFilename = UUID.randomUUID().toString() + "." + extension;
            Path filePath = Paths.get(uploadPath + newFilename);
            Files.write(filePath, file.getBytes());

            // 上传文件处理逻辑

            return "上传成功";
        } catch (IOException e) {
            return "上传失败：" + e.getMessage();
        }
    }
}

这里添加了文件大小和类型的检查，以及将上传文件存储到服务器本地的逻辑。

测试文件上传功能

最后在浏览器中访问上传文件的HTML表单，选择一个文件并提交，可以看到后台接收到请求并返回相应结果。上传的文件会被保存到服务器指定的路径。