ajax---Asynchronous JavaScript And XML-------異步JavaScript和XML-------(萬一你不知道這幾個字符啥意思呢)

var stream = {
id: $("#streamId").val(),
title: "" == $("#stream_title").val().trim() ? null : $("#stream_title").val().trim(),
disabled: !$("#stream_disabled").prop("checked"),
topoIds: $("#topoIds").val(),
streamrules: streamrule_datas,
};

$.ajax({

url: APP_NAME + "streams/saveStreamrules",
type: "post",
contentType: "application/json; charset=utf-8",
data: JSON.stringify(stream),
dataType: "json",
success: function (data) {
if (data.success) {
loadStreamrules();
resetAddStreamrule();
GMS.success(data.msg);
} else {
GMS.error(data.msg);
}
}
});

標紅色的都是灰常常用的參數，其他的可能萬年難得一見的東西，看一下知道或者了解就可以啦。

1.url

要求為String類型的參數，（默認為當前頁地址）發送請求的地址。

就是在此發送需求到對應的後臺去處理，後臺根據這個url來區別不同的請求。

2.type:

要求為String類型的參數，請求方式（post或get）默認為get。註意其他http請求方法，例如put和delete也可以使用，但僅部分瀏覽器支持。

post：瀏覽器把各表單字段元素及其數據作為HTTP消息的實體內容發送給Web服務器，數據量要比使用GET方式傳送的數據量大的多，安全。

get：get方式可傳送簡單數據，有大小限制，數據追加到url中發送（http的header傳送）,url可以被客戶端緩存，從瀏覽器的歷史記錄中得到客戶數據，不安全。

3.timeout:
要求為Number類型的參數，設置請求超時時間（毫秒）。此設置將覆蓋$.ajaxSetup()方法的全局設置。


4.async:

要求為Boolean類型的參數，默認設置為true，所有請求均為異步請求。如果需要發送同步請求，請將此選項設置為false。註意，同步請求將鎖住瀏覽器，用戶其他操作必須等待請求完成才可以執行。

這裏就會經常發生問題，就是異步了，所以有時候你會不小心，在請求還沒成功，你就以為你成功了，然後再幹其他事，就容易出問題，所以，一般要在success回調函數裏面做一些事。

5.cache:
要求為Boolean類型的參數，默認為true（當dataType為script時，默認為false），設置為false將不會從瀏覽器緩存中加載請求信息。


6.data:

發送到服務器的數據，要求為Object或String類型的參數。如果已經不是字符串，將自動轉換為字符串格式。get請求中將附加在url後。防止這種自動轉換，可以查看　　processData選項。對象必須為key/value格式，例如{foo1:"bar1",foo2:"bar2"}轉換為&foo1=bar1&foo2=bar2。如果是數組，jQuery將自動為不同值對應同一個名稱。例如{foo:["bar1","bar2"]}轉換為&foo=bar1&foo=bar2。

上面的例子中，就是把一個javascript對象給變成json然後傳到後臺去處理

7.dataType:
要求為String類型的參數，預期服務器返回的數據類型。如果不指定，JQuery將自動根據http包mime信息返回responseXML或responseText，並作為回調函數參數傳遞。可用的類型如下：
xml：返回XML文檔，可用JQuery處理。
html：返回純文本HTML信息；包含的script標簽會在插入DOM時執行。
script：返回純文本JavaScript代碼。不會自動緩存結果。除非設置了cache參數。註意在遠程請求時（不在同一個域下），所有post請求都將轉為get請求。

json：返回JSON數據。起碼我見到都是返回json類型。其他的沒見用過。後臺可以處理完之後返回一個bean的對象，然後將對象轉換成json字符串形式的對象，就跟之最上面的例子中的stream對象一樣，可以方便的操作各個屬性，然後在前臺操作的時候就灰常的方便。。。一句話概括：如果指定為json類型，則會把獲取到的數據作為一個JavaScript對象來解析，並且把構建好的對象作為結果返回。

