jquery Ajax

一、定义和用法

ajax() 方法通过 HTTP 请求加载远程数据。

该方法是 jQuery 底层 AJAX 实现。简单易用的高层实现见 $.get, $.post 等。$.ajax() 返回其创建的 XMLHttpRequest 对象。大多数情况下你无需直接操作该函数，除非你需要操作不常用的选项，以获得更多的灵活性。

最简单的情况下，$.ajax() 可以不带任何参数直接使用。

注意：所有的选项都可以通过 $.ajaxSetup() 函数来全局设置。

语法

1. jQuery.ajax([settings])

复制代码

参数	描述
settings	可选。用于配置 Ajax 请求的键值对集合。 可以通过 $.ajaxSetup() 设置任何选项的默认值。

参数

url：(string)发送请求的地址，可以是服务器页面也可以是WebService动作。默认值: 当前页地址。

type：(string)请求方式，POST或GET。默认值: "GET"，注意：其它 HTTP 请求方法，如 PUT 和 DELETE 也可以使用，但仅部分浏览器支持。


data：(object)向服务器发送请求时带去的数据。将自动转换为请求字符串格式。GET 请求中将附加在 URL 后。查看 processData 选项说明以禁止此自动转换。必须为 key:value对 格式，如：{name:"grayworm",sex:"male"}，。如果为数组，jQuery 将自动为不同值对应同一个名称。如 {foo:["bar1", "bar2"]} 转换为 '&foo=bar1&foo=bar2'。


dataType：(string)预期返回的数据类型。xml,html,json,text等，如果不指定，jQuery 将自动根据 HTTP 包 MIME 信息来智能判断，比如 XML MIME 类型就被识别为 XML。在 1.4 中，JSON 就会生成一个 JavaScript 对象，而 script 则会执行这个脚本。随后服务器端返回的数据会根据这个值解析后，传递给回调函数。可用值:

• "xml": 返回 XML 文档，可用 jQuery 处理。
• "html": 返回纯文本 HTML 信息；包含的 script 标签会在插入 dom 时执行。
• "script": 返回纯文本 JavaScript 代码。不会自动缓存结果。除非设置了 "cache" 参数。注意：在远程请求时(不在同一个域下)，所有 POST 请求都将转为 GET 请求。（因为将使用 DOM 的 script标签来加载）
• "json": 返回 JSON 数据 。
• "jsonp": JSONP 格式。使用 JSONP 形式调用函数时，如 "myurl?callback=?" jQuery 将自动替换 ? 为正确的函数名，以执行回调函数。
• "text": 返回纯文本字符串
  

dataFilter类型：Function

给 Ajax 返回的原始数据的进行预处理的函数。提供 data 和 type 两个参数：data 是 Ajax 返回的原始数据，type 是调用 jQuery.ajax 时提供的 dataType 参数。函数返回的值将由 jQuery 进一步处理。

error
类型：Function

默认值: 自动判断 (xml 或 html)。请求失败时调用此函数。

有以下三个参数：XMLHttpRequest 对象、错误信息、（可选）捕获的异常对象。

如果发生了错误，错误信息（第二个参数）除了得到 null 之外，还可能是 "timeout", "error", "notmodified" 和 "parsererror"。

这是一个 Ajax 事件。

global
类型：Boolean

是否触发全局 AJAX 事件。默认值: true。设置为 false 将不会触发全局 AJAX 事件，如 ajaxStart 或 ajaxStop 可用于控制不同的 Ajax 事件。

ifModified
类型：Boolean

仅在服务器数据改变时获取新数据。默认值: false。使用 HTTP 包 Last-Modified 头信息判断。在 jQuery 1.4 中，它也会检查服务器指定的 'etag' 来确定数据没有被修改过。

jsonp
类型：String

在一个 jsonp 请求中重写回调函数的名字。这个值用来替代在 "callback=?" 这种 GET 或 POST 请求中 URL 参数里的 "callback" 部分，比如 {jsonp:'onJsonPLoad'} 会导致将 "onJsonPLoad=?" 传给服务器。

jsonpCallback
类型：String

