jQuery学习笔记（Ajax）

jQuery对Ajax操作进行了封装，在jQuery中$.ajax方法属于最底层的方法，第2层是$.load()、$.get()、$.post()方法，第3层是$.getScript()和$.getJSON()方法。

1. $.load(url [,data] [,callback])方法，载入HTML文档

- url (String) : 请求HTML页面的URL地址
- data (Object) : (可选) 发送至服务器的 key/value 对
- callback (Function) : (可选) 请求完成时的回调函数（成功、失败都调用）

简单示范：

$(function(){
$("#send").click(function(){
$("#resText").load("test.html");
})
})

同时，load()方法可以筛选载入的HTML文档，URL参数语法结构为：“url selector“。示范：

$(function(){
$("#send").click(function(){
$("#resText").load("http://www.cnblogs.com/nayitian/archive/2013/01/18/2866667.html .post");
})
})

load()方法的传递方式根据参数data自动指定。如果没有参数传递，则采用get方式传递；反之，则会自动转换为post方式。

回调函数必须在加载完成后才能继续操作。示范如下：

$(function(){
$("#send").click(function(){
$("#resText").load("test.html .para",function (responseText, textStatus, XMLHttpRequest){
alert( $(this).html() );    //在这里this指向的是当前的DOM对象，即 $("#iptText")[0]
alert(responseText);       //请求返回的内容
alert(textStatus);            //请求状态：success，error
alert(XMLHttpRequest);     //XMLHttpRequest对象
});
})
})

2. $.get(url [,data] [,callback] [,type])方法

- url (String) : 请求HTML页面的URL地址
- data (Object) : (可选) 发送至服务器的 key/value 对，作为QueryString附加到请求URL中
- callback (Function) : (可选)载入成功时回调函数（只有当Reponse的返回状态是success才调用），自动将请求结果和状态传递给该方法
- type (String) : (可选) 服务器端返回内容的格式，包括：xml/html/script/json/text/_default

2.1 示范一，返回HTML格式的数据（后台代码略）

$(function(){
$("#send").click(function(){
$.get("get1.jsp", {
username :  encodeURI( $("#username").val() ) ,
content :   encodeURI( $("#content").val() )
}, function (data, textStatus){
$("#resText").html(  decodeURI(data) ); // 把返回的数据添加到页面上
}
);
})
})

2.2 示范二，返回XML格式数据

调用页面：

$(function(){
$("#send").click(function(){
$.get("get2.jsp", {
username :  encodeURI( $("#username").val() ) ,
content :   encodeURI( $("#content").val() )
}, function (data, textStatus){
var username = $(data).find("comment").attr("username");
var content = $(data).find("comment content").text();
username =  decodeURI(username);
content = decodeURI(content);
var txtHtml = "<div class='comment'><h6>"+username+":</h6><p class='para'>"+content+"</p></div>";
$("#resText").html(txtHtml); // 把返回的数据添加到页面上
});
})
})

后台JSP页面（注意最好别留换行符，否则前台可能不能正常解析）：

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%><%
String username = request.getParameter("username");
String content = request.getParameter("content");
response.setContentType("text/xml");
out.println("<?xml version='1.0' encoding='UTF-8'?>");
out.println("<comments>");
out.println("<comment username='"+username+"'>");
out.println("<content>"+content+"</content>");
out.println("</comment>");
out.println("</comments>");
%>

2.3 示范三，返回JSON格式数据

调用页面：

$(function(){
$("#send").click(function(){
$.get("get3.jsp", {
username :  encodeURI( $("#username").val() ) ,
content :   encodeURI( $("#content").val() )
}, function (data, textStatus){
var username = data.username;
var content = data.content;
username =  decodeURI(username);
content = decodeURI(content);
var txtHtml = "<div class='comment'><h6>"+username+":</h6><p class='para'>"+content+"</p></div>";
$("#resText").html(txtHtml); // 把返回的数据添加到页面上
},"json");
})
})

后台JSP页面（JSON串必须用双引号，不打引号或用单引号都有问题）：

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%><%
String username = request.getParameter("username");
String content = request.getParameter("content");
// 必须用双引号，不打引号或用单引号都有问题
out.println("{\"username\":\""+username+"\",\"content\":\""+content+"\"}");
%>

3. $.post(url [,data] [,callback] [,type])方法

它与$.get()方法的结构和使用方式都相同，存在如下区别：

get请求会将参数紧跟在URL后进行传递，而post请求则是作为HTTP消息的实体内容发送给Web服务器。

get方式对传输在数据有大小限制（通常不以大于2kb），而使用post方式传递数据理论上不受限制。

get方式请求的数据会被游览器缓存起来，有可能带来安全性问题，而post不存在此问题。

get与post服务器端获取也有些差别（用request获取例外）。

