前言

本文為 【SpringMVC教程】文件上傳與下載 相關(guān)知識，具體將對使用MultipartResolver處理文件上傳的步驟，兩種文件下載方式（直接向response的輸出流中寫入對應(yīng)的文件流、使用 ResponseEntity<byte[]>來向前端返回文件）等進(jìn)行詳盡介紹~

📌博主主頁：小新要變強 的主頁
👉Java全棧學(xué)習(xí)路線可參考：【Java全棧學(xué)習(xí)路線】最全的Java學(xué)習(xí)路線及知識清單，Java自學(xué)方向指引，內(nèi)含最全Java全棧學(xué)習(xí)技術(shù)清單~
👉算法刷題路線可參考：算法刷題路線總結(jié)與相關(guān)資料分享，內(nèi)含最詳盡的算法刷題路線指南及相關(guān)資料分享~
👉Java微服務(wù)開源項目可參考：企業(yè)級Java微服務(wù)開源項目（開源框架，用于學(xué)習(xí)、畢設(shè)、公司項目、私活等，減少開發(fā)工作，讓您只關(guān)注業(yè)務(wù)！）

??本文上接：最全面的SpringMVC教程（四）——Controller 與 RestFul

---

目錄

文章標(biāo)題

• 前言
• 目錄
• 一、文件上傳
• 二、文件下載
• • 1??傳統(tǒng)方式
  • 2??使用ResponseEntity方式
• 后記

文件上傳是項目開發(fā)中最常見的功能之一 ，SpringMVC 可以很好的支持文件上傳，但是SpringMVC上下文中默認(rèn)沒有裝配MultipartResolver，因此默認(rèn)情況下其不能處理文件上傳工作。如果想使用Spring的文件上傳功能，則需要在上下文中配置MultipartResolver。

前端表單要求：為了能上傳文件，必須將表單的method設(shè)置為POST，并將enctype設(shè)置為multipart/form-data。只有在這樣的情況下，瀏覽器才會把用戶選擇的文件以二進(jìn)制數(shù)據(jù)發(fā)送給服務(wù)器。

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

表單中enctype屬性的詳細(xì)說明：

• application/x-www=form-urlencoded：默認(rèn)方式，只處理表單域中的 value 屬性值，采用這種編碼方式的表單會將表單域中的值處理成 URL 編碼方式。
• multipart/form-data：這種編碼方式會以二進(jìn)制流的方式來處理表單數(shù)據(jù)，這種編碼方式會把文件域指定文件的內(nèi)容也封裝到請求參數(shù)中，不會對字符編碼。
• text/plain：除了把空格轉(zhuǎn)換為 “+” 號外，其他字符都不做編碼處理，這種方式適用直接通過表單發(fā)送郵件。

一旦設(shè)置了enctype為multipart/form-data，瀏覽器即會采用二進(jìn)制流的方式來處理表單數(shù)據(jù)，而對于文件上傳的處理則涉及在服務(wù)器端解析原始的HTTP響應(yīng)。在2003年，Apache Software Foundation發(fā)布了開源的Commons FileUpload組件，其很快成為Servlet/JSP程序員上傳文件的最佳選擇。

• Servlet3.0規(guī)范已經(jīng)提供方法來處理文件上傳，但這種上傳需要在Servlet中完成。而Spring MVC則提供了更簡單的封裝。
• Spring MVC為文件上傳提供了直接的支持，這種支持是用即插即用的MultipartResolver實現(xiàn)的。
• Spring MVC使用Apache Commons FileUpload技術(shù)實現(xiàn)了一個MultipartResolver實現(xiàn)類：CommonsMultipartResolver。因此，SpringMVC的文件上傳還需要依賴Apache Commons FileUpload的組件。

一、文件上傳

【MultipartResolver】用于處理文件上傳。當(dāng)收到請求時，DispatcherServlet 的 checkMultipart() 方法會調(diào)用 MultipartResolver 的 isMultipart() 方法判斷請求中【是否包含文件】。如果請求數(shù)據(jù)中包含文件，則調(diào)用 MultipartResolver 的 resolveMultipart() 方法對請求的數(shù)據(jù)進(jìn)行解析，然后將文件數(shù)據(jù)解析成 MultipartFile 并封裝在 MultipartHttpServletRequest (繼承了 HttpServletRequest) 對象中，最后傳遞給 Controller。

我們可以看到DispatcherServlet的核心方法中第一句就是如下的代碼：

