引言：

• 文件的上傳和下載在web應(yīng)用中是非常常用，也是非常有用的功能。

  • 例如：發(fā)送電子郵件時(shí)可以同過(guò)上傳附件發(fā)送文件，OA系統(tǒng)中可以通過(guò)上傳文件來(lái)提交公文，社交網(wǎng)站通過(guò)上傳圖片來(lái)自定義頭像等等。
  • 例如：下載實(shí)際上只要資源放在用戶可訪問(wèn)的目錄中用戶就可以直接通過(guò)地址下載，但是一些資源是存放到數(shù)據(jù)庫(kù)中的，還有一些資源需要一定權(quán)限才能下載，這里就需要我們通過(guò)Servlet來(lái)完成下載的功能。

• 可以說(shuō)上傳和下載是每一個(gè)web應(yīng)用都需要具有的一個(gè)功能，所以需要我們掌握。

• 第1章 文件的上傳

1.1 文件上傳的步驟

文件的上傳主要分成兩個(gè)步驟：

1. 用戶在頁(yè)面中選擇要上傳的文件，然后將請(qǐng)求提交到Servlet

2. Servlet收到請(qǐng)求，解析用戶上傳的文件，然后將文件存儲(chǔ)到服務(wù)器

1.2 創(chuàng)建上傳文件的表單

1. 創(chuàng)建一個(gè)form表單

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

• 文件上傳的表單和之前的表單類似，但有以下內(nèi)容需要注意：

  • 表單的method屬性必須為post
  • 表單的enctype屬性必須為multipart/form-data
  • 上傳文件的控件是input，type屬性為file

• 該表單打開(kāi)后是如下效果：

  • IE

    [外鏈圖片轉(zhuǎn)存失敗,源站可能有防盜鏈機(jī)制,建議將圖片保存下來(lái)直接上傳(img-0ohOyE7Q-1597829644379)(尚硅谷_張春勝_文件的上傳和下載.assets/1558975331009.png)]

  • Chrome

    [外鏈圖片轉(zhuǎn)存失敗,源站可能有防盜鏈機(jī)制,建議將圖片保存下來(lái)直接上傳(img-bQ5iOiZO-1597829644383)(尚硅谷_張春勝_文件的上傳和下載.assets/1558975309963.png)]

  • 火狐

    [外鏈圖片轉(zhuǎn)存失敗,源站可能有防盜鏈機(jī)制,建議將圖片保存下來(lái)直接上傳(img-VYT1AJDN-1597829644385)(尚硅谷_張春勝_文件的上傳和下載.assets/1558975370024.png)]

2. 編寫Servelet

   • 頁(yè)面的表單控件創(chuàng)建好以后，選中文件點(diǎn)擊上傳按鈕請(qǐng)求將會(huì)提交到指定的Servlet來(lái)處理。

   • 注意：這里不能再像以前的Servlet中那樣，通過(guò)request.getParamter()來(lái)獲取請(qǐng)求參數(shù)了，當(dāng)enctype=“multipart/form-data” 時(shí)，再使用getParamter()獲取到內(nèi)容永遠(yuǎn)為空。因?yàn)闉g覽器發(fā)送請(qǐng)求的方式已經(jīng)改變。

   • 既然以前的方法不能使用了，這里我們必須要引入一個(gè)新的工具來(lái)解析請(qǐng)求中的參數(shù)和文件，這個(gè)工具就是commons-fileupload。

1.3 commons-fileupload

• commons-fileupload是Apache開(kāi)發(fā)的一款專門用來(lái)處理上傳的工具，它的作用就是可以從request對(duì)象中解析出，用戶發(fā)送的請(qǐng)求參數(shù)和上傳文件的流。

• commons-fileupload包依賴commons-io，兩個(gè)包需要同時(shí)導(dǎo)入。

