日期:2014-05-16 浏览次数:20518 次
?ExtJs之所以能异步请求数据,全依赖于Ext.data.Connection。而Ext.Ajax只不过是Ext.data.Connection的一个实例罢了。当然Ext.Ajax比Ext.data.Connection多了一个函数:serializeForm(form),这个函数的作用是把一个表单里面的表单元素序列化。结果形式为:name1=value1&name2=value2……不过,如果是我的话,一般不会用这个东西,因为平常都是传json数据的,当然,如果不是请求WebService,而是请求aspx页面,那么这个东西还是有点用的。
先把它的官方文档翻译一下吧。
全 称:Ext.data.Connection
命名空间:Ext.data
定义 于:Connection.js
类 名:Connection
子 类:Ajax
父 类:Observable
这个类封装了到页面所在主机的连接,允许通过一个配置好的URL来请求数据,也可以临时在请求时传递一个URL。
通过这个类获得的请求都是异步的,并且马上返回,调用request后,它并不马上返回数据,要处理数据,要在调用request时传入的 options对象中,配置callback或者是success、failure。这三个是回调函数。其区别将在下文具体交待。当然,你也可以使用 Connection的事件处理来做一些事情。
注意:如果你是要上传文件,你的回调、事件处理函数将不会获得通常意义上的response对象。上传通过IFrame来捕获,所以就没有 XMLHttpRequest了。这时,response还是被创建,不过,它的responseText等于IFrame的 document.innerHTML,responseXML等于IFrame的document中的xml数据。当然,这个前提是它们存在的时候。
这意味着必面回一个合法的XML或HTML document。如果返回的是JSON数据,那么建议你把数据放到<textarea>标记中,返回时通过正则表达式从 responseText中取出来了。如果返回的是XML数据,建议放到CDATA里面,通过标准DOM方法从responseXMl中取得数据。
Options:
autoAbort : Boolean
取消当前请求,不管当前请求是不是存在。默认值为false。
defaultHeaders : Object
默认头部,每个HTTP请求分成两部:头部、数据。数据就是post的部分,头部包含了请求的一些基本属性,此对象定义了用当前connection对象发起的请求的默认头部,默认值为undefined。
disableCaching : Boolean
是否为GET请求加入一个唯一标志的参数缓存。
extraParams : Object
一般情况下,加在encodeURL(params)后面。默认值为:undefined。
method : String
就是http请求的method属性。默认情况下是未定义的(undefined);如果没有设置,但是调用request时设了params,那么将使用POST方式,否则使用GET。
timeout : Number
请求超时,默认值为:30000。单位是millisecond(毫秒?)。
url : String
用此connection对象发起的请求的默认URL。默认值为:undefined。
无公共属性
公共函数(只讲connection自身的,不包括从Observable中继承来的):
Connection( Object config )
构造函数,没有悬念。
abort( [Number transactionId] ) : void
取消指定id的请求,如果没有指定则取消当前请求。
isLoading( [Number transactionId] ) : Boolean
判断指定id的请求是不是正在请求中(?)。
request( [Object options] ) : Number
发送一个HTTP请求到远程主机上。
重点:Ajax服务请求都是异步的,并且这个请求将在response(响应)返回之前返回,也就是说,你绝对无法通过此函数来直接返回数据,你得通过定义回调函数来处理返回的数据。
参数:
options : Object
一个可能包含下面属性的对象:
??????? url : String (Optional)
??????? 请求对应的URL,默认值是connection的options配置的那个url。
params : Object/String/Function (Optional)
用于提供url后面的请求参数(俗称查询字符串),可以是json对象,可以是直接的字符串,可以是一个函数。
method : String (Optional)
此 http请求的method。默认值为connection的options中配置的method。如果没有设置它,那么就要看params是否设了,如果设了就以POST方式请求,如果没有就以GET方式请求,注意:method名是大小敏感的,必须全面大写。
callback : Function (Optional)
无论请求成功还是失败它都被执行,其参数如下:
options : Object
不用说了。
success : Boolean
是否请求成功了。
response : Object
一个包含响应数据的XMLHttpRequest对象。
success : Function (Optional)
请求成功时执行的回调。它的参数如下:
response : Object
一个包含响应数据的XMLHttpRequest对象。
options : Object
不用说了。
failure : Function (Optional)
请求失败时执行的回调。它的参数如下:
response : Object
一个包含响应数据的XMLHttpRequest对象。
options : Object
不用说了。
scope : Object (Optional)
回调函数执行时所使用的scope。
form : Object/String (Optional)
将用于构造查询字符串的form的引用或id。
isUpload : Boolean (Optional)
当前请求是否是在上传文件(通常是自动检测的)。
文件上传不是通过通常的Ajax技术实现,它们通过在form提交时动态插入一个iframe,返回时又移除这个iframe来实现,一通的英文,就是说响应数据是直接交给浏览器的,这时,就有点能理解为什么要用iframe了。因为它返回的东西会被浏览器直接插入到document对象下面,直给放当前页,那么页面当前内容将消失。所以,只有放一个iframe中了。且这个iframe得隐藏起来。
如果返回结果是json,那么头部要设一下content-type:text/html。
headers : Object (Optional)
请求的头部。
xmlData : Object (Optional)
如果有它,那么params就不会起作用。
jsonData : Object/String (Optional)
如果有它,那么params就不会起作用。
disableCaching : Boolean (Optional)
为真时为Get请求创建一个param缓存。
这个options对象也可以包含其他你需要用于回调的属性,大伙都晓得,这个options最后回被传给回调函数的,