首页 > 代码库 > JQuery中的AJAX
JQuery中的AJAX
load()方法
load(url,[data],[callback])
url为被加载的页面地址
data表示发送到服务器的数据,格式为key/value
callback格式为:function(responseText,textStatus,XMLHttpRequest){ }
//responseText:请求返回的内容
//textStatus:请求状态:success、error、notmodified、timeout这4种
//XMLHttpRequest:XMLHttpRequest对象
load()方法的传递方式根据参数data来自动指定。如果没有参数传递,则采用GET方式传递;反之,则自动转换为POST方式
$("#div1").load( "jsp/feed.jsp", //如果为" jsp/feed.jsp .filterClass",则表示获取jsp页面中类名为filterClass的全部元素 { name :clf, age : 25 //经测试,变量名加引号、单引号、不加引号,后台都能取到值 //如果含有中文,必须用encodeURI()进行编码,然后再服务器端用decodeURI()解码即可,如 // {name:encodeURI($("#uName").val()),"password":$("#uPassword").val()}, }, //也可以用数组传值,{"attr []",["clf","25","male"]} function (){ $("#div2").text("AJAX"); } );
$("div").load("wrongname.xml",function(response,status,xhr){ if (status=="success") { $("div").html("<ol></ol>"); $(response).find("artist").each(function(){ <span style="white-space:pre"> </span>varitem_text = $(this).text(); <span style="white-space:pre"> </span>$('<li></li>').html(item_text).appendTo('ol'); <span style="white-space:pre"> </span> }); } else { $("div").html("Anerror occured: <br/>" + xhr.status + " " + xhr.statusText) } });getJSON()方法
getJSON(url,[data],[callback])
callback格式为function(data,textStatus) { }
data是一个返回的json对象
$.getJSON("test.js",{ name: "John", time: "2pm" }, function(json){ alert("JSON Data: " +json.users[3].name); });getScript()方法
getScript(url,[callback])
callback格式为function(response,status)
response - 包含来自请求的结果数据
status - 包含请求的状态("success","notmodified", "error", "timeout" 或"parsererror")
通过此函数注入的脚本会自动执行
get()方法
get(url,data,callback(response,status,xhr),dataType)
dataType可能的类型:"xml"、"html" 、"text"、 "script"、 "json"、 "jsonp"
get() 方法通过远程 HTTPGET 请求载入信息。
post()方法
post(url,data,callback(response,status,xhr),dataType)
与get()方法类似
get()方法不适合传递数据量较大的数据,同时,其请求的历史信息会保存在浏览器的缓存中,有一定的风险,而以post()方法则不存在这方面的不足
serialize()方法
serialize() 方法通过序列化表单值,创建URL 编码文本字符串。
可以选择一个或多个表单元素(比如input 及/或文本框),或者 form 元素本身。
序列化的值可在生成 AJAX 请求时用于 URL 查询字符串中。
<form> <div><input type="text"name="a" value=http://www.mamicode.com/"1" id="a" />
$('form').submit(function(){ alert($(this).serialize()); return false; });
输出标准的查询字符串:
a=1&b=2&c=3&d=4&e=5
注释:只会将”成功的控件“序列化为字符串。如果不使用按钮来提交表单,则不对提交按钮的值序列化。如果要表单元素的值包含到序列字符串中,元素必须使用 name 属性。当表单中有多项被选中时,该方法只能传递一项的值
ajax()方法
1.url:
要求为String类型的参数,(默认为当前页地址)发送请求的地址。
2.type:
要求为String类型的参数,请求方式(post或get)默认为get。注意其他http请求方法,例如put和delete也可以使用,但仅部分浏览器支持。
3.timeout:
要求为Number类型的参数,设置请求超时时间(毫秒)。此设置将覆盖$.ajaxSetup()方法的全局设置。
4.async:
要求为Boolean类型的参数,默认设置为true,所有请求均为异步请求。如果需要发送同步请求,请将此选项设置为false。注意,同步请求将锁住浏览器,用户其他操作必须等待请求完成才可以执行。
5.cache:
要求为Boolean类型的参数,默认为true(当dataType为script时,默认为false),设置为false将不会从浏览器缓存中加载请求信息。
6.data:
要求为Object或String类型的参数,发送到服务器的数据。如果已经不是字符串,将自动转换为字符串格式。get请求中将附加在url后。防止这种自动转换,可以查看processData选项。对象必须为key/value格式,例如{foo1:"bar1",foo2:"bar2"}转换为&foo1=bar1&foo2=bar2。如果是数组,JQuery将自动为不同值对应同一个名称。例如{foo:["bar1","bar2"]}转换为&foo=bar1&foo=bar2。
7.dataType:
要求为String类型的参数,预期服务器返回的数据类型。如果不指定,JQuery将自动根据http包mime信息返回responseXML或responseText,并作为回调函数参数传递。可用的类型如下:
xml:返回XML文档,可用JQuery处理。
html:返回纯文本HTML信息;包含的script标签会在插入DOM时执行。
script:返回纯文本JavaScript代码。不会自动缓存结果。除非设置了cache参数。注意在远程请求时(不在同一个域下),所有post请求都将转为get请求。
json:返回JSON数据。
jsonp:JSONP格式。使用SONP形式调用函数时,例如myurl?callback=?,JQuery将自动替换后一个“?”为正确的函数名,以执行回调函数。
text:返回纯文本字符串。
8.beforeSend:
要求为Function类型的参数,发送请求前可以修改XMLHttpRequest对象的函数,例如添加自定义HTTP头。在beforeSend中如果返回false可以取消本次ajax请求。XMLHttpRequest对象是惟一的参数。
function(XMLHttpRequest){ this; //调用本次ajax请求时传递的options参数 }
9.complete:
要求为Function类型的参数,请求完成后调用的回调函数(请求成功或失败时均调用)。参数:XMLHttpRequest对象和一个描述成功请求类型的字符串。
function(XMLHttpRequest, textStatus){ this; //调用本次ajax请求时传递的options参数 }
10.success:要求为Function类型的参数,请求成功后调用的回调函数,有两个参数。
(1)由服务器返回,并根据dataType参数进行处理后的数据。
(2)描述状态的字符串。
function(data, textStatus){ //data可能是xmlDoc、jsonObj、html、text等等 this; //调用本次ajax请求时传递的options参数 }
11.error:
要求为Function类型的参数,请求失败时被调用的函数。该函数有3个参数,即XMLHttpRequest对象、错误信息、捕获的错误对象(可选)。ajax事件函数如下:
function(XMLHttpRequest, textStatus,errorThrown){ //通常情况下textStatus和errorThrown只有其中一个包含信息 this; //调用本次ajax请求时传递的options参数 }
12.contentType:
要求为String类型的参数,当发送信息至服务器时,内容编码类型默认为"application/x-www-form-urlencoded"。该默认值适合大多数应用场合。
13.dataFilter:
要求为Function类型的参数,给Ajax返回的原始数据进行预处理的函数。提供data和type两个参数。data是Ajax返回的原始数据,type是调用jQuery.ajax时提供的dataType参数。函数返回的值将由jQuery进一步处理。
function(data, type){ //返回处理后的数据 return data; }
14.dataFilter:
要求为Function类型的参数,给Ajax返回的原始数据进行预处理的函数。提供data和type两个参数。data是Ajax返回的原始数据,type是调用jQuery.ajax时提供的dataType参数。函数返回的值将由jQuery进一步处理。
function(data, type){ //返回处理后的数据 return data; }
15.global:
要求为Boolean类型的参数,默认为true。表示是否触发全局ajax事件。设置为false将不会触发全局ajax事件,ajaxStart或ajaxStop可用于控制各种ajax事件。
16.ifModified:
要求为Boolean类型的参数,默认为false。仅在服务器数据改变时获取新数据。服务器数据改变判断的依据是Last-Modified头信息。默认值是false,即忽略头信息。
17.jsonp:
要求为String类型的参数,在一个jsonp请求中重写回调函数的名字。该值用来替代在"callback=?"这种GET或POST请求中URL参数里的"callback"部分,例如{jsonp:‘onJsonPLoad‘}会导致将"onJsonPLoad=?"传给服务器。
18.username:
要求为String类型的参数,用于响应HTTP访问认证请求的用户名。
19.password:
要求为String类型的参数,用于响应HTTP访问认证请求的密码。
20.processData:
要求为Boolean类型的参数,默认为true。默认情况下,发送的数据将被转换为对象(从技术角度来讲并非字符串)以配合默认内容类型"application/x-www-form-urlencoded"。如果要发送DOM树信息或者其他不希望转换的信息,请设置为false。
21.scriptCharset:
要求为String类型的参数,只有当请求时dataType为"jsonp"或者"script",并且type是GET时才会用于强制修改字符集(charset)。通常在本地和远程的内容编码不同时使用。
$.ajax({ type:"GET", url:"test.json", data:{username:$("#username").val(),content:$("#content").val()}, dataType: "json", success: function(data){ $('#resText').empty(); varhtml = ''; $.each(data,function(commentIndex, comment){ html += comment['username'] + comment['content']; }); } });
$.ajaxSetup()方法
在使用ajax()方法时,有时需要调用多个$.ajax()方法,如果每个方法都设置其中的请求细节,将是一件十分麻烦的事。为了简化这种工作,在JQuery中可以使用ajaxSetup()函数设置全局性的ajax默认选项,一次设置,全局有效
$.ajaxSetup({ type:”GET”, url:”jsp/response.jsp”, dataType:”xml” });
此后再调用ajax()函数,将默认使用上面设置的参数
ajaxStart()和ajaxStop()及其他全局事件
前者是当请求开始执行时出发,往往用于编写一些准备性的工作,如提示“正在获取数据……”字样;后者是当请求结束时触发,常常与前者结合使用。如将提示字样改为“已经成功获取数据!”,然后渐渐消失
$("#my").ajaxStart(function(){ $(this).show(); }).ajaxStop(function(){ $(this).hide(); });
<div id="my" style=" display:none"> <img src=http://www.mamicode.com/"loading.gif"/> >ajaxStart()和ajaxStop()是全局函数,除此之外,JQuery中还有4个与ajax 有关的全局性事件
ajaxComplete() 在 AJAX 请求完成时执行函数
ajaxError() 在 AJAX 请求发生错误时执行函数
ajaxSuccess() 在 AJAX 请求成功时执行函数
ajaxSend() 在 AJAX 请求开始时执行函数
$("#msg").ajaxError(function(event,request,settings){ $(this).append("<li>出错页面:"+ settings.url + "</li>"); });JQuery中的AJAX