【SpringMVC从入门到实战教程】第四章 SpringMVC 上传与下载

喜欢ヅ旅行 2024-04-28 13:22 70阅读 0赞

## 四、SpringMVC 上传与下载 ##

文件上传：本质就是通过IO实现文件的复制，将本地文件复制到服务器端。  
  
文件下载：本质就是通过IO实现文件的复制，将服务器端文件复制到本地。  
  
Spring MVC 框架的文件上传基于 commons-fileupload 组件，并在该组件上做了进一步的封装，简化了文件上传的代码实现，取消了不同上传组件上的编程差异。

### 4.1 导入文件上传jar包 ###

**方式一：引入jar包**

![681dc36b05124301a2f1c488b02d313e.png][]

**方式二：maven依赖配置**

<dependencies>
        
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
            <version>4.3.18.RELEASE</version>
        </dependency>
        
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-beans</artifactId>
            <version>4.3.18.RELEASE</version>
        </dependency>
        
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>4.3.18.RELEASE</version>
        </dependency>
        
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-expression</artifactId>
            <version>4.3.18.RELEASE</version>
        </dependency>
        
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-aop</artifactId>
            <version>4.3.18.RELEASE</version>
        </dependency>
        
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-aspects</artifactId>
            <version>4.3.18.RELEASE</version>
        </dependency>
        
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-web</artifactId>
            <version>4.3.18.RELEASE</version>
        </dependency>
        
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>4.3.18.RELEASE</version>
        </dependency>
    
        
        
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1.0</version>
            <scope>provided</scope>
        </dependency>
        
        <dependency>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>jsp-api</artifactId>
            <version>2.1</version>
            <scope>provided</scope>
        </dependency>
        
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>jstl</artifactId>
            <version>1.2</version>
        </dependency>
    
        
        <dependency>
            <groupId>commons-fileupload</groupId>
            <artifactId>commons-fileupload</artifactId>
            <version>1.3.1</version>
        </dependency>
    </dependencies>

### 4.2 配置 ###

*  SpringMVC 为文件上传提供了直接的支持，这种支持是通过即插即用的MultipartResolver实现的。
 *  SpringMVC 用Commons FileUpload技术实现了一个实现类：CommonsMultipartResovler。
 *  SpringMVC 中默认没有装配MultipartResovler，因此默认情况下不能处理文件的上传工作，如果想使用需要配置CommonsMultipartResovler。

<?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:p="http://www.springframework.org/schema/p"
            xmlns:context="http://www.springframework.org/schema/context"
            xmlns:aop="http://www.springframework.org/schema/aop"
            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/aop
        http://www.springframework.org/schema/aop/spring-aop.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd">
    
        
        
        <context:component-scan base-package="com.newcapec.controller"/>
    
        
        <mvc:annotation-driven/>
    
        
        <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
            <property name="prefix" value="/views/"/>
            <property name="suffix" value=".jsp"/>
        </bean>
    
        
        <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
            
            
            
            <property name="maxUploadSize" value="104857600"/>
            
            <property name="defaultEncoding" value="utf-8"/>
            
            <property name="maxInMemorySize" value="10240"/>
        </bean>
    </beans>

### 4.3 单文件上传 ###

#### 4.3.1 页面 ####

**index.jsp：**

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
    <html>
    <head>
        <base href="${pageContext.request.contextPath}/">
        <title>Title</title>
    </head>
    <body>
        <div style="text-align: center;">
            <h1>首页</h1>
            <p><a href="views/upload.jsp">文件上传</a></p>
            <p><a href="views/uploads.jsp">批量上传</a></p>
            <p><a href="views/show.jsp">文件展示</a></p>
            <p><a href="views/download.jsp">文件下载</a></p>
        </div>
    </body>
    </html>

**success.jsp：**

**upload.jsp：**

*  form表单提交类型改为enctype="multipart/form-data"。
 *  提交方式为post请求，method="post"。
 *  在表单中添加type="file"的input表单元素，用来选择需要上传的文件。

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
    <html>
    <head>
        <base href="${pageContext.request.contextPath}/">
        <title>Title</title>
    </head>
    <body>
        <div style="text-align: center">
            <h1>文件上传</h1>
            
            <form action="upload.do" method="post" enctype="multipart/form-data">
                <p>请选择文件：<input type="file" name="file"></p>
                <p><button>上传</button></p>
            </form>
        </div>
    </body>
    </html>

#### 4.3.2 Controller ####

**在Controller的方法中添加MultipartFile类型的参数，用来接收上传文件。**

