Spring学习记录 Day6（Spring MVC拓展）

向右看齐 2021-11-10 13:22 295阅读 0赞

### 文章目录 ###

*  Day 6
 *  文件上传
 *   *  前导知识
     *  准备工作
     *  代码实现
 *  文件下载
 *   *  实现思路
     *  代码实现

# Day 6 #

2019年8月3日。  
这是我学习Spring的第六天。  
这一天，我学到了以下的知识。

# 文件上传 #

## 前导知识 ##

1.  文件上传在企业中十分常见
2.  要想通过SpringMVC支持文件上传，需要配置一些东西
3.  表单为了能上传文件，需要使用post方式提交，并且需要设置一个enctype

文件上传是项目开发中最常见的功能之一 ，springMVC 可以很好的支持文件上传，但是SpringMVC上下文中默认没有装配MultipartResolver，因此默认情况下其不能处理文件上传工作。如果想使用Spring的文件上传功能，则需要在上下文中配置MultipartResolver。

## 准备工作 ##

1.  编写前端页面，介绍如下：  
    **前端表单要求**：为了能上传文件，必须将表单的method设置为POST，并将enctype设置为multipart/form-data。只有在这样的情况下，浏览器才会把用户选择的文件以二进制数据发送给服务器；
    
        <form action="" method="post" enctype="multipart/form-data">
        <%--name服务器可以取这个文件的值--%>
        <input type="file" name="file">
        <input type="submit" value="upload">
        </form>
    
    对表单中的 enctype 属性做个详细的说明：
    
     *  application/x-www=form-urlencoded：默认方式，只处理表单域中的 value 属性值，采用这种编码方式的表单会将表单域中的值处理成 URL 编码方式。
     *  multipart/form-data：这种编码方式会以二进制流的方式来处理表单数据，这种编码方式会把文件域指定文件的内容也封装到请求参数中，不会对字符编码。
     *  text/plain：除了把空格转换为 “+” 号外，其他字符都不做编码处理，这种方式适用直接通过表单发送邮件。
2.  编写SpringMVC配置文件spring-mvc.servlet.xml，介绍如下：
    
    1.  一旦设置了enctype为multipart/form-data，浏览器即会采用二进制流的方式来处理表单数据，而对于文件上传的处理则涉及在服务器端解析原始的HTTP响应。在2003年，Apache Software Foundation发布了开源的Commons FileUpload组件，其很快成为Servlet/JSP程序员上传文件的最佳选择。
    2.  Servlet3.0规范已经提供方法来处理文件上传，但这种上传需要在Servlet中完成。而Spring MVC则提供了更简单的封装。
    3.  Spring MVC为文件上传提供了直接的支持，这种支持是用即插即用的MultipartResolver实现的。Spring MVC使用Apache Commons FileUpload技术实现了一个MultipartResolver实现类：CommonsMultipartResolver。因此，SpringMVC的文件上传还需要依赖Apache Commons FileUpload的组件。
    
        <?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:mvc="http://www.springframework.org/schema/mvc" xmlns:context="http://www.springframework.org/schema/context" xsi:schemaLocation=" http://www.springframework.org/schema/beans https://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context https://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc https://www.springframework.org/schema/mvc/spring-mvc.xsd">
        
        <context:component-scan base-package="controller"/>
        <mvc:default-servlet-handler/>
        <mvc:annotation-driven/>
        
        
         <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" id="InternalResourceViewResolver">
            <property name="prefix" value="/WEB-INF/jsp/"/>
            <property name="suffix" value=".jsp"/>
        </bean>
        
        
        <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        
        <property name="defaultEncoding" value="utf-8"/>
        
        <property name="maxUploadSize" value="10485760"/>
        <property name="maxInMemorySize" value="40960"/>
        </bean>
        
        </beans>
    
    **注意！！！这个bena的id必须为：multipartResolver ， 否则上传文件会报400的错误！在这里踩过坑，教训！**
3.  导入文件上传和下载的包commons-fileupload，Maven会自动帮我们导入它的依赖包 commons-io包，再导入其他相关的包，代码如下：

