9、檔案上傳與下載

9.1 準備工作

檔案上傳是專案開發中最常見的功能之一 ,springMVC 可以很好的支援檔案上傳，但是SpringMVC上下文中預設沒有裝配MultipartResolver，因此預設情況下其不能處理檔案上傳工作。如果想使用Spring的檔案上傳功能，則需要在上下文中配置MultipartResolver。

前端表單要求：為了能上傳檔案，必須將表單的method設定為POST，並將enctype設定為multipart/form-data。只有在這樣的情況下，瀏覽器才會把使用者選擇的檔案以二進位制資料傳送給伺服器；

對錶單中的 enctype 屬性做個詳細的說明：

• application/x-www=form-urlencoded：預設方式，只處理表單域中的 value 屬性值，採用這種編碼方式的表單會將表單域中的值處理成 URL 編碼方式。
• multipart/form-data：這種編碼方式會以二進位制流的方式來處理表單資料，這種編碼方式會把檔案域指定檔案的內容也封裝到請求引數中，不會對字元編碼。
• text/plain：除了把空格轉換為 "+" 號外，其他字元都不做編碼處理，這種方式適用直接通過表單傳送郵件。

<form action="" enctype="multipart/form-data" method="post">
   <input type="file" name="file"/>
   <input type="submit">
</form>
 

一旦設定了enctype為multipart/form-data，瀏覽器即會採用二進位制流的方式來處理表單資料，而對於檔案上傳的處理則涉及在伺服器端解析原始的HTTP響應。在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的元件。

9.2 檔案上傳

1、匯入檔案上傳的jar包，commons-fileupload ， Maven會自動幫我們匯入他的依賴包 commons-io包；

<!--檔案上傳-->
<dependency>
   <groupId>commons-fileupload</groupId>
   <artifactId>commons-fileupload</artifactId>
   <version>1.3.3</version>
</dependency>
<!--servlet-api匯入高版本的-->
<dependency>
   <groupId>javax.servlet</groupId>
   <artifactId>javax.servlet-api</artifactId>
   <version>4.0.1</version>
</dependency>

2、配置bean：multipartResolver

【注意！！！這個bena的id必須為：multipartResolver ， 否則上傳檔案會報400的錯誤！在這裡栽過坑,教訓！】

<!--檔案上傳配置-->
<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>

CommonsMultipartFile 的 常用方法：

• String getOriginalFilename()：獲取上傳檔案的原名
• InputStream getInputStream()：獲取檔案流
• void transferTo(File dest)：將上傳檔案儲存到一個目錄檔案中

我們去實際測試一下

3、編寫前端頁面

<form action="/upload" enctype="multipart/form-data" method="post">
 <input type="file" name="file"/>
 <input type="submit" value="upload">
</form>

4、Controller

package com.yhn.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.multipart.commons.CommonsMultipartFile;

import javax.servlet.http.HttpServletRequest;
import java.io.*;

@Controller
public class FileController {
   // 檔案上傳
   //@RequestParam("file") 將name=file控制元件得到的檔案封裝成CommonsMultipartFile 物件
   //批量上傳CommonsMultipartFile則為陣列即可
   @RequestMapping("/upload")
   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";
  }
}

5、測試上傳檔案，OK！

採用file.Transto 來儲存上傳的檔案

1、編寫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";
}

2、前端表單提交地址修改

3、訪問提交測試，OK！

9.3 檔案下載

檔案下載步驟：

1、設定 response 響應頭

2、讀取檔案 -- InputStream

3、寫出檔案 -- OutputStream

4、執行操作

5、關閉流 （先開後關）

程式碼實現：

@RequestMapping(value="/download")
public String downloads(HttpServletResponse response ,HttpServletRequest request) throws Exception{
   //要下載的圖片地址
   String  path = request.getServletContext().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.flush();
  }
   out.close();
   input.close();
   return null;
}

前端

<a href="/download">點選下載</a>

測試，檔案下載OK，大家可以和我們之前學習的JavaWeb原生的方式對比一下，就可以知道這個便捷多了!

我們還有一種更暴力的方式 就是直接在a標籤的href屬性中 直接寫入檔案的路徑

<a href="/static/1.png">點選下載</a>

攔截器及檔案操作在我們開發中十分重要，一定要學會使用！