@Controller
    public class UploadController {
    
        /**
         * 文件上传: 将本地文件传输至服务端
         * 在springmvc中通过MultipartFile对象来接收上传的文件
         * MultipartFile对象就是通过文件上传解析器创建的
         */
        @RequestMapping("/upload.do")
        public String upload(MultipartFile file, HttpServletRequest request) throws IOException {
            /**
             * 处理上传文件：
             * 1.获取文件的基本信息
             * 2.指定文件的保存目录
             * 3.防止文件名称重复
             * 4.复制文件
             */
            //获取文件大小
            long fileSize = file.getSize();
            //获取文件名称
            String fileName = file.getOriginalFilename();
            System.out.println(fileSize);
            System.out.println(fileName);
    
            /**
             * 2.指定文件的保存目录
             * 第一种：当前项目目录下（不是工作空间中，而是项目发布后的目录）
             *      优点：属于项目内部资源，方便访问
             *      问题：文件在项目中，如果文件数据量大，不利于项目迁移
             * 第二种：服务器的文件系统中的目录
             *      优点：项目资源与上传文件分离
             *      问题：无法直接访问，需要配置虚拟目录，或搭建文件服务器
             */
            String rootPath = request.getServletContext().getRealPath("/upload");
            // String rootPath = "c:/upload";
            /**
             * 3.防止文件名称重复
             * 使用新建目录，分开存放文件
             * 使用UUID来生成新的文件名称
             */
            SimpleDateFormat sdf1 = new SimpleDateFormat("yyyy");
            SimpleDateFormat sdf2 = new SimpleDateFormat("MM");
            Date today = new Date();
            String year = sdf1.format(today);
            String month = sdf2.format(today);
    
            File dir = new File(rootPath + "/" + year + "/" + month);
            if(!dir.exists()){
                dir.mkdirs();
            }
    
            String newName = UUID.randomUUID().toString().replace("-","") +
                fileName.substring(fileName.lastIndexOf("."));
    
            //目标文件
            File resultFile = new File(dir.getAbsolutePath() + "/" + newName);
    
            //4.文件传输
            file.transferTo(resultFile);
            System.out.println("文件上传成功...");
            return "success";
        }
    }

**MultipartFile类中常用方法如下：**

<table> 
 <thead> 
  <tr> 
   <th>方法</th> 
   <th>作用</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>getOriginalFilename()</td> 
   <td>获取上传文件的原名</td> 
  </tr> 
  <tr> 
   <td>getSize()</td> 
   <td>获取文件的字节大小，单位byte</td> 
  </tr> 
  <tr> 
   <td>transferTo(File dest)</td> 
   <td>通过i/o流，将文件存放到指定位置</td> 
  </tr> 
  <tr> 
   <td>getName()</td> 
   <td>获取表单中文件组件的名字</td> 
  </tr> 
  <tr> 
   <td>getContentType()</td> 
   <td>获取文件MIME类型</td> 
  </tr> 
  <tr> 
   <td>getInputStream()</td> 
   <td>获取文件流</td> 
  </tr> 
  <tr> 
   <td>isEmpty()</td> 
   <td>是否为空</td> 
  </tr> 
 </tbody> 
</table>

**处理上传文件：**

*  文件的保存目录
    
     *  第一种：当前项目目录下（不是工作空间中，而是项目发布后的目录）。 优点：属于项目内部资源，方便访问； 问题：文件在项目中，如果文件数据量大，不利于项目迁移；
     *  第二种：服务器的文件系统中的目录。 优点：项目资源与上传文件分离； 问题：无法直接访问，需要配置虚拟目录，或搭建文件服务器；
 *  防止文件名称重复。
    
     *  使用新建目录，分开存放文件；
     *  使用UUID来生成新的文件名称；

### 4.4 批量上传 ###

**uploads.jsp：**

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
    <html>
    <head>
        <base href="${pageContext.request.contextPath}/">
        <title>Title</title>
    </head>
    <body>
        <div style="text-align: center">
            <h1>批量上传</h1>
            <form action="uploadBatch.do" method="post" enctype="multipart/form-data">
                <p>请选择文件1：<input type="file" name="file"></p>
                <p>请选择文件2：<input type="file" name="file"></p>
                <p>请选择文件3：<input type="file" name="file"></p>
                <p><button>上传</button></p>
            </form>
        </div>
    </body>
    </html>

**接收上传文件的参数为MultipartFile类型的数组即可：**

/**
      * 批量上传
      * 将MultipartFile对象定义为数组类型
      */
    @RequestMapping("/uploadBatch.do")
    public String uploadBatch(MultipartFile[] file) throws IOException {
        for (MultipartFile multipartFile : file) {
            multipartFile.transferTo(new File("c:/upload/" +  multipartFile.getOriginalFilename()));
        }
        System.out.println("批量上传成功...");
        return "success";
    }

### 4.5 下载 ###

