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;
}
運行程式,結果如下圖:
