Spring MVC 实现文件的上传和下载

springmvc 中，文件的上传，是通过 multipartresolver 实现的。 所以，如果要实现文件的上传，只要在 spring-mvc.xml 中注册相应的 multipartresolver 即可。

multipartresolver 的实现类有两个：

1. commonsmultipartresolver
2. standardservletmultipartresolver

两个的区别：

1. 第一个需要使用 apache 的 commons-fileupload 等 jar 包支持，但它能在比较旧的 servlet 版本中使用。
2. 第二个不需要第三方 jar 包支持，它使用 servlet 内置的上传功能，但是只能在 servlet 3 以上的版本使用。

第一个使用步骤：

/*commonsmultipartresolver  上传用到的两个包*/

"commons-fileupload:commons-fileupload:1.3.1",

"commons-io:commons-io:2.4"

如果是maven项目的话直接导入:

<dependency>
    <groupid>commons-fileupload</groupid>
    <artifactid>commons-fileupload</artifactid>
    <version>1.3.1</version>
</dependency>

dispatcher-servlet.xml配置：

<?xml version="1.0" encoding="utf-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemalocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd">

    <context:component-scan base-package="edu.nf.ch08.controller"/>

    <mvc:annotation-driven/>

    <mvc:default-servlet-handler/>
    <!-- 文件上传有两种方式，一种基于servlet3.0的上传，一种基于
     commons-upload上传，如果使用servlet3.0的上传方式，可以
     不需要配置multipartresolver，spring默认会注册一个
     standardservletmultipartresolver。只需要在web.xml中
     启用<multipart-config>。
     如果想使用commons-upload，那么需要配置一个commonsmultipartresolver,
     且指定bean的id为multipartresolver-->
    <!-- 这里使用commons-upload-->
    <bean id="multipartresolver" class="org.springframework.web.multipart.commons.commonsmultipartresolver">
        <!-- 限制文件上传的总大小（单位：字节）,不配置此属性默认不限制 -->
        <property name="maxuploadsize" value="104857600"/>
        <!-- 设置文件上传的默认编码-->
        <property name="defaultencoding" value="utf-8"/>
    </bean>

    <bean class="org.springframework.web.servlet.view.internalresourceviewresolver">
        <property name="prefix" value="/web-inf/jsp/"/>
        <property name="suffix" value=".jsp"/>
    </bean>
</beans>

 web.xml：

<?xml version="1.0" encoding="utf-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"
         xsi:schemalocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">

    <!-- 请求总控器 -->
    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.dispatcherservlet</servlet-class>
        <init-param>
            <param-name>contextconfiglocation</param-name>
            <param-value>classpath:dispatcher-servlet.xml</param-value>
        </init-param>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

</web-app>

后台java（上传、下载）处理代码：

package edu.nf.ch08.controller;

import org.apache.commons.io.fileutils;
import org.springframework.http.httpheaders;
import org.springframework.http.httpstatus;
import org.springframework.http.mediatype;
import org.springframework.http.responseentity;
import org.springframework.stereotype.controller;
import org.springframework.web.bind.annotation.getmapping;
import org.springframework.web.bind.annotation.postmapping;
import org.springframework.web.multipart.multipartfile;
import org.springframework.web.servlet.modelandview;

import java.io.file;
import java.io.ioexception;

/**
 * @author wangl
 * @date 2018/11/2
 */
@controller
public class uploadcontroller {

    /**
     * 文件上传只需要spring传入一个multipartfile对象即可，
     * 这个对象可以获取文件相关上传的信息。
     * 一个multipartfile表示单个文件上传，当需要上传多个文件时
     * 只需要声明为multipartfile[]数组即可。
     * @return
     */
    @postmapping("/upload")
    public modelandview upload(multipartfile file){
        //获取当前系统用户目录
        string home = system.getproperty("user.home");
        //指定上传的文件夹目录
        file uploaddir = new file(home + "/files");
        //如果目录不存在，则创建
        if(!uploaddir.exists()){
            uploaddir.mkdir();
        }
        //获取上传的文件名
        string filename = file.getoriginalfilename();
        //构建一个完整的文件上传对象
        file uploadfile = new file(uploaddir.getabsolutepath() + "/" + filename);
        try {
            //通过transferto方法进行上传
            file.transferto(uploadfile);
        } catch (ioexception e) {
            e.printstacktrace();
            throw new runtimeexception(e.getmessage());
        }
        //将文件名存入model，转发到index页面
        modelandview mv = new modelandview("index");
        mv.addobject("filename", filename);
        return mv;
    }

    /**
     * 文件下载
     * 读取服务器本地文件并封装为responseentity对象
     * 响应客户端,写回的是一个字节数组
     * @param filename 文件名
     * @return
     */
    @getmapping("/download")
    public responseentity<byte[]> download(string filename){
        //依据文件名构建本地文件路径
        string filepath = system.getproperty("user.home") + "/files/" + filename;
        //依据文件路径构建file对象
        file file = new file(filepath);
        //创建响应头对象，设置响应信息
        httpheaders headers = new httpheaders();
        try {
            //对文件名进行重新编码，防止在响应头中出现中文乱码
            string headerfilename = new string(filename.getbytes("utf-8"), "iso-8859-1");
            //设置响应内容处理方式为附件,并指定文件名
            headers.setcontentdispositionformdata("attachment", headerfilename);
            //设置响应头类型为application/octet-stream,表示是一个流类型
            headers.setcontenttype(mediatype.application_octet_stream);
            //将文件转换成字节数组
            byte[] bytes = fileutils.readfiletobytearray(file);
            //创建responseentity对象（封装文件字节数组、响应头、响应状态码）
            responseentity<byte[]> entity = new responseentity<>(bytes, headers, httpstatus.created);
            //最后将整个responseentity对象返回给dispatcherservlet
            return entity;
        } catch (exception e) {
            e.printstacktrace();
            throw new runtimeexception("文件下载失败");
        }
    }
}

上传文件的网页html：

<!doctype html>
<html lang="en">
<head>
    <meta charset="utf-8">
    <title>title</title>
</head>
<body>
<h1>文件上传</h1>
<!-- 当有文件上传时，表单的enctype必须设置为multipart/form-data -->
<form method="post" action="upload" enctype="multipart/form-data">
    file:<input type="file" name="file"/><br/>
    <input type="submit" value="submit"/>
</form>
</body>
</html>

 

上传成功后转发的jsp（下载文件）页面：

<%--
  created by intellij idea.
  user: wangl
  date: 2018/11/2
  time: 09:56
  to change this template use file | settings | file templates.
--%>
<%@ page contenttype="text/html;charset=utf-8" language="java" %>
<html>
<head>
    <title>title</title>
</head>
<body>
<a href="download?filename=${filename}">${filename}</a>
</body>
</html>

 

项目结构：