日期:2014-05-16  浏览次数:20518 次

extJs 2.1学习笔记(Ext.data.Connection篇一)

?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最后回被传给回调函数的,