• 核心類：

  1. DiskFileItemFactory

     1. 工廠類，用于創(chuàng)建ServletFileUpload，設(shè)置緩存等

     2. 該類一般直接使用構(gòu)造器直接創(chuàng)建實(shí)例

     3. 方法：

        • public void setSizeThreshold(int sizeThreshold)：用于設(shè)置緩存文件的大小（默認(rèn)值10kb）

        • public void setRepository(File repository)：用于設(shè)置緩存文件位置（默認(rèn)系統(tǒng)緩存目錄）

  2. ServletFileUpload

     1. 該類用于解析request對(duì)象從而獲取用戶發(fā)送的請(qǐng)求參數(shù)（包括普通參數(shù)和文件參數(shù)）

     2. 該類需要調(diào)用有參構(gòu)造器創(chuàng)建實(shí)例，構(gòu)造器中需要一個(gè)DiskFileItemFactory作為參數(shù)

     3. 方法：

        • public List parseRequest(HttpServletRequest request)：解析request對(duì)象，獲取請(qǐng)求參數(shù)，返回的是一個(gè)List，List中保存的是一個(gè)FileItem對(duì)象，一個(gè)對(duì)象代表一個(gè)請(qǐng)求參數(shù)。

        • public void setFileSizeMax(long fileSizeMax)：設(shè)置單個(gè)文件的大小限制，單位為B。如果上傳文件超出限制，會(huì)在parseRequest()拋出異常FileSizeLimitExceededException。

        • public void setSizeMax(long sizeMax)：限制請(qǐng)求內(nèi)容的總大小，單位為B。如果上傳文件超出限制，會(huì)在parseRequest()拋出異常SizeLimitExceededException。

  3. FileItem

     1. 該類用于封裝用戶發(fā)送的參數(shù)和文件，也就是用戶發(fā)送來(lái)的信息將會(huì)被封裝成一個(gè)FileItem對(duì)象，我們通過(guò)該對(duì)象獲取請(qǐng)求參數(shù)或上傳文件的信息。

     2. 該類不用我們手動(dòng)創(chuàng)建，由ServletFileItem解析request后返回。

     3. 方法：

        • String getFieldName()：獲取表單項(xiàng)的名字，也就是input當(dāng)中的name屬性的值。

        • String getName()：獲取上傳的文件名，普通的請(qǐng)求參數(shù)為null。

        • String getString(String encoding)：獲取內(nèi)容，encoding參數(shù)需要指定一個(gè)字符集。

          ? ① 若為文件，將文件的流轉(zhuǎn)換為字符串。

          ? ② 若為請(qǐng)求參數(shù)，則獲取請(qǐng)求參數(shù)的value。

        • boolean isFormField()：判斷當(dāng)前的FileItem封裝的是普通請(qǐng)求參數(shù)，還是一個(gè)文件。

          ? ① 如果為普通參數(shù)返回：true

          ? ② 如果為文件參數(shù)返回：false

        • String getContentType()：獲取上傳文件的MIME類型

        • long getSize()：獲取內(nèi)容的大小

        • write():將文件上傳到服務(wù)器

• 示例代碼：創(chuàng)建一個(gè)Servlet并在doPost()方法中編寫如下代碼

  //創(chuàng)建工廠類
  DiskFileItemFactory factory = new DiskFileItemFactory();
  //創(chuàng)建請(qǐng)求解析器
  ServletFileUpload fileUpload = new ServletFileUpload(factory);
  //設(shè)置上傳單個(gè)文件的的大小
  fileUpload.setFileSizeMax(1024*1024*3);
  //設(shè)置上傳總文件的大小
  fileUpload.setSizeMax(1024*1024*3*10);
  //設(shè)置響應(yīng)內(nèi)容的編碼
  response.setContentType("text/html;charset=utf-8");
  try {
  	//解析請(qǐng)求信息，獲取FileItem的集合
  	List<FileItem> items = fileUpload.parseRequest(request);
  	//遍歷集合
  	for (FileItem fileItem : items) {
  		//如果是普通的表單項(xiàng)
  		if(fileItem.isFormField()){
  		    //獲取參數(shù)名
  		    String fieldName = fileItem.getFieldName();
  		    //獲取參數(shù)值
  		    String value = fileItem.getString("utf-8");
  		    System.out.println(fieldName+" = "+value);
  	        //如果是文件表單項(xiàng)
  	    }else{
  		    //獲取文件名
  		    String fileName = fileItem.getName();
  		    //獲取上傳路徑
  		    String realPath = getServletContext().getRealPath("/WEB-INF/upload");
  		    //檢查upload文件夾是否存在，如果不存在則創(chuàng)建
  		    File f = new File(realPath);
  		    if(!f.exists()){
  			    f.mkdir();
  		    };
  		    //為避免重名生成一個(gè)uuid作為文件名的前綴
  		    String prefix = UUID.randomUUID().toString().replace("-", "");
  		    //將文件寫入到服務(wù)器中
  		    fileItem.write(new File(realPath+"/"+prefix+"_"+fileName));
  		    //清楚文件緩存
  		    fileItem.delete();
  	    }
  }
  } catch (Exception e) {
  	if(e instanceof SizeLimitExceededException){
  		//文件總大小超出限制
  		response.getWriter().print("上傳文件的總大小不能超過(guò)30M");
  	}else if(e instanceof FileSizeLimitExceededException){
  		//單個(gè)文件大小超出限制
  		response.getWriter().print("上傳單個(gè)文件的大小不能超過(guò)3M");
  	}
  } 
  response.getWriter().print("上傳成功");
  
  

