SpringMVC实现文件的上传和下载

SpringMVC文件的上传和下载

一、SpringMVC文件上传

1、什么是文件上传？

文件上传: 指的就是将用户本地计算机中文件上传到服务器上的过程称之为文件上传

2、文件上传编程步骤

1、Client选择文件（上传页面）
(1)method="post"
(2)提供文件框
(3)上传文件时enctype="multipart/form-data"
传递的数据不仅仅是value,上传的数据 以二进制形式编码

2、服务端创建文件目录存放上传文件（默认文件夹不能为空，否则idea不能加载）

3、文件上传的Controller(核心功能：复制文件)

（1）spring+spring项目整合

• spring+springmvc所需依赖

<dependencies>
    <!--junit-->
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-core</artifactId>
      <version>4.3.2.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>4.3.2.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context-support</artifactId>
      <version>4.3.2.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-jdbc</artifactId>
      <version>4.3.2.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-aop</artifactId>
      <version>4.3.2.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-beans</artifactId>
      <version>4.3.2.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-expression</artifactId>
      <version>4.3.2.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-aspects</artifactId>
      <version>4.3.2.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-tx</artifactId>
      <version>4.3.2.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-web</artifactId>
      <version>4.3.2.RELEASE</version>
    </dependency>
    <!--springmvc核心依赖-->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>4.3.2.RELEASE</version>
    </dependency>
    <!--servlet-api-->
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>servlet-api</artifactId>
      <version>2.5</version>
      <scope>provided</scope>
    </dependency>
    <!--jsp-->
    <dependency>
      <groupId>javax.servlet.jsp</groupId>
      <artifactId>jsp-api</artifactId>
      <version>2.1</version>
    </dependency>
    <!--jstl标签库-->
    <dependency>
      <groupId>jstl</groupId>
      <artifactId>jstl</artifactId>
      <version>1.2</version>
    </dependency>
    <!--文件上传-->
    <dependency>
      <groupId>commons-fileupload</groupId>
      <artifactId>commons-fileupload</artifactId>
      <version>1.3</version>
    </dependency>
  </dependencies>

• web.xml配置

<!-- 文件乱码-->
<filter>
  <filter-name>charset</filter-name>
  <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
  <init-param>
    <param-name>encoding</param-name>
    <param-value>UTF-8</param-value>
  </init-param>
</filter>
  <filter-mapping>
    <filter-name>charset</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>
  <servlet>
    <servlet-name>mvc</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!--springmvc配置文件位置-->
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:spring_mvc.xml</param-value>
    </init-param>
  </servlet>
<servlet-mapping>
  <servlet-name>mvc</servlet-name>
  <url-pattern>/</url-pattern>
</servlet-mapping>

• spring_mvc.xml文件

   <!--1、配置组件-->
    <context:component-scan base-package="com.tjcu"></context:component-scan>
    <!--2、处理器映射器和处理器适配器-->
    <mvc:annotation-driven/>
    <!--3.视图解析器-->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/"></property>
        <property name="suffix" value=".jsp"></property>
     </bean>

（2）项目中引入相关依赖

• 文件上传的核心依赖，将依赖加入pom.xml中

 <!--文件上传依赖 内部依赖有commons-io-->
    <dependency>
      <groupId>commons-fileupload</groupId>
      <artifactId>commons-fileupload</artifactId>
      <version>1.3</version>
    </dependency>

（3）开发页面

<%--Springmvc实现文件前端实现--%>
<form action="${pageContext.request.contextPath}/file/upload"
      method="post" enctype="multipart/form-data">
    logo:<input type="file" name="upload">
    <input type="submit" value="上传文件">
</form>

注意上传文件时:
1. form表单提交方式必须为post
2.form表单的enctype属性必须为multipart/form-data

（4）开发控制器

package com.tjcu;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.multipart.MultipartFile;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
/**
 * @author 王恒杰
 * @date 2021/11/21 22:18
 * @Description:
 */
@Controller
@RequestMapping("file")
public class File {


    /**
     * multipart['mʌltipɑt]：多部分
     *
     * @param request
     * @param logoUpload
     * @return
     */
    @RequestMapping("upload")
    public String upload(HttpServletRequest request, MultipartFile logoUpload) {
        //获取上传文件路径
        String realPath = request.getSession().getServletContext().getRealPath("/upload");
        System.out.println("真实路径：" + realPath);
        //    获取文件原始名称 original:[əˈrɪdʒənl] 原创的
        String originalFilename = logoUpload.getOriginalFilename();

        System.out.println("文件的原始名称：" + originalFilename);
        //    上传文件到服务器 transfer:[trænsˈfɜː] 转移
        try {
            logoUpload.transferTo(new java.io.File(realPath, originalFilename));
        } catch (IOException e) {
            e.printStackTrace();
        }
        return "index";
    }

}

