Ajax各个参数的说明

Ajax各个参数的说明

1$.ajax({
2     url: "http://www.hzhuti.com",    //请求的url地址
3     dataType: "json",   //返回格式为json
4     async: true, //请求是否异步，默认为异步，这也是ajax重要特性
5     data: { "id": "value" },    //参数值
6     type: "GET",   //请求方式
7     beforeSend: function() {
8         //请求前的处理
9     },
10     success: function(req) {
11         //请求成功时处理
12     },
13     complete: function() {
14         //请求完成的处理
15     },
16     error: function() {
17         //请求出错处理
18     }
19 });

下面是对Ajax中各个参数的说明：

参数名 类型 描述
url String (默认: 当前页地址) 发送请求的地址。
type String (默认: "GET") 请求方式 ("POST" 或 "GET")， 默认为 "GET"。注意：其它 HTTP 请求方法，如 PUT 和 DELETE 也可以使用，但仅部分浏览器支持。
timeout Number 设置请求超时时间（毫秒）。此设置将覆盖全局设置。
async Boolean (默认: true) 默认设置下，所有请求均为异步请求。如果需要发送同步请求，
                    请将此选项设置为 false。注意，同步请求将锁住浏览器，用户其它操作必须等待请求完成才可以执行。
beforeSend Function 发送请求前可修改 XMLHttpRequest 对象的函数，如添加自定义 HTTP 头。XMLHttpRequest 对象是唯一的参数。

1function (XMLHttpRequest) {
2          this; // the options for this ajax request          }
3cache Boolean (默认: true) jQuery 1.2 新功能，设置为 false 将不会从浏览器缓存中加载请求信息。
4complete Function 请求完成后回调函数 (请求成功或失败时均调用)。参数： XMLHttpRequest 对象，成功信息字符串。
5function (XMLHttpRequest, textStatus) {
6          this; // the options for this ajax request          }

contentType String

(默认: "application/x-www-form-urlencoded") 发送信息至服务器时内容编码类型。默认值适合大多数应用场合。告诉服务器从浏览器提交过来的数据格式。

例如：我们提交数据时假如使用了 JSON2.js 中方法 JSON.stringify(obj) 格式化为json字符串后，再默认提交就会报错。这个时候就需要指定提交的内容格式为："application/json"。

data Object,    String 送到服务器的数据。

若data数据类型为JavaScript对象或数 组，Jquery在提交之前自动调用JQuery.param()方法把要发送的数据编码成为"application/x-www-form- urlencoded"格式的数据（即 name=value&name1=value1）；JavaScript对象必须为 Key/Value 格式；如果为数组，jQuery 将自动为不同值对应同一个名称。如 {foo:["bar1", "bar2"]} 转换为 '&foo=bar1&foo=bar2'；

若data数据类型为String类型，则直接默认该数据已经按照"application/x-www-form-urlencoded"格式编码完成，不再转换。

dataType String

预期服务器返回的数据类型。设定HttpHeader中“Accept”域的内容，告诉服务器浏览器可以想要返回的数据格式类型，同时JQuery 也会根据该类型对返回的数据进行处理。如果不指定，jQuery 将自动根据 HTTP 包 MIME 信息返回 responseXML 或 responseText，并作为回调函数参数传递，可用值:

"xml": 返回 XML 文档，可用 jQuery 处理。

"html": 返回纯文本 HTML 信息；包含 script 元素。

"script": 返回纯文本 JavaScript 代码。不会自动缓存结果。

"json": 返回 JSON 数据 。JQuery将返回的字符串格式数据自动转化为Javascript对象，便于直接使用obj.property格式访问。若没有指定该选项，即使返回的是JSON格式的字符串，JQuery也不会自动转换。

"jsonp": JSONP 格式。使用 JSONP 形式调用函数时，如 "myurl?callback=?" jQuery 将自动替换 ? 为正确的函数名，以执行回调函数。

error Function (默认: 自动判断 (xml 或 html)) 请求失败时将调用此方法。这个方法有三个参数：XMLHttpRequest 对象，错误信息，（可能）捕获的错误对象。

function (XMLHttpRequest, textStatus, errorThrown) {

          // 通常情况下textStatus和errorThown只有其中一个有值           this; // the options for this ajax request          }

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; // the options for this ajax request          }

1案例代码：
2$(function(){
3    $('#send').click(function(){
4         $.ajax({
5             type: "GET",
6             url: "test.json",
7             data: {username:$("#username").val(), content:$("#content").val()},
8             dataType: "json",
9             success: function(data){
10                         $('#resText').empty();   //清空resText里面的所有内容
11                         var html = ''; 
12                         $.each(data, function(commentIndex, comment){
13                               html += '<div class="comment"><h6>' + comment['username']
14                                         + ':</h6><p class="para"' + comment['content']
15                                         + '</p></div>';
16                         });
17                         $('#resText').html(html);
18                      }
19         });
20    });
21});
22 
23顺便说一下$.each()函数:
24$.each()函数不同于JQuery对象的each()方法，它是一个全局函数，不操作JQuery对象，而是以一个数组或者对象作为第1个参数，以一个回调函数作为第2个参数。回调函数拥有两个参数：第1个为对象的成员或数组的索引，第2个为对应变量或内容。