第2章 文件的下載

2.1 使用說(shuō)明

• 文件下載最直接的方法就是把文件直接放到服務(wù)器的目錄中，用戶直接訪問(wèn)該文件就可以直接下載。

• 但是實(shí)際上這種方式并不一定好用，比如我們?cè)诜?wù)器上直接放置一個(gè)MP3文件，然后通過(guò)瀏覽器訪問(wèn)該文件的地址，如果是IE瀏覽器可能就會(huì)彈出下載窗口，而如果是FireFox和Chrome則有可能直接播放。再有就是有一些文件我們是不希望用戶可以直接訪問(wèn)到的，這是我們就要通過(guò)Servlet來(lái)完成下載功能。

• 下載文件的關(guān)鍵是幾點(diǎn)：

  1. 服務(wù)器以一個(gè)流的形式將文件發(fā)送給瀏覽器。

  2. 發(fā)送流的同時(shí)還需要設(shè)置幾個(gè)響應(yīng)頭，來(lái)告訴瀏覽器下載的信息。

     • 具體響應(yīng)頭如下：
       • Content-Type
         • 下載文件的MIME類型
         • 可以通過(guò)servletContext. getMimeType(String file)獲取
         • 也可以直接手動(dòng)指定
         • 使用response.setContentType(String type);
         • 響應(yīng)頭樣式：Content-Type: audio/mpeg
       • Content-Disposition
         • 下載文件的名字，主要作用是提供一個(gè)默認(rèn)的用戶名
         • 通過(guò)response.setHeader(“Content-Disposition”, disposition)設(shè)置
         • 響應(yīng)頭樣式：Content-Disposition: attachment; filename=xxx.mp3
       • Content-Length
         • 下載文件的長(zhǎng)度，用于設(shè)置文件的長(zhǎng)處（不必須）
         • 通過(guò)response. setContentLength(int len)設(shè)置。
         • 設(shè)置后樣式：Content-Length: 3140995

  3. 接下來(lái)需要以輸入流的形式讀入硬盤上的文件

     • FileInputStream is = new FileInputStream(file);
     • 這個(gè)流就是我們一會(huì)要發(fā)送給瀏覽器的內(nèi)容

  4. 通過(guò)response獲取一個(gè)輸出流，并將文件（輸入流）通過(guò)該流發(fā)送給瀏覽器

     • 獲取輸出流：ServletOutputStream out = response.getOutputStream();

     • 通過(guò)輸出流向?yàn)g覽器發(fā)送文件（不要忘了關(guān)閉輸入流）

       byte[] b = new byte[1024];
       int len = 0;
       while((len=is.read(b))> 0){
       	out.write(b, 0, len);
       }
       is.close();
       
       

2.2 步驟演示

• 一下步驟都是在同一個(gè)Servlet的doGet()方法中編寫的

• 我所下載的文件是放在WEB-INF下mp3文件夾中的文件

• 具體步驟

  1. 獲取文件的流：

     String realPath = getServletContext().getRealPath("/WEB-INF/mp3/中國(guó)話.mp3");
     //獲取文件的File對(duì)象
     File file = new File(realPath);
     //獲取文件的輸入流
     FileInputStream is = new FileInputStream(file);
     
     

  2. 獲取頭信息：

     //獲取文件的MIME信息
     String contentType = getServletContext().getMimeType(realPath);
     //設(shè)置下載文件的名字
     String filename = "zhongguohua.mp3";
     //創(chuàng)建Content-Disposition信息
     String disposition = "attachment; filename="+ filename ;
     //獲取文件長(zhǎng)度
     long size = file.length();
     
     

  3. 設(shè)置頭信息

     //設(shè)置Content-Type
     response.setContentType(contentType);
     //設(shè)置Content-Disposition
     response.setHeader("Content-Disposition", disposition);
     //設(shè)置文件長(zhǎng)度
     response.setContentLength((int)size);
     
     

  4. 發(fā)送文件

     //通過(guò)response獲取輸出流，用于向?yàn)g覽器輸出內(nèi)容
     ServletOutputStream out = response.getOutputStream();
     //將文件輸入流通過(guò)輸出流輸出
     byte[] b = new byte[1024];
     int len = 0;
     while((len=is.read(b))> 0){
     	out.write(b, 0, len);
     }
     //最后不要忘記關(guān)閉輸入流，輸出流由Tomcat自己處理，我們不用手動(dòng)關(guān)閉
     is.close();
     
     