为 jsonp 请求指定一个回调函数名。这个值将用来取代 jQuery 自动生成的随机函数名。这主要用来让 jQuery 生成度独特的函数名，这样管理请求更容易，也能方便地提供回调函数和错误处理。你也可以在想让浏览器缓存 GET 请求的时候，指定这个回调函数名。

password
类型：String

用于响应 HTTP 访问认证请求的密码

processData
类型：Boolean

默认值: true。默认情况下，通过data选项传递进来的数据，如果是一个对象(技术上讲只要不是字符串)，都会处理转化成一个查询字符串，以配合默认内容类型 "application/x-www-form-urlencoded"。如果要发送 DOM 树信息或其它不希望转换的信息，请设置为 false。

scriptCharset
类型：String

只有当请求时 dataType 为 "jsonp" 或 "script"，并且 type 是 "GET" 才会用于强制修改 charset。通常只在本地和远程的内容编码不同时使用。

success
类型：Function

请求成功后的回调函数。

参数：由服务器返回，并根据 dataType 参数进行处理后的数据；描述状态的字符串。

这是一个 Ajax 事件。

traditional
类型：Boolean

如果你想要用传统的方式来序列化数据，那么就设置为 true。请参考工具分类下面的 jQuery.param 方法。

timeout
类型：Number

设置请求超时时间（毫秒）。此设置将覆盖全局设置。

username
类型：String

用于响应 HTTP 访问认证请求的用户名。

xhr
类型：Function

需要返回一个 XMLHttpRequest 对象。默认在 IE 下是 ActiveXObject 而其他情况下是 XMLHttpRequest 。用于重写或者提供一个增强的 XMLHttpRequest 对象。这个参数在 jQuery 1.3 以前不可用。

回调函数

如果要处理 $.ajax() 得到的数据，则需要使用回调函数：beforeSend、error、dataFilter、success、complete。

beforeSend：（Function）发送ajax请求前被触发，并且传入一个 XMLHttpRequest 作为参数，如果返回false则取消本次请求。如果异步请求需要显示gif动画，那应当在这里设置相应<img>的可见。
function(XMLHttpRequest){ }

complete：(Function)请求调用完成后的回调函数（请求无论成功或失败均调用），传入 XMLHttpRequest 对象，以及一个包含成功或错误代码的字符串。如果异步请求显示gif动画，那应当在这里设置相应的<img>不可见。
function(XMLHttpRequest,textStatus){
   //textStatus是描述返回状态的字符串
}

success：(Function)请求执行成功时的回调函数，传入返回后的数据，以及包含成功代码的字符串。
function(data,textStatus){
   //data是服务端返回的数据可以是xml、json、text等格式
   //textStatus是描述返回状态的字符串
}


error：(Function)请求执行失败时的回调函数，传入 XMLHttpRequest 对象，描述错误类型的字符串以及一个异常对象（如果有的话）
function(XMLHttpRequest,textStatus,errorThrown){
   //data是服务端返回的数据可以是xml、json、text等格式
   //textStatus,errorThrown是描述返回状态的信息
}

二、$.get()和$.post()
$.ajax()是最基本的Ajax方法，在JQuery中又提供了两个简捷的Ajax调用方法$.get()和$.post()，这两个方法实现了对$.ajax()的封装。有了$.ajax()的基础，下面两个方法学习起来就很简单了。
1.$.get()
语法：
$.get(url [,data] [,callback] [,type])
url：(string)请求的HTML页的URL地址
data：(object)发送到服务器的数据，以key/value对形式书写，如：{name:"张三",age:"18"}
callback：(function)回调函数，只有返回的状态是success时才调用该方法。
type：(string)服务端返回的内容的格式。xml,html,json,text等

2.$.post()
语法：
$.post(url [,data] [,callback] [,type])
url：(string)请求的HTML页的URL地址
data：(object)发送到服务器的数据，以key/value对形式书写，如：{name:"张三",age:"18"}
callback：(function)回调函数，只有返回的状态是success时才调用该方法。
type：(string)服务端返回的内容的格式。xml,html,json,text等

$.post()与$.get()很相似，只是数据参数传递方式不一样，这二者与传统的get/post提交方式相同。