4. $.getScript()方法与$.getJSON()方法

jQuery提供了$.getScript()方法来直接加载.js文件，与加载一个HTML片段一样简单方便，并且不需要对JavaScript进行处理，JavaScript文件会自动执行。

jQuery 1.2版本之前，getScript()只能调用同域 JS文件。 1.2之后，可以跨域调用JavaScript文件。

$(function(){
$('#send').click(function() {
$.getScript('test.js');
});
})

$.getJSON()方法用于加载JSON文件，与$.getScript()方法的用法相同。

$(function(){
$('#send').click(function() {
$.getJSON('test.json', function(data) {
$('#resText').empty();
var html = '';
$.each( data  , function(commentIndex, comment) {
html += '<div class="comment"><h6>' + comment['username'] + ':</h6><p class="para">' + comment['content'] + '</p></div>';
})
$('#resText').html(html);
})
})
})

5. $.ajax()方法

$.ajax()方法是jQuery最底层的Ajax实现，结构：$.ajax(options)，该方法只有一个参数，但在这个对象里包含了$.ajax()方法所需要的请求设置以及回调函数等信息，参数以key/value的形式存在 ，所有参数都是可选的。

前面用到的$.load()、$.get()、$.post()、$.getScript()、$.getJSON()这些方法，都是基于$.ajax()方法构建的。

常用参数如下表：