（5）配置文件上传解析器

• 将文件上传解析器加入到spring_mvc.xml文件中

  <!--4.静态资源拦截器-->
    <mvc:default-servlet-handler></mvc:default-servlet-handler>
      <!--文件解析器-->
      <bean id="multipartResolver" 
       class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        <!--控制文件上传大小单位字节 默认没有大小限制 这里是2-->
        <property name="maxUploadSize" value="2097152"/>
    </bean>

注意:使用springmvc中multipartfile接收客户端上传的文件必须配置文件上传解析器且解析的id必须为multipartResolver

3、文件上传注意问题

（1）java.io.FileNotFoundException异常

关于使用Intellij Idea时系统找不到指定文件的解决方案

发现idea的target文件夹下面没有效果一直没有upload文件夹**原来**  Intellij Idea 这个智障编辑器 在用的时候 是你在这个web目录下的空文件夹他是不给你部署的，**解决** 在空文件夹下面随便放个文件夹就行了

（2）SpringMVC中封装的 MultipartFile作用

  `可以获取上传文件的文件名，文件的类型，文件的大小等`

（3）文件名一样（同名）文件覆盖问题

解决思路：使用UUID解决同名问题

/**
     * multipart['mʌltipɑt]：多部分
     *
     * @param request
     * @param logoUpload
     * @return
     */
    @RequestMapping("upload")
    public String upload(HttpServletRequest request, MultipartFile logoUpload) {
        //通过相对路径，获取上传文件路径
        String realPath = request.getSession().getServletContext().getRealPath("/upload");

        System.out.println("真实路径：" + realPath);
        //    获取文件原始名称 original:[əˈrɪdʒənl] 原创的
        String originalFilename = logoUpload.getOriginalFilename();
        //获取文件的后缀名
        String extension = FilenameUtils.getExtension(originalFilename);
        //uuid的字符串
        String uuid = UUID.randomUUID().toString();
        //拼接UUID形式的文件名
        String newFileName = uuid.replace("-","")+"."+extension;
        //    上传文件到服务器 transfer:[trænsˈfɜː] 转移
        try {
            logoUpload.transferTo(new java.io.File(realPath+"/"+ newFileName));
        } catch (IOException e) {
            e.printStackTrace();
        }
        return "index";
    }

（4）文件上传的大小限制

Struts2默认限制最大2097152 单位：字节
SpringMvc默认没有文件上传的大小限制 不好 最好限制在合理范围

springmvc文件上传的大小限制在文件上传解析器进行设置

     <!--文件解析器-->
      <bean id="multipartResolver"
         class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        <!--控制文件上传大小单位字节 默认没有大小限制 这里是2M-->
        <property name="maxUploadSize" value="2097152"/>
    </bean>

二、Springmvc文件下载

1、什么是文件下载？

文件下载:将服务器上的文件下载到当前用户访问的计算机的过程称之为文件下载

• 下载流程

1、在服务端准备可供下载的文件

2、Client中罗列服务端可供下载的文件 准备链接

3、文件下载Controller
    1、从服务器文件系统中加载指定文件 输入流

2、项目中准备下载目录并存在下载的相关文件

3、开发下载控制器

    @RequestMapping("download")
    public  String download(String fileName, HttpServletRequest request, HttpServletResponse response) throws IOException {
        //获取下载服务器上文件的绝对路径
        String realPath = request.getSession().getServletContext().getRealPath("down");
        //根据文件名获取服务上指定文件
        FileInputStream is = new FileInputStream(new java.io.File(realPath, fileName));
        //获取响应对象设置响应头信息
        response.setHeader("content-disposition","attachment;fileName="+ URLEncoder.encode(fileName,"UTF-8"));
        ServletOutputStream os = response.getOutputStream();
        IOUtils.copy(is,os);
        IOUtils.closeQuietly(is);
        IOUtils.closeQuietly(os);
        return null;
    }

注意:下载时必须设置响应的头信息,指定文件以何种方式保存,另外下载文件的控制器不能存在返回值,代表响应只用来下载文件信息、

4、开发页面

<body>
<h1>文件下载</h1>
<a href="${pageContext.request.contextPath}/file/download?fileName=1.txt"><h3>点击下载文件(1.txt)</h3></a></br>
<a href="${pageContext.request.contextPath}/file/download?fileName=2.txt"><h3>点击下载文件(2.txt)</h3></a></br>
<a href="${pageContext.request.contextPath}/file/download?fileName=3.txt"><h3>点击下载文件(3.txt)</h3></a></br>
<a href="${pageContext.request.contextPath}/file/download?fileName=4.txt"><h3>点击下载文件(4.txt)</h3></a></br>
</body>

5、文件下载相关注意

（1）下载的两种形式

inline在线尝试下载 ，attachment:附件形式下载

   response.setHeader("content-disposition","attachment;fileName="+fileName);