try {processedRequest = checkMultipart(request);multipartRequestParsed = (processedRequest != request);...

注意： MultipartResolver 默認(rèn)不開啟，需要手動開啟。

文件上傳對前端表單有如下要求：為了能上傳文件，必須將表單的【method設(shè)置為POST】，并將enctype設(shè)置為【multipart/form-data】。只有在這樣的情況下，瀏覽器才會把用戶選擇的文件以二進(jìn)制數(shù)據(jù)發(fā)送給服務(wù)器。

對表單中的 enctype 屬性的詳細(xì)說明：

• application/x-www-form-urlencoded：默認(rèn)方式，只處理表單域中的 value 屬性值，采用這種編碼方式的表單會將表單域中的值處理成 URL 編碼方式。
• multipart/form-data：這種編碼方式會以二進(jìn)制流的方式來處理表單數(shù)據(jù)，這種編碼方式會把文件域指定文件的內(nèi)容也封裝到請求參數(shù)中，不會對字符編碼。

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

一旦設(shè)置了enctype為multipart/form-data，瀏覽器即會采用二進(jìn)制流的方式來處理表單數(shù)據(jù)，而對于文件上傳的處理則涉及在服務(wù)器端解析原始的HTTP響應(yīng)。

🍀（1）導(dǎo)入這個【commons-fileupload】jar包，Maven會自動幫我們導(dǎo)入它的依賴包【commons-io】

<!--文件上傳--> <dependency><groupId>commons-fileupload</groupId><artifactId>commons-fileupload</artifactId><version>1.3.3</version> </dependency>

🍀（2）配置bean：multipartResolver

注意： 這個bena的id必須為：multipartResolver ， 否則上傳文件會報400的錯誤！

<!--文件上傳配置--> <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"><!-- 請求的編碼格式，必須和jSP的pageEncoding屬性一致，以便正確讀取表單的內(nèi)容，默認(rèn)為ISO-8859-1 --><property name="defaultEncoding" value="utf-8"/><!-- 上傳文件大小上限，單位為字節(jié)（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.wang.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則為數(shù)組即可@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);//上傳路徑保存設(shè)置String path = request.getServletContext().getRealPath("/upload");//如果路徑不存在，創(chuàng)建一個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）測試上傳文件

🍀（6）采用file.Transto 來保存上傳的文件

編寫Controller類：

/** 采用file.Transto 來保存上傳的文件*/ @RequestMapping("/upload2") public String fileUpload2(@RequestParam("file") CommonsMultipartFile file, HttpServletRequest request) throws IOException {//上傳路徑保存設(shè)置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）文件的原始信息，或者叫文件的元數(shù)據(jù)是不是可以存在數(shù)據(jù)庫，具體應(yīng)該怎么做？
• （2）文件的上傳目錄能不能寫在配置文件當(dāng)中，這個應(yīng)該怎么做？
• （3）文件上傳到服務(wù)器后可不可以安裝一定的規(guī)則分目錄存儲，比如日期？
• （4）思考怎么使用阿里云的oss進(jìn)行圖片存儲？

二、文件下載

• 第一種可以直接向response的輸出流中寫入對應(yīng)的文件流
• 第二種可以使用 ResponseEntity<byte[]>來向前端返回文件

1??傳統(tǒng)方式

文件下載步驟：

• （1）設(shè)置 response 響應(yīng)頭
• （2）讀取文件 — InputStream
• （3）寫出文件 — OutputStream
• （4）執(zhí)行操作
• （5）關(guān)閉流 （先開后關(guān)）

@GetMapping("/download1") @ResponseBody public R download1(HttpServletResponse response){FileInputStream fileInputStream = null;ServletOutputStream outputStream = null;try {// 這個文件名是前端傳給你的要下載的圖片的id// 然后根據(jù)id去數(shù)據(jù)庫查詢出對應(yīng)的文件的相關(guān)信息，包括url，文件名等String fileName = "wang.jpg";//1、設(shè)置response 響應(yīng)頭，處理中文名字亂碼問題response.reset(); //設(shè)置頁面不緩存,清空bufferresponse.setCharacterEncoding("UTF-8"); //字符編碼response.setContentType("multipart/form-data"); //二進(jìn)制傳輸數(shù)據(jù)//設(shè)置響應(yīng)頭，就是當(dāng)用戶想把請求所得的內(nèi)容存為一個文件的時候提供一個默認(rèn)的文件名。//Content-Disposition屬性有兩種類型：inline 和 attachment //inline ：將文件內(nèi)容直接顯示在頁面 //attachment：彈出對話框讓用戶下載具體例子：response.setHeader("Content-Disposition","attachment;fileName="+ URLEncoder.encode(fileName, "UTF-8"));// 通過url獲取文件File file = new File("D:/upload/"+fileName);//2、 讀取文件--輸入流fileInputStream = new FileInputStream(file);//3、 寫出文件--輸出流outputStream = response.getOutputStream();byte[] buffer = new byte[1024];int len;//4、執(zhí)行寫出操作while ((len = fileInputStream.read(buffer)) != -1){outputStream.write(buffer,0,len);outputStream.flush();}return R.success();} catch (IOException e) {e.printStackTrace();return R.fail();}finally {if( fileInputStream != null ){try {// 5、關(guān)閉輸入流fileInputStream.close();} catch (IOException e) {e.printStackTrace();}}if( outputStream != null ){try {// 5、關(guān)閉輸出流outputStream.close();} catch (IOException e) {e.printStackTrace();}}} }

2??使用ResponseEntity方式

@GetMapping("/download2") public ResponseEntity<byte[]> download2(){try {String fileName = "wang.jpg";byte[] bytes = FileUtils.readFileToByteArray(new File("D:/upload/"+fileName));HttpHeaders headers=new HttpHeaders();// Content-Disposition就是當(dāng)用戶想把請求所得的內(nèi)容存為一個文件的時候提供一個默認(rèn)的文件名。headers.set("Content-Disposition","attachment;filename="+ URLEncoder.encode(fileName, "UTF-8"));headers.set("charsetEncoding","utf-8");headers.set("content-type","multipart/form-data");ResponseEntity<byte[]> entity=new ResponseEntity<>(bytes,headers, HttpStatus.OK);return entity;} catch (IOException e) {e.printStackTrace();return null;} }

---

后記

👉Java全棧學(xué)習(xí)路線可參考：【Java全棧學(xué)習(xí)路線】最全的Java學(xué)習(xí)路線及知識清單，Java自學(xué)方向指引，內(nèi)含最全Java全棧學(xué)習(xí)技術(shù)清單~
👉算法刷題路線可參考：算法刷題路線總結(jié)與相關(guān)資料分享，內(nèi)含最詳盡的算法刷題路線指南及相關(guān)資料分享~

總結(jié)

以上是生活随笔為你收集整理的最全面的SpringMVC教程（五）——文件上传与下载的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。