JQuery.Ajax之協助資訊，jquery.ajax

JQuery.Ajax之協助資訊，jquery.ajax

  jQuery中AJAX參數詳細

1，url        String        (預設: 當前頁地址) 發送請求的地址。

2,  type       String        (預設: "GET") 請求方式 ("POST" 或 "GET")， 預設為 "GET"。注意：其它 HTTP 要求方法，如 PUT 和 DELETE 也可以使用，但僅部分瀏覽器支援。

3,  timeout  Number    佈建要求逾時時間（毫秒）。此設定將覆蓋全域設定。

4,  async     Boolean     (預設: true) 預設設定下，所有請求均為非同步請求。如果需要發送同步請求，請將此選項設定為 false。注意，同步請求將鎖住瀏覽器，使用者其它操作必須    等待請求完成才可以執行。

5,  beforeSend   Function      發送請求前可修改 XMLHttpRequest 對象的函數，如添加自訂 HTTP 頭。XMLHttpRequest 對象是唯一的參數。

function (XMLHttpRequest) {  this; // the options for this ajax request}

6,  cache   Boolean     (預設: true) jQuery 1.2 新功能，設定為 false 將不會從瀏覽器緩衝中載入請求資訊。

7, complete    Function    請求完成後回呼函數 (請求成功或失敗時均調用)。參數： XMLHttpRequest 對象，成功資訊字串。

function (XMLHttpRequest, textStatus) {  this; // the options for this ajax request}

8, contentType    String     (預設: "application/x-www-form-urlencoded") 發送資訊至伺服器時內容編碼類別型。預設值適合大多數應用場合。

9,  data     Object,String     發 送到伺服器的資料。將自動轉換為請求字串格式。GET 請求中將附加在 URL 後。查看 processData 選項說明以禁止此自動轉換。必須為 Key/Value 格式。如果為數組，jQuery 將自動為不同值對應同一個名稱。如 {foo:["bar1", "bar2"]} 轉換為 '&foo=bar1&foo=bar2'。

10, dataType    String

預期伺服器返回的資料類型。如果不指定，jQuery 將自動根據 HTTP 包 MIME 資訊返回 responseXML 或 responseText，並作為回呼函數參數傳遞，可用值:

"xml": 返回 XML 文檔，可用 jQuery 處理。

"html": 返回純文字 HTML 資訊；包含 script 元素。

"script": 返回純文字 JavaScript 代碼。不會自動緩衝結果。

"json": 返回 JSON 資料 。

"jsonp": JSONP 格式。使用JSONP形式調用函數時，如 "myurl?callback=?" jQuery 將自動替換 ? 為正確的函數名，以執行回呼函數。

11,  error   Function         (預設: 自動判斷 (xml 或 html)) 請求失敗時將調用此方法。這個方法有三個參數：XMLHttpRequest 對象，錯誤資訊，（可能）捕獲的錯誤對象。

function (XMLHttpRequest, textStatus, errorThrown) {  // 通常情況下textStatus和errorThown只有其中一個有值   this; // the options for this ajax request}

12,  global      Boolean    (預設: true) 是否觸發全域 AJAX 事件。設定為 false 將不會觸發全域 AJAX 事件，如 ajaxStart 或 ajaxStop 。可用於控制不同的Ajax事件

13,  ifModified    Boolean      (預設: false) 僅在伺服器資料改變時擷取新資料。使用 HTTP 包 Last-Modified 頭資訊判斷。

14,  processData     Boolean    (預設: true) 預設情況下，發送的資料將被轉換為對象(技術上講並非字串) 以配合預設內容類型 "application/x-www-form-urlencoded"。如果要發送 DOM 樹資訊或其它不希望轉換的資訊，請設定為 false。

15,  success     Function     請求成功後回呼函數。這個方法有兩個參數：伺服器返回資料，返回狀態

function (data, textStatus) {  // data could be xmlDoc, jsonObj, html, text, etc...  this; // the options for this ajax request}

代碼：$(document).ready(function() {
            jQuery("#clearCac").click(function() {
                jQuery.ajax({
                    url: "/Handle/Do.aspx",
                    type: "post",
                    data: { id: '0' },
                    dataType: "json",
                    success: function(msg) {
                        alert(msg);
                    },
                    error: function(XMLHttpRequest, textStatus, errorThrown) {
                        alert(XMLHttpRequest.status);
                        alert(XMLHttpRequest.readyState);
                        alert(textStatus);
                    },
                    complete: function(XMLHttpRequest, textStatus) {
                        this; // 調用本次AJAX請求時傳遞的options參數
                    }
                });
            });
        });

一、error：function (XMLHttpRequest, textStatus, errorThrown)
{
}
(默 認: 自動判斷 (xml 或 html)) 請求失敗時調用時間。參數有以下三個：XMLHttpRequest 對象、錯誤資訊、（可選）捕獲的錯誤對象。如果發生了錯誤，錯誤資訊（第二個參數）除了得到null之外，還可能是"timeout", "error", "notmodified" 和 "parsererror"。

textStatus:

 "timeout", "error", "notmodified" 和 "parsererror"。

二、error事件返回的第一個參數XMLHttpRequest有一些有用的資訊：

XMLHttpRequest.readyState:

狀態代碼 

0 － （未初始化）還沒有調用send()方法 

1 － （載入）已調用send()方法，正在發送請求 

2 － （載入完成）send()方法執行完成，已經接收到全部響應內容 

3 － （互動）正在解析響應內容 

4 － （完成）響應內容解析完成，可以在用戶端調用了

三、data:"{}", data為空白也一定要傳"{}"；不然返回的是xml格式的。並提示parsererror.

四、parsererror的異常和Header 類型也有關係。及編碼header('Content-type: text/html; charset=utf8');

五、XMLHttpRequest.status:
1xx-資訊提示 
這些狀態碼表示臨時的響應。用戶端在收到常規響應之前，應準備接收一個或多個1xx響應。 
100-繼續。 
101-切換協議。 
2xx-成功 
這類狀態碼表明伺服器成功地接受了用戶端請求。 
200-確定。用戶端請求已成功。 
201-已建立。 
202-已接受。 
203-非權威性資訊。 
204-無內容。 
205-重設內容。 
206-部分內容。 
3xx-重新導向 
用戶端瀏覽器必須採取更多操作來實現請求。例如，瀏覽器可能不得不請求伺服器上的不同的頁面，或通過Proxy 伺服器重複該請求。 
301-對象已永久移走，即永久重新導向。 
302-對象已臨時移動。 
304-未修改。 
307-臨時重新導向。 
4xx-用戶端錯誤 
發生錯誤，用戶端似乎有問題。例如，用戶端請求不存在的頁面，用戶端未提供有效身分識別驗證資訊。400-錯誤的請求。 
401-訪問被拒絕。IIS定義了許多不同的401錯誤，它們指明更為具體的錯誤原因。這些具體的錯誤碼在瀏覽器中顯示，但不在IIS日誌中顯示： 
401.1-登入失敗。 
401.2-伺服器配置導致登入失敗。 
401.3-由於ACL對資源的限制而未獲得授權。 
401.4-篩選器授權失敗。 
401.5-ISAPI/CGI應用程式授權失敗。 
401.7–訪問被Web伺服器上的URL授權策略拒絕。這個錯誤碼為IIS6.0所專用。 
403-禁止訪問：IIS定義了許多不同的403錯誤，它們指明更為具體的錯誤原因： 
403.1-執行訪問被禁止。 
403.2-讀訪問被禁止。 
403.3-寫訪問被禁止。 
403.4-要求SSL。 
403.5-要求SSL128。 
403.6-IP地址被拒絕。 
403.7-要求用戶端認證。 
403.8-網站訪問被拒絕。 
403.9-使用者數過多。 
403.10-配置無效。 
403.11-密碼更改。 
403.12-拒絕訪問映射表。 
403.13-用戶端認證被吊銷。 
403.14-拒絕目錄列表。 
403.15-超出用戶端訪問許可。 
403.16-用戶端認證不受信任或無效。 
403.17-用戶端認證已到期或尚未生效。 
403.18-在當前的應用程式集區中不能執行所請求的URL。這個錯誤碼為IIS6.0所專用。 
403.19-不能為這個應用程式集區中的用戶端執行CGI。這個錯誤碼為IIS6.0所專用。 
403.20-Passport登入失敗。這個錯誤碼為IIS6.0所專用。 
404-未找到。 
404.0-（無）–沒有找到檔案或目錄。 
404.1-無法在所請求的連接埠上訪問Web網站。 
404.2-Web服務擴充鎖定策略阻止本請求。 
404.3-MIME映射策略阻止本請求。 
405-用來訪問本頁面的HTTP謂詞不被允許（方法不被允許） 
406-用戶端瀏覽器不接受所請求頁面的MIME類型。 
407-要求進行Proxy 驗證。 
412-前提條件失敗。 
413–請求實體太大。 
414-請求URI太長。 
415–不支援的媒體類型。 
416–所請求的範圍無法滿足。 
417–執行失敗。 
423–鎖定的錯誤。 
5xx-伺服器錯誤 
伺服器由於遇到錯誤而不能完成該請求。 
500-內部伺服器錯誤。 
500.12-應用程式正忙於在Web伺服器上重新啟動。 
500.13-Web伺服器太忙。 
500.15-不允許直接請求Global.asa。 
500.16–UNC授權憑據不正確。這個錯誤碼為IIS6.0所專用。 
500.18–URL授權存放區不能開啟。這個錯誤碼為IIS6.0所專用。 
500.100-內部ASP錯誤。 
501-頁首值指定了未實現的配置。 
502-Web伺服器用作網關或Proxy 伺服器時收到了無效響應。 
502.1-CGI應用程式逾時。 
502.2-CGI應用程式出錯。application. 
503-服務不可用。這個錯誤碼為IIS6.0所專用。 
504-網關逾時。 
505-HTTP版本不受支援。 
FTP 
1xx-肯定的初步回覆 
這些狀態碼指示一項操作已經成功開始，但用戶端希望在繼續操作新命令前得到另一個回覆。 
110重新啟動標記回覆。 
120服務已就緒，在nnn分鐘後開始。 
125資料連線已開啟，正在開始傳輸。 
150檔案狀態正常，準備開啟資料連線。 
2xx-肯定的完成回覆 
一項操作已經成功完成。用戶端可以執行新命令。200命令確定。 
202未執行命令，網站上的命令過多。 
211系統狀態，或系統協助回覆。 
212目錄狀態。 
213檔案狀態。 
214協助訊息。 
215NAME系統類別型，其中，NAME是AssignedNumbers文檔中所列的正式系統名稱。 
220服務就緒，可以執行新使用者的請求。 
221服務關閉控制串連。如果適當，請登出。 
225資料連線開啟，沒有進行中的傳輸。 
226關閉資料連線。請求的檔案操作已成功（例如，傳輸檔案或放棄檔案）。 
227進入被動模式(h1,h2,h3,h4,p1,p2)。 
230使用者已登入，繼續進行。 
250請求的檔案操作正確，已完成。 
257已建立“PATHNAME”。 
3xx-肯定的中間回覆 
該命令已成功，但伺服器需要更多來自用戶端的資訊以完成對請求的處理。331使用者名稱正確，要求輸入密碼。 
332需要登入帳戶。 
350請求的檔案操作正在等待進一步的資訊。 
4xx-瞬態否定的完成回覆 
該命令不成功，但錯誤是暫時的。如果用戶端重試命令，可能會執行成功。421服務不可用，正在關閉控制串連。如果服務確定它必須關閉，將向任何命令發送這一應答。 
425無法開啟資料連線。 
426Connectionclosed;transferaborted. 
450未執行請求的檔案操作。檔案不可用（例如，檔案繁忙）。 
451請求的操作異常終止：正在處理本地錯誤。 
452未執行請求的操作。系統儲存空間不夠。 
5xx-永久性否定的完成回覆 
該命令不成功，錯誤是永久性的。如果用戶端重試命令，將再次出現同樣的錯誤。500語法錯誤，命令無法識別。這可能包括諸如命令列太長之類的錯誤。 
501在參數中有語法錯誤。 
502未執行命令。 
503錯誤的命令序列。 
504未執行該參數的命令。 
530未登入。 
532隱藏檔需要帳戶。 
550未執行請求的操作。檔案不可用（例如，未找到檔案，沒有存取權限）。 
551請求的操作異常終止：未知的頁面類型。 
552請求的檔案操作異常終止：超出儲存分配（對於目前的目錄或資料集）。 
553未執行請求的操作。不允許的檔案名稱。 
常見的FTP狀態碼及其原因 
150-FTP使用兩個連接埠：21用於發送命令，20用於發送資料。狀態碼150表示伺服器準備在連接埠20上開啟新串連，發送一些資料。 
226-命令在連接埠20上開啟資料連線以執行操作，如傳輸檔案。該操作成功完成，資料連線已關閉。 
230-用戶端發送正確的密碼後，顯示該狀態碼。它表示使用者已成功登入。 
331-用戶端發送使用者名稱後，顯示該狀態碼。無論所提供的使用者名稱是否為系統中的有效帳戶，都將顯示該狀態碼。 
426-命令開啟資料連線以執行操作，但該操作已被取消，資料連線已關閉。 
530-該狀態碼表示使用者無法登入，因為使用者名稱和密碼組合無效。如果使用某個使用者帳戶登入，可能鍵入錯誤的使用者名稱或密碼，也可能選擇只允許匿名訪問。如果使用匿名帳戶登入，IIS的配置可能拒絕匿名訪問。 
550-命令未被執行，因為指定的檔案不可用。例如，要GET的檔案並不存在，或試圖將檔案PUT到您沒有寫入許可權的目錄。