Dojo入门教程之dojo.io.bind详解

dojo.io.bind ：处理请求取回需要的数据并处理。
这个函数是AJAX中最为重要和有用的函数，dojo.io.bind这个类是用来处理客户端与服务器间通讯的，需要通讯的参数由对象dojo.io.Request所定义，具体通讯的方法则由另外一个对象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来得到一个Javas cript所定义的对象（注意mimetype必须要定义为"text/javas cript"）




testObj = dojo.io.bind(

{


url: "http://localhost/test.js", //test.js里定义了一个对象


mimetype: "text/javas cript", //请求的页面的类型，应该设置为与你请求页面类型对应的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=?€?&name=????§°", 有中文的话应该指定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打开指定的网页，并覆盖浏览器的历史记录
模块：dojo.io.BrowserIO
基本上就提供了dojo.io.XMLHTTPTransport这个对象
XMLHTTPTransport一般能够满足我们的需求，但是其有几个限制：它不能传输文件，不能够成功执行跨域名的远程请求，并且不支持 file:// 这样的协议
因此，根据应用要求，我们可能会需要选用其它的transport: dojo.io.IframeTransport, dojo.io.repubsubTranport, dojo.io.s criptSrcTransport, ShortBusTransport
dojo.io.IframeTransport，用法与xmlhttp是一样的，其优点就是可以跨域，不存在任何的安全问题
如果Request指定的mimetype是text或javas cript，返回的内容应该是放在第一个textarea里的内容，如果指定的mimetype是html，则IFrame里的html则是需要的内容。因为浏览器兼容的原因，IframeTransport不能正确处理返回类型为XML的请求。