<dependency>
          <groupId>junit</groupId>
          <artifactId>junit</artifactId>
          <version>4.11</version>
          <scope>test</scope>
        </dependency>
          
          <dependency>
              <groupId>commons-fileupload</groupId>
              <artifactId>commons-fileupload</artifactId>
              <version>1.3.3</version>
          </dependency>
        
        <dependency>
          <groupId>org.springframework</groupId>
          <artifactId>spring-webmvc</artifactId>
          <version>4.3.24.RELEASE</version>
        </dependency>
        
        <dependency>
          <groupId>javax.servlet</groupId>
          <artifactId>javax.servlet-api</artifactId>
          <version>4.0.1</version>
        </dependency>
        
        <dependency>
          <groupId>javax.servlet.jsp</groupId>
          <artifactId>jsp-api</artifactId>
          <version>2.2</version>
          <scope>provided</scope>
        </dependency>

接下来，将会使用到它的实现类 CommonsMultipartFile ， 常用方法如下：

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

1.  在web.xml中绑定配置文件，代码如下：

<?xml version="1.0" encoding="UTF-8"?>
    <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0">
    
      <servlet>
        <servlet-name>springmvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
          <param-name>contextConfigLocation</param-name>
          <param-value>classpath:spring-mvc.servlet.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
      </servlet>
    
      <servlet-mapping>
        <servlet-name>springmvc</servlet-name>
        <url-pattern>/</url-pattern>
      </servlet-mapping>
    
    
      
      <filter>
        <filter-name>myFilter</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>myFilter</filter-name>
        <url-pattern>/*</url-pattern>
      </filter-mapping>
    
    
    </web-app>

## 代码实现 ##

1.  **采用流的方式上传文件**
    
    1.  完善前端页面，代码如下：
    
        <%@page contentType="text/html;charset=UTF-8" language="java" %>
        <html>
        
        <body>
        <h2>Hello World!</h2>
        
        <form action="${pageContext.request.contextPath}/upload" enctype="multipart/form-data" method="post">
        <input type="file" name="file"/>
        <input type="submit">
        </form>
        </body>
        </html>
    
    1.  编写Controller，**必须加上 @RequestParam ， 否则也会报错！作用是用来实现封装！**，代码如下：
    
        @Controller
        public class Filecontroller { 
        //@RequestParam("file") 将name=file控件得到的文件封装成CommonsMultipartFile 对象
        //批量上传CommonsMultipartFile则为数组即可
        @RequestMapping("/upload")
        // @ResponBody 不走Spring MVC中的视图解析器
        public String fileUpload(@RequestParam("file") CommonsMultipartFile file , HttpServletRequest request) throws IOException { 
            //获取文件名 : file.getOriginalFilename();
            String uploadFileName = file.getOriginalFilename();
            //如果文件名为空，直接回到首页！
            if ("".equals(uploadFileName)){ 
                return "redirect:/index.jsp";
            }
            System.out.println("上传文件名 : "+uploadFileName);
            //上传路径保存设置
            String path = request.getServletContext().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.flush();
            }
            os.close();
            is.close();
            return "redirect:/index.jsp";
        }
        }
    
    1.  测试运行  
        ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMTUxNjU5_size_16_color_FFFFFF_t_70]
2.  **采用file.Transto 来上传**
    
    1.  前端页面跟上一种方式相同
    2.  编写Controller，代码如下：
    
        /* * 采用file.Transto 来保存上传的文件 */
        @RequestMapping("/upload2")
        public String  fileUpload2(@RequestParam("file") CommonsMultipartFile file, HttpServletRequest request) throws IOException { 
        
            //上传路径保存设置
            String path = request.getServletContext().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:/index.jsp";
        }
    
    1.  测试运行  
        ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMTUxNjU5_size_16_color_FFFFFF_t_70 1]

# 文件下载 #

## 实现思路 ##

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

## 代码实现 ##

1.  编写前端页面，代码如下：

1.  编写Controller，代码如下：

@RequestMapping(value="/download")
        public String downloads(HttpServletResponse response) throws Exception{ 
            //要下载的图片地址
            String    path = "C:/Users/Administrator/Desktop/";
            String  fileName = "1.png";
    
            //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.flush();
            }
            out.close();
            input.close();
            return null;
        }

1.  测试运行

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMTUxNjU5_size_16_color_FFFFFF_t_70]: /images/20211109/83ac7c6f75a34da4b139c0a66c9aa556.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMTUxNjU5_size_16_color_FFFFFF_t_70 1]: /images/20211109/c1984d91c1fb4b6380204fd901a68858.png