jsonp：JSONP格式。使用SONP形式調用函數時，例如myurl?callback=?，JQuery將自動替換後一個“?”為正確的函數名，以執行回調函數。
text：返回純文本字符串。


8.beforeSend：
要求為Function類型的參數，發送請求前可以修改XMLHttpRequest對象的函數，例如添加自定義HTTP頭。在beforeSend中如果返回false可以取消本次ajax請求。XMLHttpRequest對象是惟一的參數。
function(XMLHttpRequest){
this; //調用本次ajax請求時傳遞的options參數

}

9.complete：
要求為Function類型的參數，請求完成後調用的回調函數（請求成功或失敗時均調用）。參數：XMLHttpRequest對象和一個描述成功請求類型的字符串。
function(XMLHttpRequest, textStatus){
this; //調用本次ajax請求時傳遞的options參數
}

10.success：

要求為Function類型的參數，請求成功後調用的回調函數，有兩個參數。

(1)由服務器返回，並根據dataType參數進行處理後的數據。
(2)描述狀態的字符串。
function(data, textStatus){
//data可能是xmlDoc、jsonObj、html、text等等
this; //調用本次ajax請求時傳遞的options參數
}

例子中的data就是後臺處理之後，返回的一個javascript對象，裏面包含前臺需要的各種信息，需要什麽塞什麽。

一般都是只用第一個參數，第二個基本沒見過。

這個才是灰常常用的一個參數。

11.error:
要求為Function類型的參數，請求失敗時被調用的函數。該函數有3個參數，即XMLHttpRequest對象、錯誤信息、捕獲的錯誤對象(可選)。ajax事件函數如下：
function(XMLHttpRequest, textStatus, errorThrown){
//通常情況下textStatus和errorThrown只有其中一個包含信息
this; //調用本次ajax請求時傳遞的options參數
}


12.contentType：

要求為String類型的參數，當發送信息至服務器時，內容編碼類型默認為"application/x-www-form-urlencoded"。該默認值適合大多數應用場合。

multipart/form-data：有時候也會這個，上傳下載可能會用到。

contentType: "application/json; charset=utf-8",

我想現在json這麽簡單易用，估計一般這個類型也很常用吧。

13.dataFilter：

要求為Function類型的參數，給Ajax返回的原始數據進行預處理的函數。提供data和type兩個參數。data是Ajax返回的原始數據，type是調用jQuery.ajax時提供的dataType參數。函數返回的值將由jQuery進一步處理。
function(data, type){
//返回處理後的數據
return data;
}


14.global：
要求為Boolean類型的參數，默認為true。表示是否觸發全局ajax事件。設置為false將不會觸發全局ajax事件，ajaxStart或ajaxStop可用於控制各種ajax事件。


15.ifModified：
要求為Boolean類型的參數，默認為false。僅在服務器數據改變時獲取新數據。服務器數據改變判斷的依據是Last-Modified頭信息。默認值是false，即忽略頭信息。


16.jsonp：
要求為String類型的參數，在一個jsonp請求中重寫回調函數的名字。該值用來替代在"callback=?"這種GET或POST請求中URL參數裏的"callback"部分，例如{jsonp:‘onJsonPLoad‘}會導致將"onJsonPLoad=?"傳給服務器。


17.username：
要求為String類型的參數，用於響應HTTP訪問認證請求的用戶名。


18.password：
要求為String類型的參數，用於響應HTTP訪問認證請求的密碼。


19.processData：
要求為Boolean類型的參數，默認為true。默認情況下，發送的數據將被轉換為對象（從技術角度來講並非字符串）以配合默認內容類型"application/x-www-form-urlencoded"。如果要發送DOM樹信息或者其他不希望轉換的信息，請設置為false。


20.scriptCharset：

要求為String類型的參數，只有當請求時dataType為"jsonp"或者"script"，並且type是GET時才會用於強制修改字符集(charset)。通常在本地和遠程的內容編碼不同時使用。

【轉】$.ajax({});的各個參數的理解