JavaEE系列之(二)commons-fileupload實現文件上傳、下載


一、文件上傳概述

    實現Web開發中的文件上傳功能,需要兩步操作:
    1、在Web頁面中添加上傳輸入項
  1.        <form action="#" method="post" enctype="multipart/form-data">
                <input type="file" name="filename1"/><br>
                <input type="file" name="filename2"/><br>
                <input type="submit" value="上傳"/>
           <form>
           <!-- 1、表單方式必須是post
                2、必須設置encType屬性為 multipart/form-data.設置該值后,瀏覽器在上傳文件時,將會把文件數據附帶在http請求消息體中,
    並使用MIME協議對上傳的文件進行描述,以方便接收方對上傳數據進行解析和處理。 3、必須要設置input的name屬性,否則瀏覽器將不會發送上傳文件的數據。
    -->

         2、在Servlet中讀取文件上傳數據,並保存到服務器硬盤

             Request對象提供了一個getInputStream方法,通過這個方法可以讀取到客戶端提交過來的數據。但由於用戶可能會同時上傳多個文件,在Servlet端編程直接讀取上傳數據,並分別解析出相應的文件數據是一項非常麻煩的工作。
             比如下面是截取的瀏覽器上傳文件時發送的請求的HTTP協議中的部分內容:         