**download.jsp：**

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
    <html>
    <head>
        <base href="${pageContext.request.contextPath}/">
        <title>Title</title>
    </head>
    <body>
        <div style="text-align: center">
            <a href="download.do?name=a.jpg">图片1</a>
            <a href="download.do?name=b.jpg">图片2</a>
            <a href="download.do?name=c.jpg">图片3</a>
            <a href="download.do?name=中文.txt">文件</a>
        </div>
    </body>
    </html>

**设置响应头即可：**

@Controller
    public class DownloadController {
    
        /**
         * 文件下载：将服务端的文件传输至客户端
         * 页面无需跳转，需要设置下载响应头
         */
        @RequestMapping("/download.do")
        public void download(String name, HttpServletResponse response) throws Exception {
            /**
             * 设置下载响应头
             * 1.content-disposition对应的值为attachment
             * 告知浏览器客户端，响应为回传文件（附件）
             * 2.设置下载时文件名称
             * "attachment;fileName="+name
             * 3.文件名称中文处理
             * 使用URLEncoder对象进行转码
             */
            // response.addHeader("content-disposition", "attachment");
            // response.addHeader("content-disposition", "attachment;fileName="+name);
            String filename = URLEncoder.encode(name,"UTF-8");
            response.addHeader("content-disposition", "attachment;fileName="+filename);
    
            //通过流进行文件传输
            FileInputStream inputStream = new FileInputStream("c:/upload/" + name);
            OutputStream outputStream = response.getOutputStream();
    
            byte[] buffer = new byte[1024];
            while(inputStream.read(buffer) != -1) {
                outputStream.write(buffer);
            }
    
            outputStream.flush();
            inputStream.close();
            outputStream.close();
        }
    }

### 4.6 加载资源 ###

**show.jsp：**

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
    <html>
    <head>
        <base href="${pageContext.request.contextPath}/">
        <title>Title</title>
    </head>
    <body>
        <div style="text-align: center;">
            <h1>图片展示</h1>
            
            <p><img src="upload/a.jpg"></p>
            <p><img src="/up/a.jpg"></p>
            <p><img src="/up/b.jpg"></p>
            <p><img src="/up/c.jpg"></p>
        </div>
    </body>
    </html>

**在页面中无法访问物理目录（硬盘中的真实目录），所以需要在服务器中配置相对应的虚拟目录：**

![6182a6100904415ea821fc8c59df34b9.png][]

#### 4.6.1 在Eclipse中配置 ####

**1、双击服务列表中的tomcat；**

![d1fe4dcdfc1b42cba8d968192eede684.png][]

**2、打开tomcat配置的Modules；**

![0c2ac9973fa2440fb30615e4e26c322f.png][]

**3、在Web Modules中配置虚拟路径；**

![3d7110e35d54450aac2a7f7f9460dccf.png][]

#### 4.6.2 在IDEA中配置 ####

**1、在菜单栏找到Run菜单，选择其中的Edit Configurations；**

![eb2c978748324955b5451da2e37fcd00.png][]

**2、选择Deployment选项卡，点击加号，选择External Source；**

![b3c4c716a0ab4d97a44c8e0a55acd097.png][]

**3、选择虚拟路径对应的物理目录；**

![4561045d8871491984cd0701487549d3.png][]

**4、在Application context中配置虚拟路径；**

![4b55f6ed98334c5ebf16ca5c4ec4a02d.png][]

#### 4.6.3 在tomcat中配置 ####

**在配置目录conf的server.xml文件中找到<Host>标签，在其中添加如下代码即可。docBase为物理目录，path为虚拟路径。**

[681dc36b05124301a2f1c488b02d313e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/28/bdcbf88ecfe847ee9469d209fdaf20f5.png
[6182a6100904415ea821fc8c59df34b9.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/28/68eebd221fa14efb81738dfd54dc02da.png
[d1fe4dcdfc1b42cba8d968192eede684.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/28/b82fdad1d52d425eb89d33b9b4f138cc.png
[0c2ac9973fa2440fb30615e4e26c322f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/28/a293494742474fedb6f85f614abeb32b.png
[3d7110e35d54450aac2a7f7f9460dccf.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/28/6fd80242c9714de99ebcbff760d2fa8c.png
[eb2c978748324955b5451da2e37fcd00.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/28/061e83b385684a6198b7aea37c29a877.png
[b3c4c716a0ab4d97a44c8e0a55acd097.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/28/bf57c500ed5b4217a8fc017fbc32ba16.png
[4561045d8871491984cd0701487549d3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/28/6be027af63824017a93cc2b7e558ba4d.png
[4b55f6ed98334c5ebf16ca5c4ec4a02d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/28/a35830c1af084626b549615947905bcf.png