Icebird

Delphi/C# - My favorite programming language

My Links

Blog Stats

Dojo学习笔记(6. dojo.io.IO & dojo.io.BrowserIO)

模块:dojo.io.IO

dojo.io.bind


处理请求取回需要的数据并处理

 

这个函数是AJAX中最为重要和有用的函数,dojo.io.bind这个类是用来处理客户端与服务器间通讯的,需要通讯的参数由对象dojo.io.Request所定义,具体通讯的方法则由另外一个对象Transport所提供。

 

因此,我们如果需要与服务器通讯,则应该定义一个Request对象,其中包括服务器地址及回调函数,例子中Requset都是以匿名对象方式定义的


虽然我们可以定义一个自己的Transport,但是显然不如直接利用现成的Transport方便。


Dojo里提供了一个同时兼容IE和Firefox的dojo.io.XMLHTTPTransport,但是这个对象位于dojo.io.BrowserIO,因此,一般require dojo.io.IO时,还应该require dojo.io.BrowserIO

 

Usage Example:

  dojo.io.bind({
    url: "http://localhost/test.html", //要请求的页面地址
    mimetype: "text/html", //请求的页面的类型,应该设置为与你请求页面类型对应的mimetype,默认为 "text/plain"
    method:"GET", //默认为"GET"
    sync: false, //默认为异步执行
    useCache: false, //默认为不使用页面缓存,注意这里的缓存并不是浏览器的缓存,而是Dojo自身所维护的页面缓存
    preventCache: false, //默认为启用浏览器缓存,否则将通过自动增加不同的参数来确保浏览器缓存失效
    timeoutSeconds: 3000,  //3秒后超时,如果为0则永不超时

    load: function(type, data, evt) { alert(data); }, //type should be "load", data is that we wanted
    error: function(type, error) { alert(error.message); }, //error is dojo.io.Error
    timeout: function(type) { alert("请求超时!"); }
  });


  你也可以用一个handle来处理所有的事件

 

  dojo.io.bind({
    url: "http://localhost/test.html", //要请求的页面地址
    mimetype: "text/html", //请求的页面的类型,应该设置为与你请求页面类型对应的mimetype
    timeoutSeconds: 3000,  //3秒后超时,如果为0则永不超时
    handle: function(type, data, evt){
      if(type == "load") { alert(data); } //data is that we wanted
      else if (type == "error") { alert(data.message); } //data is the error object
      else { ; } //other events maybe need handled
    }
  });
 
  如果没有在Request中指定所用的transport,则Dojo会自动的在已注册的transports中寻找能够处理这个Request的transport,如果不能找到,则返回指定的Request。下面是一个指定了transport的例子:


  dojo.io.bind({
    url: "http://localhost/test.html", //要请求的页面地址
    mimetype: "text/html", //请求的页面的类型,应该设置为与你请求页面类型对应的mimetype
    timeoutSeconds: 3000,  //3秒后超时,如果为0则永不超时
    transport: "XMLHTTPTransport",

    load: function(type, data, evt) { alert(data); }, //type should be "load", data is that we wanted
    error: function(type, error) { alert(error.message); }, //error is dojo.io.Error
    timeout: function(type) { alert("请求超时!"); }
  });


  你还可以利用bind来得到一个JavaScript所定义的对象(注意mimetype必须要定义为"text/javascript")

 

  testObj = dojo.io.bind({
    url: "http://localhost/test.js", //test.js里定义了一个对象
    mimetype: "text/javascript", //请求的页面的类型,应该设置为与你请求页面类型对应的mimetype
    timeoutSeconds: 3000,  //3秒后超时,如果为0则永不超时
    handle: function(type, data, evt){
      if(type == "load") { alert(data); } //data is a object or value
      else if (type == "error") { alert(data.message); } //data is the error object
      else { ; } //other events maybe need handled
    }
  });
 
  下面是一个Post的例子:
 
  dojo.io.bind({
    url: "http://localhost/test.aspx", //要提交的页面地址
    mimetype: "text/html", //请求的页面的类型,应该设置为与你请求页面类型对应的mimetype
    timeoutSeconds: 3000,  //3秒后超时,如果为0则永不超时
    method: "POST",
    formNode: dojo.byId("myForm"), //指定提交的Form名称

    load: function(type, data, evt) { alert(data); }, //type should be "load", data is that we wanted
    error: function(type, error) { alert(error.message); }, //error is dojo.io.Error
    timeout: function(type) { alert("请求超时!"); }
  });

 

  另一个Post的例子(without Form to post):


  dojo.io.bind({
    url: "http://localhost/test.aspx", //要提交的页面地址
    mimetype: "text/html", //请求的页面的类型,应该设置为与你请求页面类型对应的mimetype
    timeoutSeconds: 3000,  //3秒后超时,如果为0则永不超时
    method: "POST",
    content: {a: 1, b: 2}, //要提交的数据

    load: function(type, data, evt) { alert(data); }, //type should be "load", data is that we wanted
    error: function(type, error) { alert(error.message); }, //error is dojo.io.Error
    timeout: function(type) { alert("请求超时!"); }
  });


 

