SpringMVC-09-文件上传和下载，如果想使用Sprin

来源： javaer 分享于 2025-05-17 点击 18554 次点评：264

SpringMVC-09-文件上传和下载，如果想使用Sprin

1、准备工作

Spring

文件上传是项目开发中最常见的功能之一，

Spring 可以很好的支持文件上传，但是 Spring 的默认环境中没有装配 MultipartResolver，

因此默认情况下其不能处理文件上传工作。

如果想使用 Spring 的文件上传功能，则需要在 Spring 环境中配置 MultipartResolver。

前端表单

为了能上传文件，

必须将表单的 method 属性设置为 POST，

将 enctype 属性设置为 multipart/form-data 。

只有在这样的情况下，浏览器才会把用户选择的文件以二进制流的形式发送给服务器。

这里不对 enctype 属性作过多的讲解，详细的可以去看 HTML enctype 属性这篇文章。

文件上传依赖

在2003年，Apache Software Foundation发布了开源的 Commons FileUpload 组件，

其很快成为Servlet/JSP程序员上传文件的最佳选择。

Servlet3.0规范已经提供方法来处理文件上传，但这种上传需要在Servlet中完成。
而Spring MVC则提供了更简单的封装。
Spring MVC为文件上传提供了直接的支持，这种支持是用即插即用的MultipartResolver实现的。
Spring MVC使用Apache Commons FileUpload技术实现了一个MultipartResolver实现类：CommonsMultipartResolver。

SpringMVC的文件上传还需要依赖Apache Commons FileUpload的组件。

2、文件上传

导入文件上传的jar包，commons-fileupload ， Maven会自动帮我们导入他的依赖包 commons-io包；

<!--文件上传-->
<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.3.3</version>
</dependency>

配置bean：multipartResolver

<!--文件上传配置-->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <!-- 请求的编码格式，必须和jSP的pageEncoding属性一致，以便正确读取表单的内容，默认为ISO-8859-1 -->
    <property name="defaultEncoding" value="utf-8"/>
    <!-- 上传文件大小上限，单位为字节（10485760=10M） -->
    <property name="maxUploadSize" value="10485760"/>
    <property name="maxInMemorySize" value="40960"/>
</bean>

注意！！！这个bena的id必须为：multipartResolver ，否则上传文件会报400的错误！

CommonsMultipartFile 的常用方法：

String getOriginalFilename()：获取上传文件的原名
InputStream getInputStream()：获取文件流
void transferTo(File dest)：将上传文件保存到一个目录文件中

测试

前端页面

<form action="${pageContext.request.contextPath}/upload" enctype="multipart/form-data" method="post">
    <p>
        <input type="file" name="file"/>
    </p>
    <p>
        <input type="submit" value="upload">
    </p>
</form>

Controller

@Controller
public class FileController {

    @Autowired
    ServletContext servletContext;

    //@RequestParam("file") 将name=file控件得到的文件封装成CommonsMultipartFile 对象
    //批量上传CommonsMultipartFile则为数组即可
    @RequestMapping("/upload")
    public String fileUpload(@RequestParam("file") CommonsMultipartFile file) throws IOException {
        //获取文件名
        String uploadFileName = file.getOriginalFilename();
        //如果文件名为空，直接回到首页！
        if ("".equals(uploadFileName)) {
            return "redirect:/";
        }
        System.out.println("上传文件名 : " + uploadFileName);

        //获取真实物理路径
        String path = servletContext.getRealPath("/upload");
        //如果路径不存在，创建一个
        File realPath = new File(path);
        if (!realPath.exists()) {
            realPath.mkdir();
        }
        System.out.println("上传文件保存地址：" + realPath);

        InputStream is = file.getInputStream(); //文件输入流
        OutputStream os = new FileOutputStream(new File(realPath, uploadFileName)); //文件输出流
        //读取写出
        int len = 0;
        byte[] buffer = new byte[1024];
        while ((len = is.read(buffer)) != -1) {
            os.write(buffer, 0, len);
        }
        os.close();
        is.close();

        return "redirect:/";
    }

    /**
     * 采用file.transferTo 来保存上传的文件
     */
    @RequestMapping("/upload2")
    public String fileUpload2(@RequestParam("file") CommonsMultipartFile file) throws IOException {

        //获取真实物理路径
        String path = servletContext.getRealPath("/upload");
        File realPath = new File(path);
        if (!realPath.exists()) {
            realPath.mkdir();
        }
        //上传文件地址
        System.out.println("上传文件保存地址：" + realPath);

        //通过CommonsMultipartFile的方法直接写文件（注意这个时候）
        file.transferTo(new File(realPath + "/" + file.getOriginalFilename()));
        return "redirect:/";
    }

}

注意！！！CommonsMultipartFile 为特殊参数，必须使用 @RequestParam 注解指定前端参数，否则不能进行数据绑定。

3、文件下载

文件下载步骤：

设置 response 响应头
读取文件 — InputStream
写出文件 — OutputStream
执行操作
关闭流（先开后关）

代码实现

前端页面

<p>
    <a href="${pageContext.request.contextPath}/download">点击下载</a>
</p>

Controller

@RequestMapping("/download")
public void downloads(HttpServletResponse response) throws Exception {
    //要下载的资源地址
    String path = servletContext.getRealPath("/upload");
    String fileName = "计算机结构框图.jpg";

    //1、设置response 响应头
    response.reset(); //设置页面不缓存,清空buffer
    response.setCharacterEncoding("UTF-8"); //字符编码
    response.setContentType("multipart/form-data"); //多扩展类型表单数据
    //设置响应头为 附件
    response.setHeader("Content-Disposition",
            "attachment;fileName=" + URLEncoder.encode(fileName, "UTF-8"));
    File file = new File(path, fileName);

    //2、 读取文件--输入流
    InputStream input = new FileInputStream(file);
    //3、 写出文件--输出流
    OutputStream out = response.getOutputStream();
    byte[] buff = new byte[1024];
    int index = 0;
    //4、执行 写出操作
    while ((index = input.read(buff)) != -1) {
        out.write(buff, 0, index);
    }

    out.close();
    input.close();
}

以上文件上传和下载都已完成，大家可以和JavaWeb原生的方式对比一下，就可以知道这个便捷多了!

SpringMVC-09-文件上传和下载，如果想使用Sprin