Accept-Language: zh-Hans-CN,zh-Hans;q=0.5
Content-Type: multipart/form-data; boundary=---------------------------7dfa01d1908a4
UA-CPU: AMD64
Accept-Encoding: gzip, deflate
User-Agent: Mozilla/5.0 (Windows NT 6.2; Win64; x64; Trident/7.0; rv:11.0) like Gecko
Content-Length: 653
Host: localhost:8080
Connection: Keep-Alive
Pragma: no-cache
Cookie: JSESSIONID=11CEFF8E271AB62CE676B5A87B746B5F
-----------------------------7dfa01d1908a4
Content-Disposition: form-data; name="username"
zhangsan
-----------------------------7dfa01d1908a4
Content-Disposition: form-data; name="userpass"
1234
-----------------------------7dfa01d1908a4
Content-Disposition: form-data; name="filename1"; filename="C:\Users\ASUS\Desktop\upload.txt"
Content-Type: text/plain
this is first file content!
-----------------------------7dfa01d1908a4
Content-Disposition: form-data; name="filename1"; filename="C:\Users\ASUS\Desktop\upload2.txt"
Content-Type: text/plain
this is Second file content!
hello
-----------------------------7dfa01d1908a4--

             從上面的數據中也可以看出,如果自己手工的去分割讀取數據很難寫出健壯穩定的程序。所以,為方便用戶處理上傳數據,Apache開源組織提供了一個用來處理表單文件上傳的一個開源組件(Commons-fileupload),該組件性能優異,並且其API使用極其簡單,可以讓開發人員輕松實現web文件上傳功能,因此在web開發中實現文件上傳功能,通常使用Commons-fileupload組件實現。

             需要導入兩個jar包:Commons-fileupload、commons-io
  1         response.setContentType("text/html;charset=utf-8");//設置響應編碼
  2         request.setCharacterEncoding("utf-8");
  3         PrintWriter writer = response.getWriter();//獲取響應輸出流
  4         
  5         ServletInputStream inputStream = request.getInputStream();//獲取請求輸入流
  6         
  7         /*
  8          * 1、創建DiskFileItemFactory對象,設置緩沖區大小和臨時文件目錄
  9          *    該類有兩個構造方法一個是無參的構造方法,
 10          *    另一個是帶兩個參數的構造方法
 11          * @param  int sizeThreshold,該參數設置內存緩沖區的大小,默認值為10K。當上傳文件大於緩沖區大小時,fileupload組件將使用臨時文件緩存上傳文件
 12          * @param  java.io.File repository,該參數指定臨時文件目錄,默認值為System.getProperty("java.io.tmpdir");
 13          * 
 14          *    如果使用了無參的構造方法,則使用setSizeThreshold(int sizeThreshold),setRepository(java.io.File repository)
 15          *    方法手動進行設置 
 16          */
 17         DiskFileItemFactory factory = new DiskFileItemFactory();
 18         
 19         int sizeThreshold=1024*1024;
 20         factory.setSizeThreshold(sizeThreshold);
 21         
 22         File repository = new File(request.getSession().getServletContext().getRealPath("temp"));
 23 //        System.out.println(request.getSession().getServletContext().getRealPath("temp"));
 24 //        System.out.println(request.getRealPath("temp"));
 25         factory.setRepository(repository);
 26         
 27         /*
 28          * 2、使用DiskFileItemFactory對象創建ServletFileUpload對象,並設置上傳文件的大小
 29          *    
 30          *    ServletFileUpload對象負責處理上傳的文件數據,並將表單中每個輸入項封裝成一個FileItem
 31          *    該對象的常用方法有:
 32          *           boolean isMultipartContent(request);判斷上傳表單是否為multipart/form-data類型
 33          *           List parseRequest(request);解析request對象,並把表單中的每一個輸入項包裝成一個fileItem 對象,並返回一個保存了所有FileItem的list集合
 34          *           void setFileSizeMax(long filesizeMax);設置單個上傳文件的最大值
 35          *           void setSizeMax(long sizeMax);設置上傳溫江總量的最大值
 36          *           void setHeaderEncoding();設置編碼格式,解決上傳文件名亂碼問題
 37          */
 38         ServletFileUpload upload = new ServletFileUpload(factory);
 39         
 40         upload.setHeaderEncoding("utf-8");//設置編碼格式,解決上傳文件名亂碼問題
 41         /*
 42          * 3、調用ServletFileUpload.parseRequest方法解析request對象,得到一個保存了所有上傳內容的List對象
 43          */
 44         List<FileItem> parseRequest=null;
 45         try {
 46              parseRequest = upload.parseRequest(request);
 47         } catch (FileUploadException e) {
 48             e.printStackTrace();
 49         }
 50         /*
 51          * 4、對list進行迭代,每迭代一個FileItem對象,調用其isFormField方法判斷是否是文件上傳
 52          *    true表示是普通表單字段,則調用getFieldName、getString方法得到字段名和字段值
 53          *    false為上傳文件,則調用getInputStream方法得到數據輸入流,從而讀取上傳數據
 54          *    
 55          *    FileItem用來表示文件上傳表單中的一個上傳文件對象或者普通的表單對象
 56          *    該對象常用方法有:
 57          *         boolean isFormField();判斷FileItem是一個文件上傳對象還是普通表單對象
 58          *         true表示是普通表單字段,
 59          *                 則調用getFieldName、getString方法得到字段名和字段值
 60          *         false為上傳文件,
 61          *                 則調用getName()獲得上傳文件的文件名,注意:有些瀏覽器會攜帶客戶端路徑,需要自己減除
 62          *                 調用getInputStream()方法得到數據輸入流,從而讀取上傳數據
 63          *                 delete(); 表示在關閉FileItem輸入流后,刪除臨時文件。
 64          */
 65         
 66         for (FileItem fileItem : parseRequest) {
 67             if (fileItem.isFormField()) {//表示普通字段
 68                 if ("username".equals(fileItem.getFieldName())) {
 69                     String username = fileItem.getString();
 70                     writer.write("您的用戶名:"+username+"<br>");
 71                 }
 72                 if ("userpass".equals(fileItem.getFieldName())) {
 73                     String userpass = fileItem.getString();
 74                     writer.write("您的密碼:"+userpass+"<br>");
 75                 }
 76                 
 77             }else {//表示是上傳的文件
 78                 //不同瀏覽器上傳的文件可能帶有路徑名,需要自己切割
 79                 String clientName = fileItem.getName();
 80                 String filename = "";
 81                 if (clientName.contains("\\")) {//如果包含"\"表示是一個帶路徑的名字,則截取最后的文件名
 82                     filename = clientName.substring(clientName.lastIndexOf("\\")).substring(1);
 83                 }else {
 84                     filename = clientName;
 85                 }
 86                 
 87                 UUID randomUUID = UUID.randomUUID();//生成一個128位長的全球唯一標識
 88                 
 89                 filename = randomUUID.toString()+filename;
 90                 
 91                 /*
 92                  * 設計一個目錄生成算法,如果所用用戶上傳的文件總數是億數量級的或更多,放在同一個目錄下回導致文件索引非常慢,
 93                  * 所以,設計一個目錄結構來分散存放文件是非常有必要,且合理的
 94                  * 將UUID取哈希算法,散列到更小的范圍,
 95                  * 將UUID的hashcode轉換為一個8位的8進制字符串,
 96                  * 從這個字符串的第一位開始,每一個字符代表一級目錄,這樣就構建了一個八級目錄,每一級目錄中最多有16個子目錄
 97                  * 這無論對於服務器還是操作系統都是非常高效的目錄結構
 98                  */
 99                 int hashUUID =randomUUID.hashCode();
100                 String hexUUID = Integer.toHexString(hashUUID);
101                 //System.out.println(hexUUID);
102                 //獲取將上傳的文件存存儲在哪個文件夾下的絕對路徑
103                 String filepath=request.getSession().getServletContext().getRealPath("upload");
104                 for (char c : hexUUID.toCharArray()) {
105                     filepath = filepath+"/"+c;
106                 }
107                 //如果目錄不存在就生成八級目錄
108                 File filepathFile = new File(filepath);
109                 if (!filepathFile.exists()) {
110                     filepathFile.mkdirs();
111                 }
112                 //從Request輸入流中讀取文件,並寫入到服務器
113                 InputStream inputStream2 = fileItem.getInputStream();
114                 //在服務器端創建文件
115                 File file  = new File(filepath+"/"+filename);
116                 BufferedOutputStream bos = new BufferedOutputStream(new FileOutputStream(file));
117                 
118                 byte[] buffer = new byte[10*1024];
119                 int len = 0;
120                 while ((len= inputStream2.read(buffer, 0, 10*1024))!=-1) {
121                     bos.write(buffer, 0, len);
122                 }
123                 writer.write("您上傳文件"+clientName+"成功<br>");
124                 //關閉資源
125                 bos.close();
126                 inputStream2.close();
127             }
128         }
129     //注意Eclipse的上傳的文件是保存在項目的運行目錄,而不是workspace中的工程目錄里。

 

