DIV CSS 佈局教程網

用隱藏 iframe 觸發檔案下載,避免彈出新視窗
編輯:JQuery特效代碼     

做「點擊按鈕 → 後端產生 Excel → 檔案下載」這條流程時,踩到一個很典型的坑:下載視窗總是跳出來。以下記錄問題與解法。

後端:輸出檔案流

產生 Excel 並觸發下載其實很直觀。在 action 中產檔、填資料、存到暫存資料夾,然後把 Content-Disposition 設為 attachment,瀏覽器就會跳出下載對話框。

/**
 * @param response
 * @param downloadFile
 */
private void clientResponse(HttpServletResponse response, File downloadFile, String fileName){
  try {
    response.reset();
    response.setContentType("application/octet-stream");

    // 設為 attachment 才會彈出「檔案下載」視窗
    response.setHeader("Content-Disposition",
        "attachment;filename=" + new String(fileName.getBytes(), "ISO-8859-1"));

    InputStream  input  = new FileInputStream(downloadFile);
    OutputStream output = response.getOutputStream();
    int c;
    // 讀取串流並寫入
    while ((c = input.read()) != -1) {
      output.write(c);
    }
    output.flush();
    output.close();
    input.close();
  } catch (Exception e) { }
}

那段 new String(fileName.getBytes(), "ISO-8859-1") 是為了處理中文檔名。HTTP 標頭只能承載 ISO-8859-1,所以要把中文檔名轉成位元組後再以此編碼解讀,否則使用者會看到一串亂碼。實務上更推薦用 Content-Disposition 的 filename*=UTF-8'' 形式,或引用 javax.mail.internet.MimeUtility.encodeWord()。

問題一:總是彈出新視窗

測試時發現,點擊「我要修改」按鈕總會開一個新視窗。搜尋後加了這段:

<base target="_self">    <!-- 在當前頁開啟 -->

先理解 base 標籤:base 為頁面上所有連結規定的預設網址或預設目標,target 則是跳轉的目標視窗。

<base target="_blank">  <!-- 在空白頁開啟 -->
<base target="_parent"> <!-- 在目前頁的上一層(父框架)開啟 -->
<base target="_search"> <!-- 在瀏覽器某個特殊窗格開啟 -->
<base target="_self">   <!-- 在當前頁開啟 -->
<base target="_top">    <!-- 在最頂層框架開啟 -->

問題二:換成 _self 就無法下載了

視窗不彈了,但檔案也下載不了。因為在當前頁導航,瀏覽器會直接把二進位內容當頁面處理,而不是觸發下載。

於是我想到 iframe:設一個看不見的 iframe,把 target 指向它的 name,就能既留在本頁、又正常下載。

<iframe id="download" name="download" height="0px" width="0px"></iframe>

<base target="download">

<base ...> 必須放在 <head></head> 之間。

為什麼這招有效

關鍵在於:Content-Disposition: attachment 是給瀏覽器的指示,瀏覽器收到後會「弹出下載對話框並保持當前頁面不動」。問題從來不在下載機制,而在哪個視窗負責接收這個回應。把目標指向一個 0×0 的隱藏 iframe,回應就由它吸收,主視窗完全不動,下載照常發生。這比 _self 安全,也比 _blank 不惱人。

實務補充

如果不想用 base 標籤(它會影響頁面上所有連結,容易誤傷),也可以只針對觸發元素處理,例如用 JS 設定表單的 target:

$("#myForm").attr("target", "download").submit();

另外記得:後端的 catch 區塊不該是空的,至少要記錄 log,否則出問題時無從追查;串流寫入完畢後關閉資源的順序也建議改用 try-with-resources 或 finally 確保一定釋放。最後,檔名若來自使用者輸入,務必過濾 " 與換行字元,避免標頭注入。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved