1、簡介
AJAX 是與服務器交換數據的技術,它在不重載所有頁面的狀況下,實現了對部分網頁的更新。html
ajax() 方法經過 HTTP 請求加載遠程數據。前端
該方法是 jQuery 底層 AJAX 實現。簡單易用的高層實現見 $.get, $.post 等。$.ajax() 返回其建立的 XMLHttpRequest 對象。大多數狀況下你無需直接操做該函數,除非你須要操做不經常使用的選項,以得到更多的靈活性。java
最簡單的狀況下,$.ajax() 能夠不帶任何參數直接使用。ajax
注意:全部的選項均可以經過 $.ajaxSetup() 函數來全局設置。json
jQuery.ajax([settings])
參數 | 描述 |
---|---|
settings | 可選。用於配置 Ajax 請求的鍵值對集合。跨域 能夠經過 $.ajaxSetup() 設置任何選項的默認值。數組 |
類型:Object瀏覽器
可選。AJAX 請求設置。全部選項都是可選的。緩存
類型:Boolean服務器
默認值: true。默認設置下,全部請求均爲異步請求。若是須要發送同步請求,請將此選項設置爲 false。
注意,同步請求將鎖住瀏覽器,用戶其它操做必須等待請求完成才能夠執行。
類型:Function
發送請求前可修改 XMLHttpRequest 對象的函數,如添加自定義 HTTP 頭。
XMLHttpRequest 對象是惟一的參數。
這是一個 Ajax 事件。若是返回 false 能夠取消本次 ajax 請求。
類型:Boolean
默認值: true,dataType 爲 script 和 jsonp 時默認爲 false。設置爲 false 將不緩存此頁面。
jQuery 1.2 新功能。
類型:Function
請求完成後回調函數 (請求成功或失敗以後均調用)。
參數: XMLHttpRequest 對象和一個描述請求類型的字符串。
這是一個 Ajax 事件。
類型:String
默認值: "application/x-www-form-urlencoded"。發送信息至服務器時內容編碼類型。
默認值適合大多數狀況。若是你明確地傳遞了一個 content-type 給 $.ajax() 那麼它一定會發送給服務器(即便沒有數據要發送)。
類型:Object
這個對象用於設置 Ajax 相關回調函數的上下文。也就是說,讓回調函數內 this 指向這個對象(若是不設定這個參數,那麼 this 就指向調用本次 AJAX 請求時傳遞的 options 參數)。好比指定一個 DOM 元素做爲 context 參數,這樣就設置了 success 回調函數的上下文爲這個 DOM 元素。
就像這樣:
$.ajax({ url: "test.html", context: document.body, success: function(){ $(this).addClass("done"); }});
類型:String
發送到服務器的數據。將自動轉換爲請求字符串格式。GET 請求中將附加在 URL 後。查看 processData 選項說明以禁止此自動轉換。必須爲 Key/Value 格式。若是爲數組,jQuery 將自動爲不一樣值對應同一個名稱。如 {foo:["bar1", "bar2"]} 轉換爲 '&foo=bar1&foo=bar2'。
類型:Function
給 Ajax 返回的原始數據的進行預處理的函數。提供 data 和 type 兩個參數:data 是 Ajax 返回的原始數據,type 是調用 jQuery.ajax 時提供的 dataType 參數。函數返回的值將由 jQuery 進一步處理。
類型:String
預期服務器返回的數據類型。若是不指定,jQuery 將自動根據 HTTP 包 MIME 信息來智能判斷,好比 XML MIME 類型就被識別爲 XML。在 1.4 中,JSON 就會生成一個 JavaScript 對象,而 script 則會執行這個腳本。隨後服務器端返回的數據會根據這個值解析後,傳遞給回調函數。可用值:
類型:Function
默認值: 自動判斷 (xml 或 html)。請求失敗時調用此函數。
有如下三個參數:XMLHttpRequest 對象、錯誤信息、(可選)捕獲的異常對象。
若是發生了錯誤,錯誤信息(第二個參數)除了獲得 null 以外,還多是 "timeout", "error", "notmodified" 和 "parsererror"。
這是一個 Ajax 事件。
類型:Boolean
是否觸發全局 AJAX 事件。默認值: true。設置爲 false 將不會觸發全局 AJAX 事件,如 ajaxStart 或 ajaxStop 可用於控制不一樣的 Ajax 事件。
類型:Boolean
僅在服務器數據改變時獲取新數據。默認值: false。使用 HTTP 包 Last-Modified 頭信息判斷。在 jQuery 1.4 中,它也會檢查服務器指定的 'etag' 來肯定數據沒有被修改過。
類型:String
在一個 jsonp 請求中重寫回調函數的名字。這個值用來替代在 "callback=?" 這種 GET 或 POST 請求中 URL 參數裏的 "callback" 部分,好比 {jsonp:'onJsonPLoad'} 會致使將 "onJsonPLoad=?" 傳給服務器。
類型:String
爲 jsonp 請求指定一個回調函數名。這個值將用來取代 jQuery 自動生成的隨機函數名。這主要用來讓 jQuery 生成度獨特的函數名,這樣管理請求更容易,也能方便地提供回調函數和錯誤處理。你也能夠在想讓瀏覽器緩存 GET 請求的時候,指定這個回調函數名。
類型:String
用於響應 HTTP 訪問認證請求的密碼
類型:Boolean
默認值: true。默認狀況下,經過data選項傳遞進來的數據,若是是一個對象(技術上講只要不是字符串),都會處理轉化成一個查詢字符串,以配合默認內容類型 "application/x-www-form-urlencoded"。若是要發送 DOM 樹信息或其它不但願轉換的信息,請設置爲 false。
類型:String
只有當請求時 dataType 爲 "jsonp" 或 "script",而且 type 是 "GET" 纔會用於強制修改 charset。一般只在本地和遠程的內容編碼不一樣時使用。
類型:Function
請求成功後的回調函數。
參數:由服務器返回,並根據 dataType 參數進行處理後的數據;描述狀態的字符串。
這是一個 Ajax 事件。
類型:Boolean
若是你想要用傳統的方式來序列化數據,那麼就設置爲 true。請參考工具分類下面的 jQuery.param 方法。
類型:Number
設置請求超時時間(毫秒)。此設置將覆蓋全局設置。
類型:String
默認值: "GET")。請求方式 ("POST" 或 "GET"), 默認爲 "GET"。注意:其它 HTTP 請求方法,如 PUT 和 DELETE 也可使用,但僅部分瀏覽器支持。
類型:String
默認值: 當前頁地址。發送請求的地址。
類型:String
用於響應 HTTP 訪問認證請求的用戶名。
類型:Function
須要返回一個 XMLHttpRequest 對象。默認在 IE 下是 ActiveXObject 而其餘狀況下是 XMLHttpRequest 。用於重寫或者提供一個加強的 XMLHttpRequest 對象。這個參數在 jQuery 1.3 之前不可用。
若是要處理 $.ajax() 獲得的數據,則須要使用回調函數:beforeSend、error、dataFilter、success、complete。
在發送請求以前調用,而且傳入一個 XMLHttpRequest 做爲參數。
在請求出錯時調用。傳入 XMLHttpRequest 對象,描述錯誤類型的字符串以及一個異常對象(若是有的話)
在請求成功以後調用。傳入返回的數據以及 "dataType" 參數的值。而且必須返回新的數據(多是處理過的)傳遞給 success 回調函數。
當請求以後調用。傳入返回後的數據,以及包含成功代碼的字符串。
當請求完成以後調用這個函數,不管成功或失敗。傳入 XMLHttpRequest 對象,以及一個包含成功或錯誤代碼的字符串。
$.ajax() 函數依賴服務器提供的信息來處理返回的數據。若是服務器報告說返回的數據是 XML,那麼返回的結果就能夠用普通的 XML 方法或者 jQuery 的選擇器來遍歷。若是見獲得其餘類型,好比 HTML,則數據就以文本形式來對待。
經過 dataType 選項還能夠指定其餘不一樣數據處理方式。除了單純的 XML,還能夠指定 html、json、jsonp、script 或者 text。
其中,text 和 xml 類型返回的數據不會通過處理。數據僅僅簡單的將 XMLHttpRequest 的 responseText 或 responseHTML 屬性傳遞給 success 回調函數。
注意:咱們必須確保網頁服務器報告的 MIME 類型與咱們選擇的 dataType 所匹配。好比說,XML的話,服務器端就必須聲明 text/xml 或者 application/xml 來得到一致的結果。
若是指定爲 html 類型,任何內嵌的 JavaScript 都會在 HTML 做爲一個字符串返回以前執行。相似地,指定 script 類型的話,也會先執行服務器端生成 JavaScript,而後再把腳本做爲一個文本數據返回。
若是指定爲 json 類型,則會把獲取到的數據做爲一個 JavaScript 對象來解析,而且把構建好的對象做爲結果返回。爲了實現這個目的,它首先嚐試使用 JSON.parse()。若是瀏覽器不支持,則使用一個函數來構建。
JSON 數據是一種能很方便經過 JavaScript 解析的結構化數據。若是獲取的數據文件存放在遠程服務器上(域名不一樣,也就是跨域獲取數據),則須要使用 jsonp 類型。使用這種類型的話,會建立一個查詢字符串參數 callback=? ,這個參數會加在請求的 URL 後面。服務器端應當在 JSON 數據前加上回調函數名,以便完成一個有效的 JSONP 請求。若是要指定回調函數的參數名來取代默認的 callback,能夠經過設置 $.ajax() 的 jsonp 參數。
注意:JSONP 是 JSON 格式的擴展。它要求一些服務器端的代碼來檢測並處理查詢字符串參數。
若是指定了 script 或者 jsonp 類型,那麼當從服務器接收到數據時,其實是用了 <script> 標籤而不是 XMLHttpRequest 對象。這種狀況下,$.ajax() 再也不返回一個 XMLHttpRequest 對象,而且也不會傳遞事件處理函數,好比 beforeSend。
2、例子
1)前臺js代碼
function getUserAuthority(){ $.ajax({ url : 'authorityAction!getAuthority.action', type : 'POST', dataType : 'json', timeout : 30000,//超時時間設定 data : { "userType" : userType }, complete : function(XMLHttpRequest, textStatus) { //內存回收,下降內存泄露 try { XMLHttpRequest.onreadystatechange = null; XMLHttpRequest.abort = null; XMLHttpRequest = null; CollectGarbage(); } catch (e) { } }, error : function(xhr, textStatus, thrownError) { }, success : function(response) { if(response.result=="ok"){ authorityList = response.data.list; //渲染 showTable(); }else{ console.log("獲取userType="+userType+"的全部權限列表失敗"); } } }); }
2)後臺java代碼
爲了可以實現瀏覽器跨域訪問,只須要在後臺接口裏加上一下這幾行代碼
HttpServletResponse response = ServletActionContext.getResponse(); response.setHeader("Access-Control-Allow-Origin", "*"); response.setHeader("Access-Control-Allow-Methods", "GET,POST");
// 獲取管理員或操做員全部權限列表 public String getAuthority() { HttpServletResponse response = ServletActionContext.getResponse(); response.setHeader("Access-Control-Allow-Origin", "*"); response.setHeader("Access-Control-Allow-Methods", "GET,POST"); result.clear(); logger.info("接收到根據用戶類型userType=" + userType + "獲取全部權限列表請求"); result.setResult(JsonResult.OK); try { String authorityLevel = ""; if (userType == 0) { authorityLevel = "administrator"; } else if (userType == 1) { authorityLevel = "operator"; } else { logger.info("用戶類型錯誤"); result.setResult(JsonResult.FAIL); return SUCCESS; } List<NavigationItem> list = authorityService.getAuthorityByUserType(authorityLevel); result.addData("list", list); logger.info("根據用戶類型userType=" + userType + "獲取全部權限列表成功"); } catch (Exception e) { e.printStackTrace(); logger.error("根據用戶類型userType=" + userType + "獲取全部權限列表失敗!", e); } return SUCCESS; }
免費獲取Java及前端學習視頻資料: