JavaWeb之文件的上傳和下載

王振國老師整理

 

 

文件的上傳和下載

文件的上傳和下載，是非常常見的功能。很多的系統中，或者軟件中都經常使用文件的上傳和下載。

比如：QQ 頭像，就使用了上傳。

郵箱中也有附件的上傳和下載功能。

OA 系統中審批有附件材料的上傳。

文件的上傳介紹

• 要有一個 form 標籤，method=post 請求
• form 標籤的 encType 屬性值必須爲 multipart/form-data 值
• 在 form 標籤中使用 input type=file 添加上傳的文件
• 編寫服務器代碼（Servlet 程序）接收，處理上傳的數據。
• encType=multipart/form-data 表示提交的數據，以多段（每一個表單項一個數據段）的形式進行拼 接，然後以二進制流的形式發送給服務器

文件上傳，HTTP 協議的說明

commons-fileupload.jar 常用 API 介紹說明

commons-fileupload.jar 需要依賴 commons-io.jar 這個包，所以兩個包我們都要引入。

commons-fileupload.jar 和 commons-io.jar 包中，我們常用的類有哪些？

• ServletFileUpload 類，用於解析上傳的數據。
• FileItem 類，表示每一個表單項。

boolean ServletFileUpload.isMultipartContent(HttpServletRequest request); 判斷當前上傳的數據格式是否是多段的格式。 

public List parseRequest(HttpServletRequest request) 解析上傳的數據 

boolean FileItem.isFormField() 判斷當前這個表單項，是否是普通的表單項。還是上傳的文件類型。 true 表示普通類型的表單項 false 表示上傳的文件類型 

String FileItem.getFieldName() 獲取表單項的 name 屬性值 

String FileItem.getString() 獲取當前表單項的值。 

String FileItem.getName(); 獲取上傳的文件名 void FileItem.write( file ); 將上傳的文件寫到 參數 file 所指向抽硬盤位置 。 

fileupload 類庫的使用：

上傳文件的表單：

<form action="http://192.168.31.74:8080/09_EL_JSTL/uploadServlet" method="post"
      enctype="multipart/form-data">
    用戶名：<input type="text" name="username" /> <br>
    頭像：<input type="file" name="photo" > <br>
    <input type="submit" value="上傳">
</form>

解析上傳的數據的代碼：

protected void doPost( HttpServletRequest request, HttpServletResponse response ) throws ServletException, IOException {

        //1 先判斷上傳的數據是否多段數據（只有是多段的數據，纔是文件上傳的）
        if (ServletFileUpload.isMultipartContent(request)) {
//           創建FileItemFactory工廠實現類
            FileItemFactory fileItemFactory = new DiskFileItemFactory();
            // 創建用於解析上傳數據的工具類ServletFileUpload類
            ServletFileUpload servletFileUpload = new ServletFileUpload(fileItemFactory);
            try {
                // 解析上傳的數據，得到每一個表單項FileItem
                List<FileItem> list = servletFileUpload.parseRequest(request);
                // 循環判斷，每一個表單項，是普通類型，還是上傳的文件
                for (FileItem fileItem : list) {

                    if (fileItem.isFormField()) {
                        // 普通表單項

                        System.out.println("表單項的name屬性值：" + fileItem.getFieldName());
                        // 參數UTF-8.解決亂碼問題
                        System.out.println("表單項的value屬性值：" + fileItem.getString("UTF-8"));

                    } else {
                        // 上傳的文件
                        System.out.println("表單項的name屬性值：" + fileItem.getFieldName());
                        System.out.println("上傳的文件名：" + fileItem.getName());

                        fileItem.write(new File("e:\\" + fileItem.getName()));
                    }
                }
            } catch (Exception e) {
                e.printStackTrace();
            }
        }

    }

 

文件下載

常用 API 說明：

• response.getOutputStream();
• servletContext.getResourceAsStream();
• servletContext.getMimeType();
• response.setContentType();

response.setHeader("Content-Disposition", "attachment; fileName=1.jpg");

這個響應頭告訴瀏覽器。這是需要下載的。而 attachment 表示附件，也就是下載的一個文件。fileName=後面， 表示下載的文件名。

完成上面的兩個步驟，下載文件是沒問題了。但是如果我們要下載的文件是中文名的話。你會發現，下載無法正確 顯示出正確的中文名。

原因是在響應頭中，不能包含有中文字符，只能包含 ASCII 碼。

附件中文名亂碼問題解決方案：

方案一：URLEncoder 解決 IE 和 谷歌瀏覽器 的附件中文名問題。

如果客戶端瀏覽器是 IE 瀏覽器 或者 是谷歌瀏覽器。我們需要使用 URLEncoder 類先對中文名進行 UTF-8 的編碼 操作。

因爲 IE 瀏覽器和谷歌瀏覽器收到含有編碼後的字符串後會以 UTF-8 字符集進行解碼顯示。

// 把中文名進行 UTF-8 編碼操作。
String str = "attachment; fileName=" + URLEncoder.encode("中文.jpg", "UTF-8");
// 然後把編碼後的字符串設置到響應頭中
response.setHeader("Content-Disposition", str);

方案二：BASE64 編解碼 解決 火狐瀏覽器 的附件中文名問題

如果客戶端瀏覽器是火狐瀏覽器。 那麼我們需要對中文名進行 BASE64 的編碼操作。

這時候需要把請求頭

• Content-Disposition: attachment; filename=中文名

編碼成爲：

• Content-Disposition: attachment; filename==?charset?B?xxxxx?=

=?charset?B?xxxxx?= 現在我們對這段內容進行一下說明。

=?

charset

B

xxxx

?=

BASE64 編解碼操作：

因爲火狐使用的是 BASE64 的編解碼方式還原響應中的漢字。所以需要使用 BASE64Encoder 類進行編碼操作。

// 使用下面的格式進行 BASE64 編碼後
String str = "attachment; fileName=" + "=?utf-8?B?"
+ new BASE64Encoder().encode("中文.jpg".getBytes("utf-8")) + "?=";
// 設置到響應頭中
response.setHeader("Content-Disposition", str);

那麼我們如何解決上面兩種不同編解碼方式呢。我們只需要通過判斷請求頭中 User-Agent 這個請求頭攜帶過來的 瀏覽器信息即可判斷出是什麼瀏覽器。

如下：

String ua = request.getHeader("User-Agent");
// 判斷是否是火狐瀏覽器
if (ua.contains("Firefox")) {
// 使用下面的格式進行 BASE64 編碼後
String str = "attachment; fileName=" + "=?utf-8?B?"
+ new BASE64Encoder().encode("中文.jpg".getBytes("utf-8")) + "?=";
// 設置到響應頭中
response.setHeader("Content-Disposition", str);
} else {
// 把中文名進行 UTF-8 編碼操作。
String str = "attachment; fileName=" + URLEncoder.encode("中文.jpg", "UTF-8");
// 然後把編碼後的字符串設置到響應頭中
response.setHeader("Content-Disposition", str);
}