DIV CSS 佈局教程網

jQuery Ajax 請求檔案下載失敗的原因與解決辦法
編輯:AJAX基礎知識     

jQuery 確實是一個相當優秀的輕量級 JS 框架,能幫助我們快速開發 JS 應用,並在一定程度上改變了我們撰寫 JavaScript 程式碼的習慣。

廢話少說,直接進入正題,我們先來分析一下失敗的原因。

一、失敗的原因

那是因為 response 的緣故。一般請求瀏覽器會處理伺服器輸出的 response,例如生成 png、檔案下載等;然而 Ajax 請求只是個「字元型」的請求,即請求的內容是以文字型別存放的。檔案的下載是以二進位形式進行的,雖然可以讀取到返回的 response,但只是讀取而已,無法執行,說白點就是 JS 無法呼叫到瀏覽器的下載處理機制和程式。

二、解決方案

1)可以使用 jQuery 建立表單並提交來實現檔案下載:

var form = $("<form>");
form.attr("style", "display:none");
form.attr("target", "");
form.attr("method", "post");
form.attr("action", rootPath + "T_academic_essay/DownloadZipFile.do");
var input1 = $("<input>");
input1.attr("type", "hidden");
input1.attr("name", "strZipPath");
input1.attr("value", strZipPath);
$("body").append(form);
form.append(input1);
form.submit();
form.remove();

2)可以直接使用 a 標簽實現檔案下載:

<a href="下載位址">點擊下載</a>

3)使用隱藏 iframe 或新視窗解決。

PS:以下補充說明 AJAX 請求 $.ajax 方法的使用。使用 jQuery 的 $.ajax 方法可以更為詳細地控制 AJAX 請求,它在 AJAX 請求上施加細粒度級別的控制。

$.ajax 方法語法:

$.ajax(options)
// 參數 options(物件):一個物件的實例,其屬性定義這個操作的參數
// 返回值:XHR 實例

options 詳細範圍值:

url(字串)請求的 url 位址。

type(字串)將要使用的 HTTP 方法,通常是 POST 或 GET,若省略則預設為 GET。

data(物件)一個物件,其屬性作為查詢參數而傳遞請求。若是 GET 請求,則把資料作為查詢字串傳遞;若是 POST 請求,則把資料作為請求體傳遞。在這兩種情況下,都是由 $.ajax() 實用工具函式來處理值的編碼。

dataType(字串)一個關鍵字,用來標識預期將被回應所返回的資料的型別,這個值決定再把資料傳遞給回呼函式之前進行什麼後續處理。有效值如下:

xml:回應文字被解析為 XML 文件,而作為結果的 XML DOM 被傳遞給回呼函式。

html:回應文字未經處理就被傳遞給回呼函式,在已返回 HTML 片段內的任何 <script> 塊將被求值。

json:回應文字被求值為 JSON 字串,而作為結果的物件被傳遞給回呼函式。

jsonp:與 json 相似,不同之處是提供遠端腳本支援(假定遠端伺服器支援)。

script:回應文字被傳遞給回呼函式,在任何回呼函式被呼叫之前,回應被作為一個或多個 JavaScript 語句而進行處理。

text:回應文字被假定為普通文字,伺服器資源負責設定適當的內容型別回應標頭。若省略這個屬性,則不對回應文字進行任何處理或求值就傳遞給回呼函式。

timeout(數值)設定 Ajax 請求的逾時值(毫秒)。若請求在逾時值到期之前仍未完成,則中止請求並呼叫錯誤回呼函式(若已定義)。

global(布林型)啟用或停用全域函式的觸發,這些函式可以附加到元素上,並且在 Ajax 呼叫的不同時刻或狀態下觸發,預設啟用全域函式觸發。

contentType(字串)將要在請求上指定的內容型別,預設為 application/x-www-form-urlencoded(與表單提交所使用的預設型別相同)。

success(函式)若請求的回應指示成功狀態碼,則這個函式被呼叫。回應體作為第一個參數被返回給這個函式,並根據指定的 dataType 屬性進行處理;第二個參數是包含狀態碼的字串。

error(函式)若請求的回應返回錯誤狀態碼,則這個函式被呼叫。三個實參被傳遞給這個函式:XHR 實例、狀態消息字串以及 XHR 實例所返回的異常物件(可選)。

complete(函式)請求完成時被呼叫,兩個實參被傳遞:XHR 實例和狀態消息字串。若也指定了 success 或 error 回呼函式,則這個函式在 success 或 error 回呼函式呼叫之後被呼叫。

beforeSend(函式)在發起請求之前被呼叫,這個函式被傳遞 XHR 實例,並且可以用來設定自訂的標頭或執行其他預請求操作。

async(布林型)若指定為 false,則請求被提交為同步請求;在預設的情況下,請求是非同步的。

processData(布林型)若設定為 false,則阻止已傳遞資料被加工為 URL 編碼格式;預設情況下,資料被加工為 URL 編碼格式。

ifModified(布林型)若設定為 true,則自從上一次請求以來,只有在回應內容沒有改變的情況下(根據 Last-Modified 標頭)才允許請求成功;若省略,則不執行標頭檢查。

下面看個盡可能多用到 options 中選項的例子。

客戶端程式碼:

<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<title></title>
<script src="Scripts/jquery-1.4.1.min.js" type="text/javascript"></script>
<script type="text/javascript">
$().ready(function () {
    $('#selectNum').change(function () {
        var idValue = $(this).val();
        var show = $('#show');
        $.ajax({
            url: 'Server.aspx',
            type: 'POST',
            data: { id: idValue },
            timeout: 3000, // 調小逾時時間會引起異常
            success: function (data) { // 請求成功後觸發
                show.append('success invoke!' + data + '<br/>');
            },
            error: function (xhr, errorInfo, ex) { // 請求失敗遇到異常觸發
                show.append('error invoke!errorInfo:' + errorInfo + '<br/>');
            },
            complete: function (xhr, status) { // 完成請求後觸發,即在 success 或 error 觸發後觸發
                show.append('complete invoke! status:' + status + '<br/>');
            },
            beforeSend: function (xhr) { // 發送請求前觸發,可設定自訂標頭
                xhr.setRequestHeader('Content-Type', 'application/xml;charset=utf-8');
                show.append('beforeSend invoke!' + '<br/>');
            },
            async: true // 是否使用非同步發送
        })
    })
})
</script>
</head>
<body>
<select id="selectNum">
<option value="0">--Select--</option>
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
</select>
<div id="show"></div>
</body>
</html>

伺服器端主要程式碼:

protected void Page_Load(object sender, EventArgs e) {
    if (!Page.IsPostBack) {
        if (Request["id"] != null && !string.IsNullOrEmpty(Request["id"].ToString())) {
            // 啟用該句會引發 ajax 逾時異常
            // System.Threading.Thread.Sleep(3000);
            Response.Write(GetData(Request["id"].ToString()));
        }
    }
}
protected string GetData(string id) {
    string str = string.Empty;
    switch (id) {
        case "1": str += "This is Number 1"; break;
        case "2": str += "This is Number 2"; break;
        case "3": str += "This is Number 3"; break;
        default: str += "Warning Other Number!"; break;
    }
    return str;
}

運行程式,結果如下圖:

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