参数名	类型	描述
url	String	(默认: 当前页地址) 发送请求的地址。
type	String	请求方式 ("POST" 或 "GET")， 默认为 "GET"。注意：其它 HTTP 请求方法，如 PUT 和 Delete 也可以使用，但仅部分浏览器支持。
timeout	Number	设置请求超时时间（毫秒）。此设置将覆盖全局设置。
async	Boolean	(默认: true) 默认设置下，所有请求均为异步请求。如果需要发送同步请求，请将此选项设置为 false。注意，同步请求将锁住浏览器，用户其它操作必须等待请求完成才可以执行。
beforeSend	Function	发送请求前可修改 XMLHttpRequest 对象的函数，如添加自定义 HTTP 头。XMLHttpRequest 对象是唯一的参数。 function (XMLHttpRequest) { this; // 调用本次Ajax请求时传递的options参数 }
cache	Boolean	(默认: true) jQuery 1.2 新功能，设置为 false 将不会从浏览器缓存中加载请求信息。
complete	Function	请求完成后回调函数 (请求成功或失败时均调用)。参数： XMLHttpRequest 对象，成功信息字符串。 function (XMLHttpRequest, textStatus) { this; // 调用本次Ajax请求时传递的options参数 }
contentType	String	(默认: "application/x-www-form-urlencoded") 发送信息至服务器时内容编码类型。默认值适合大多数应用场合。
data	Object, String	发送到服务器的数据。将自动转换为请求字符串格式。GET 请求中将附加在 URL 后。查看 processData 选项说明以禁止此自动转换。必须为 Key/Value 格式。如果为数组，jQuery 将自动为不同值对应同一个名称。如 {foo:["bar1", "bar2"]} 转换为 '&foo=bar1&foo=bar2'。
dataType	String	预期服务器返回的数据类型。如果不指定，jQuery 将自动根据 HTTP 包 MIME 信息返回 responseXML 或 responseText，并作为回调函数参数传递，可用值: "xml": 返回 XML 文档，可用 jQuery 处理。 "html": 返回纯文本 HTML 信息；包含 script 元素。 "script": 返回纯文本 JavaScript 代码。不会自动缓存结果。 "json": 返回 JSON 数据 。 "jsonp": JSONP 格式。使用 JSONP 形式调用函数时，如 "myurl?callback=?" jQuery 将自动替换 ? 为正确的函数名，以执行回调函数。
error	Function	(默认: 自动判断 (xml 或 html)) 请求失败时将调用此方法。这个方法有三个参数：XMLHttpRequest 对象，错误信息，（可能）捕获的错误对象。 function (XMLHttpRequest, textStatus, errorThrown) { // 通常情况下textStatus和errorThown只有其中一个有值 this; //调用本次Ajax请求时传递的options参数 }
global	Boolean	(默认: true) 是否触发全局 AJAX 事件。设置为 false 将不会触发全局 AJAX 事件，如 ajaxStart 或 ajaxStop 。可用于控制不同的Ajax事件
ifModified	Boolean	(默认: false) 仅在服务器数据改变时获取新数据。使用 HTTP 包 Last-Modified 头信息判断。
processData	Boolean	(默认: true) 默认情况下，发送的数据将被转换为对象(技术上讲并非字符串) 以配合默认内容类型 "application/x-www-form-urlencoded"。如果要发送 DOM 树信息或其它不希望转换的信息，请设置为 false。
success	Function	请求成功后回调函数。这个方法有两个参数：服务器返回数据，返回状态 function (data, textStatus) { // data could be xmlDoc, jsonObj, html, text, etc... this; // 调用本次Ajax请求时传递的options参数 }

5.1 下述代码取代$.getScript()方法

$(function(){
$('#send').click(function() {
$.ajax({
type: "GET",
url: "test.js",
dataType: "script"
});
});
})

5.2 下述代码取代$.getJSON()方法

$(function(){
$('#send').click(function() {
$.ajax({
type: "GET",
url: "test.json",
dataType: "json",
success : function(data){
$('#resText').empty();
var html = '';
$.each( data  , function(commentIndex, comment) {
html += '<div class="comment"><h6>' + comment['username'] + ':</h6><p class="para">' + comment['content'] + '</p></div>';
})
$('#resText').html(html);
}
});
});
})

5.3 跨域调用示范

$(function(){
$('#send').click(function() {
$.ajax({
type: "GET",
url: "http://api.flickr.com/services/feeds/photos_public.gne?tags=car&tagmode=any&format=json&jsoncallback=?",
dataType: "jsonp",
success : function(data){
$.each(data.items, function( i,item ){
$("<img class='para'/> ").attr("src", item.media.m ).appendTo("#resText");
if ( i == 3 ) {
return false;
}
});
}
});
});
})

6. serialize()方法、serializeArray()方法、param()方法

6.1 serialize()方法

serialize()方法能够将DOM元素内容序列化为字符串，用于Ajax请求，此方法还可以自动编码，以避免编码带来的问题。示范：

$(function(){
$("#send").click(function(){
$.post("get1.jsp", $("#form1").serialize() , function (data, textStatus){
$("#resText").html(data); // 把返回的数据添加到页面上
}
);
})
})

serialize()方法可以表单进行过滤，如：

$(function(){
$("#send").click(function(){
var $data =  $(":checkbox,:radio").serialize();
alert( $data );
})
})

6.2 serializeArray()方法

serializeArray()方法不是返回字符串，而是将DOM对象序列化后，返回JSON格式的数据，示范：

$(function(){
var fields = $(":checkbox,:radio").serializeArray();
console.log(fields);// Firebug输出
$.each( fields, function(i, field){
$("#results").append(field.value + " , ");
});
})

6.3 param()方法

它是serialize()方法的核心，用来对一个数组或对象按照key/value进行序列化。

$(function(){
var obj={a:1,b:2,c:3};
var  k  = $.param(obj);
alert(k)        // 输出  a=1&b=2&c=3
})

7. Ajax事件

jQuery简化Ajax操作不仅体现在调用Ajax方法和处理响应方面，而且还体现在对调用Ajax方法的过程中的HTTP请求的控制。通过jQuery提供的一些自定义全局函数，能够为各种Ajax相关的事件注册回调函数。

在jQuery这里有两种Ajax事件：“局部事件”和“全局事件”。

局部事件就是在每次的Ajax请求时在方法内定义的，比如：

$.ajax({
beforeSend: function(){
// Handle the beforeSend event
},
complete: function(){
// Handle the complete event
}
// ...
});

全局事件是每次的Ajax请求都会触发的，它会向DOM中的所有元素广播，比如，装载一个页面时，在开始装载提示“加载中...“；装载完毕，提示消失；以增加用户体验。示范：

<div id="loading">加载中...</div>

$("#loading").ajaxStart(function(){
$(this).show();
});
$("#loading").ajaxStop(function(){
$(this).hide();
});

我们可以在特定的请求将全局事件禁用，只要设置下 global 选项就可以了：

$.ajax({
url: "test.html",
global: false,// 禁用全局Ajax事件.
// ...
});

下面是jQuery官方给出的完整的Ajax事件列表：

ajaxStart (Global Event) This event is broadcast if an Ajax request is started and no other Ajax requests are currently running.

beforeSend (Local Event) This event, which is triggered before an Ajax request is started, allows you to modify the XMLHttpRequest object (setting additional headers, if need be.)

ajaxSend (Global Event) This global event is also triggered before the request is run.

success (Local Event) This event is only called if the request was successful (no errors from the server, no errors with the data).

ajaxSuccess (Global Event) This event is also only called if the request was successful.

error (Local Event) This event is only called if an error occurred with the request (you can never have both an error and a success callback with a request).

ajaxError (Global Event) This global event behaves the same as the local error event.

complete (Local Event) This event is called regardless of if the request was successful, or not. You will always receive a complete callback, even for synchronous requests.

ajaxComplete (Global Event) This event behaves the same as the complete event and will be triggered every time an Ajax request finishes.

ajaxStop (Global Event) This global event is triggered if there are no more Ajax requests being processed.