2.3 亂碼

• 至此實(shí)際上文件下載的主要功能都已經(jīng)完成。但是還有一個(gè)問(wèn)題我們這里沒(méi)有體現(xiàn)出來(lái)，因?yàn)槟壳拔覀兊奈募褂玫氖羌冇⑽牡?#xff0c;沒(méi)有亂碼問(wèn)題。這里如果我們要使用中文文件名的話，毫無(wú)疑問(wèn)會(huì)出現(xiàn)亂碼問(wèn)題。

• 解決此問(wèn)題的方法很簡(jiǎn)單，在獲取文件名之后為文件名進(jìn)行編碼：

filename = java.net.URLEncoder.encode(filename,"utf-8");

• 但是注意這里火狐瀏覽器比較特殊，因?yàn)樗J(rèn)是以BASE64解碼的，所以這塊如果需要考慮火狐的問(wèn)題的話還需要特殊處理一下。

  1. 先要獲取客戶端信息（通過(guò)獲取請(qǐng)求頭中的User-Agent信息）

  //獲取客戶端信息
  String ua = request.getHeader("User-Agent");
  
  

  2. 然后判斷瀏覽器版本，做不同的處理（通過(guò)判斷頭信息中是否包含F(xiàn)irefox字符串來(lái)判斷瀏覽器版本）

  //判斷客戶端是否為火狐
  if(ua.contains("Firefox")){
  	//若為火狐使用BASE64編碼
  	filename = "=?utf-8?B?"+new BASE64Encoder()
  .encode(filename.getBytes("utf-8"))+"?=";
  }else{
  	//否則使用UTF-8
  	filename = URLEncoder.encode(filename,"utf-8");
  }
  
  

完整代碼：

  //設(shè)置響應(yīng)字符集
        response.setContentType("text/html; charset=UTF-8");

        DiskFileItemFactory diskFileItemFactory=new DiskFileItemFactory();
        //創(chuàng)建解析器
        ServletFileUpload servletFileUpload=new ServletFileUpload(diskFileItemFactory);
        //設(shè)置上傳文件的大小
        servletFileUpload.setFileSizeMax(1024*500);
        //獲取上傳的真實(shí)路徑
        String realPath = getServletContext().getRealPath("/upload");
        //優(yōu)化1:如果文件路勁不存在，則重新創(chuàng)建一個(gè)
         File refile=new File(realPath);
         if(refile.exists()==false){
             refile.mkdirs();
         }
         //優(yōu)化2：若同名文件 則添加不上，因此解決同名文件，讓其添加上。
        //優(yōu)化3：設(shè)置上傳文件大小
        //在前臺(tái)傳來(lái)的文件雖然為同一個(gè)文件，但是在后臺(tái)我們可以將文件名進(jìn)行擴(kuò)展。
        // 通過(guò)ServletFileUpload中的List<FileItem>  parseRequest(request)，將request解析為L(zhǎng)ist<FileItem>
        try {
            List<FileItem> fileItems = servletFileUpload.parseRequest(request);
            //遍歷集合
            for (FileItem fileItem : fileItems) {
                if(fileItem.isFormField()==false){
                    //獲取文件名
                    String fname = fileItem.getName();
                    //處理文件名
                    String replacename = UUID.randomUUID().toString().replace("-", "");
                   //將文件上傳到服務(wù)器的指定位置
                    File file=new File(realPath+File.separator+replacename+fname);
                    fileItem.write(file);
                    PrintWriter writer = response.getWriter();
                    writer.write("upload success");

                }
            }
        }
        catch (FileUploadBase.FileSizeLimitExceededException e){
            response.getWriter().write("上傳文件大小超過(guò)50KB");
        }
        catch (Exception e) {
            e.printStackTrace();
        }

jsp代碼：

<%--
  Created by IntelliJ IDEA.
  User: admin
  Date: 2020/8/19
  Time: 16:29
  To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>下載demo</title>
</head>
<body>
<a href="DownServlet?fname=gson.jar">jar包下載</a>
<a href="DownServlet?fname=a698e5967c4d4c23a895ce42e3289d260.jpg">千庫(kù)網(wǎng)_粉色背景里的玫瑰花束_攝影圖編號(hào)73147.jpg</a>
<a href="">xxx.pptx</a>
</body>
</html>