二、文件上傳需要特別注意的問題:(這些問題在上面的代碼中都提供了簡單的解決)

       1、文件存放的位置
          為保證服務器的安全,上傳文件應保存在應用程序的WEB-INF目錄下,或者不受WEB服務器管理的目錄,如果用戶上傳一個帶有可執行代碼的文件,如jsp文件,根據拼接訪問路徑去訪問的話,可以在服務器端做任何事情。
       2、為防止多用戶上傳形同文件名的文件,而導致文件覆蓋的情況發生,文件上傳程序應保證上傳文件具有唯一文件名。
          使用UUID + 用戶上傳文件名的方式重命名
          關於UUID:
             UUID(Universally Unique Identifier)全局唯一標識符,是指在一台機器上生成的數字,它保證對在同一時空中的所有機器都是唯一的。按照開放軟件基金會(OSF)制定的標准計算,用到了以太網卡地址、納秒級時間、芯片ID碼和許多可能的數字。由以下幾部分的組合:當前日期和時間(UUID的第一個部分與時間有關,如果你在生成一個UUID之后,過幾秒又生成一個UUID,則第一個部分不同,其余相同),時鍾序列,全局唯一的IEEE機器識別號(如果有網卡,從網卡獲得,沒有網卡以其他方式獲得),UUID的唯一缺陷在於生成的結果串會比較長。
            是一個128位長的數字,一般用16進制表示。算法的核心思想是結合機器的網卡、當地時間、一個隨即數來生成GUID。從理論上講,如果一台機器每秒產生10000000個GUID,則可以保證(概率意義上)3240年不重復。
            從JDK1.5開始,生成UUID變成了一件簡單的事,以為JDK實現了UUID:
java.util.UUID,直接調用即可.
UUID uuid  =  UUID.randomUUID();
String s = UUID.randomUUID().toString();//用來生成數據庫的主鍵id非常不錯。。  
 
UUID是由一個十六位的數字組成,表現出來的形式例如
550E8400-E29B-11D4-A716-446655440000 

       3、為防止單個目錄下文件過多,影響文件讀寫速度,處理上傳文件的程序應該應根據可能的上傳總量,選擇合適的目錄結構生成算法,將上傳文件分散存儲。如使用hashcode方法構建多級目錄。

       4、如果不同用戶都上傳了相同的文件,那么在服務器端沒有必要存儲同一個文件的很多分拷貝,這樣很浪費資源,應該設計算法解決這種重復文件的問題。
       5、JSP技術原理自動實現了多線程。所以開發者不需要考慮上傳文件的多線程操作
 
三、文件下載  
<%
        ArrayList<String> fileNames = new ArrayList<String>();
        fileNames.add("file/aa.txt");
        fileNames.add("file/bb.jpg");
        for(String fileName : fileNames) {
      %>
     
        <form action="DownloadServlet" method="get">
            <input type="hidden" name="fileName" value="<%=fileName %>" />
            <input type="submit" value="下載:<%=fileName %>" />
        </form>
     <%
        }
     %>
        request.setCharacterEncoding("utf-8");
        
        String filename = request.getParameter("fileName");
        
        
        String urlname = URLEncoder.encode(filename, "utf-8");//防止文件名中有中文亂碼
        response.setHeader("Content-Disposition","attachment;filename="+urlname);
        
        FileInputStream fis = new FileInputStream(new File(request.getSession().getServletContext().getRealPath(filename)));
        BufferedInputStream bis = new BufferedInputStream(fis);
        ServletOutputStream sos = response.getOutputStream();
        
        byte[] buffer = new byte[1024];
        int len=0;
        while((len=bis.read(buffer, 0, 1024))!=-1){
            sos.write(buffer, 0, len);
        }
        bis.close();
        fis.close();

 

四、在SSH中使用smartUpload組件簡化文件上傳下載
 






免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM