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.