wml

转:DOJO Book 第一章补充 I/O

译者序:
Dojo book目前还在不断更新和补充中,我会尽量跟上原著的脚步,给大家最新的信息。
更新我会用随笔写出来,同时也会更新原文章。

I/O

dojo.io.blind介绍


在我们制作dojo的时候,目的是让用户和开发者都能享受到DHTML程序。在很多朋友的支持下,特别是Aaron Boodman和Mark Anderson,我们已经找到了解决可用性的方法。我们提供了一个单独的易用的API和一个包装类,这个类只需要两个文件。dojo.io包提供了对XMLHTTP和一些其他更复杂的传输结构的支持。

在dojo.io 包中我们一般最常使用的是dojo.io.bind()方法。dojo.io.blind()是一个标准的异步的请求API,它包含了各种传输层 (transport layers),包括queues of iFrames,XMLHTTP,mod_pubsub,LivePage等等。Dojo会试图为当前的请求选择最合适的传输方法,因为在做网站时一般不 会使用到其他传输,所以我们只用到XMLHTTP。dojo接受一个匿名的类,但是在知道这个类的属性的情况下,把它作为方法参数(function argument)。下面的代码是创建一个请求(request),这个请求会从URL返回原始的字符串。
dojo.io.bind({
    url: 
"http://foo.bar.com/sampleData.txt",
    load: 
function(type, data, evt){ /*do something w/ the data */ },
    mimetype: 
"text/plain"
});

这就是全部,你提供了一个数据地址,还有一个当你得到返回值时要执行的function。但是如果在请求过程中出错了怎么办呢?我们再来创建一个register来解决:

dojo.io.bind({
    url: 
"http://foo.bar.com/sampleData.txt",
    load: 
function(type, data, evt){ /*do something w/ the data */ },
    error: 
function(type, error){ /*do something w/ the error*/ },
    mimetype: 
"text/plain"
});

同样也可以只创建一个单独的handler来解决:
dojo.io.bind({
    url: 
"http://foo.bar.com/sampleData.txt",
    handle: 
function(type, data, evt){
        
if(type == "load"){
            
// do something with the data object
        }else if(type == "error"){
            
// here, "data" is our error object
            // respond to the error here
        }else{
            
// other types of events might get passed, handle them here
        }
    },
    mimetype: 
"text/plain"
});

下面的代码提交一段javascript程序段,然后让服务器运行它,一般我们这么做是为了加速程序运行,注意mimetype:
dojo.io.bind({
    url: 
"http://foo.bar.com/sampleData.js",
    load: 
function(type, evaldObj){ /* do something */ },
    mimetype: 
"text/javascript"
});

如果你想确保程序使用XMLHTTP,可以这样写:
dojo.io.bind({
    url: 
"http://foo.bar.com/sampleData.js",
    load: 
function(type, evaldObj){ /* do something */ },
    mimetype: 
"text/plain"// get plain text, don't eval()
    transport: "XMLHTTPTransport"
});
Being a jack-of-all-trades, bind() also supports the submission of forms via a request (with the single caveat that it won't do file upload over XMLHTTP):
作为一个jack-of-all-trades(万事通),bind()同样支持来自于表单提交的数据。
dojo.io.bind({
    url: 
"http://foo.bar.com/processForm.cgi",
    load: 
function(type, evaldObj){ /* do something */ },
    formNode: document.getElementById(
"formToSubmit")
});
以上只是一些最基本的,其实这些可以不用全部由开发者自定义。

RPC
你可以看到,Dojo通过dojo.io.bind提供了简单,强大的方法使用多种多样的I/O functions。但是在开发过程中,程序员会调用很多很多I/O,这同时会给服务器和客户端加重负担。Dojo的RPC服务就是为了减少负担,易用,精简代码而生的。

RPC 的全名是Remote Procedre Calls,或者Remote Method Invocation,(译者:远程method调用)。最基本的,RPC允许开发者调用在远程服务器上的方法(method)。Dojo不仅提供了基本 的RPC client包,而且还扩展了它,使它支持JSON-RPC服务和YAHOO服务。同时你也可以自己写出相对于其他服务的类。

我们假定有一个需要调用服务器端程序的小程序,假设要调用add(x,y)和subtract(x,y)。在没有特殊情况的条件下,我们的客户端会这样写:
add = function(x,y) {

    request 
= {x: x, y: y};

    dojo.io.bind({
            url: 
"add.php",
            load: onAddResults,
            mimetype: 
"text/plain",
        content: request
    });
}

subtract 
= function(x,y) {

    request 
= {x: x, y: y};
    
    dojo.io.bind({
            url: 
"subract",
            load: onSubtractResults,
            mimetype: 
"text/plain"
        content: request
    });
}


你 看,这不是很难。但是无论是我们让服务器运行add和subtract还是让客户端自己计算,这只是一个非常简单的程序。如果我们要调用在服务器上30个 不同method会怎么样呢?我猜我们可能要重复的写几乎一样的代码一遍又一遍,每次都要创建一个请求类(request object),设定URL,设定变量等等。这不仅容易出错,而且还很枯燥。
Dojo的RPC客户端简化了这个过程:
{
    
"serviceType""JSON-RPC"
    
"serviceURL""rpcProcessor.php"
    
"methods":[ 
        {
            
"name""add"
            
"parameters":[
                {
"name""x"},
                {
"name""y"}    
            ]
        },
        {
            
"name""subtract"
            
"parameters":[
                {
"name""x"},
                {
"name""y"}    
            ]
        }

    ]
}

以上就是对于服务器的定义。一旦定义创建完毕,其他的事情就简单了,我们还可以创建一个类:
var myObject = new dojo.rpc.JsonService?(defintion);
要使用服务器的方法:
myObject.add(3,5);

我 敢打赌你会在想“我不是只调用方法就够了,我还有得到计算的结果。”你是对的,但这也是非常容易的。服务器端的myObject.add()会返回一个延 缓类(deferred object)。Twisted Python用户可能对延缓类(deferred object)很熟悉,延缓类(deferred object)允许开发者根据返回数据的类型附加一个或更多的回叫(callbacks)和错误处理(errbacks)。这里有一个简单的例子:
var myDeferred = myObject.add(3,5);
myDeferred.addCallback(myCallbackMethod);

我 们把mycallbackmethod作为回叫添加到我们的延缓类mydeferred。这时,8会被传递进mycallbackmethod。另一方 面,我们也可以添加一个errback method来处理服务器返回的出错信息。我们随意添加回叫方法(callback),多少都可以,它们会按照我们定义的顺序被调用。

以 上的例子都是围绕dojo.rpc.JsonService展开的。我们还可以使用dojo.rpc.YahooService,规范和结构都是一样的。 这两个类都是继承了dojo.rpc.RpcService。要创建自己的类会在第二章中详细介绍。(译者:第二章原著还没有完成)

posted on 2006-07-04 11:04 wml 阅读(185) 评论(0)  编辑  收藏 所属分类: DOJO