dojo.io.queueBind


  有时,我们需要一次发出多个网页请求,则应该使用dojo.io.queueBind,因为浏览器可能只允许同时发出有限个数的请求,如果是使用dojo.io.bind的话,则有可能会申请不到新的XMLHttp对象而导致出错。

  用法与dojo.io.bind是一样的。


 

dojo.io.argsFromMap


  用来把对象转换为URL的参数形式
 
Usage Example:


  dojo.io.argsFromMap({a:1,b:2,c:3}); //will return "c=3&b=2&a=1"
  dojo.io.argsFromMap({name:"名称",value:"值"},"utf"); //will return "value=%E5%80%BC&name=%E5%90%8D%E7%A7%B0", 有中文的话应该指定utf格式,否则dojo.string.encodeAscii返回的编码是很怪异的
  dojo.io.argsFromMap({a:1,b:2,c:3}, "utf", "c"); //will return "b=2&a=1&c=3",最后一个参数可以控制指定名称的值出现在最后
 

 

dojo.io.setIFrameSrc


  设置IFrame的Src
 
Usage Example:

 

  dojo.io.setIFrameSrc(dojo.byId("myFrame"), "http://localhost/test.htm"); //myFrame打开指定的网页
  dojo.io.setIFrameSrc(dojo.byId("myFrame"), "http://localhost/test.htm", true); //myFrame打开指定的网页,并覆盖浏览器的历史记录


 

TODO: 补充一个kwArgs的例子,我之前在网上看见过,可是现在无论如何也找不到相关的页面了,只好以后在举例了

 


模块:dojo.io.BrowserIO

 

基本上就提供了dojo.io.XMLHTTPTransport这个对象


XMLHTTPTransport一般能够满足我们的需求,但是其有几个限制:它不能传输文件,不能够成功执行跨域名的远程请求,并且不支持 file:// 这样的协议


因此,根据应用要求,我们可能会需要选用其它的transport: dojo.io.IframeTransport, dojo.io.repubsubTranport, dojo.io.ScriptSrcTransport, ShortBusTransport

 

dojo.io.IframeTransport,用法与xmlhttp是一样的,其优点就是可以跨域,不存在任何的安全问题
如果Request指定的mimetype是text或javascript,返回的内容应该是放在第一个textarea里的内容,如果指定的mimetype是html,则IFrame里的html则是需要的内容。因为浏览器兼容的原因,IframeTransport不能正确处理返回类型为XML的请求。

 

关于Rpc,这个类似于Remoting的东西,也将在以后对其进行介绍。

posted on 2006-08-07 14:52  Icebird  阅读(...)  评论(...编辑  收藏