Ext 介绍入门之 DWR的替代品Ext.Direct
Ext.Direct的目的在于提供一个无缝的通讯流(streamline)介乎于客户端和服务端之间,形成一种单一的接口,从而使得我们减少一些乏味的编码,例如数据的验证和出来返回的数据包(读数据、错误条件等等)。Ext.direct命名空间下有若干的类是为了与服务端更密切地整合。Ext.Direct的一些方法产生出来的数据经过Ext.data另外的一些类,就可以转给Ext.data.Stores处理。
供应器
Ext.Direct的架构属于“供应器(provider)”的架构,一个或多个的供应器负责将数据传输到服务器上。当前有几种关键的供应器:
JsonProvider 简易的JSON操作
PollingProvider 轮询供应器,用于重复的请求
RemotingProvider 向客户端暴露了服务端的供应器
供应器本身不能直接的使用,应该通过Ext.Direct.add()加入。该方法加入一个Ext.Direct供应器并创建代理,或者可理解我ie对服务端执行的方法进行一个快照。 如果供应器还没有链接,那么就会自动链接。下面的例子创建了两个provider。
var pollProv = new Ext.direct.PollingProvider({
url: 'php/poll2.php'
});
Ext.Direct.addProvider(
{
"type":"remoting", // create a Ext.direct.RemotingProvider
"url":"php\/router.php", // url to connect to the Ext.Direct server-side router.
"actions":{ // each property within the actions object represents a Class
"TestAction":[ // array of methods within each server side Class
{
"name":"doEcho", // name of method
"len":1
},{
"name":"multiply",
"len":1
},{
"name":"doForm",
"formHandler":true, // handle form on server with Ext.Direct.Transaction
"len":1
}]
},
"namespace":"myApplication",// namespace to create the Remoting Provider in
},{
type: 'polling', // create a Ext.direct.PollingProvider
url: 'php/poll.php'
},
pollProv // reference to previously created instance
);
var pollProv = new Ext.direct.PollingProvider({
url: 'php/poll2.php'
});
Ext.Direct.addProvider(
{
"type":"remoting", // create a Ext.direct.RemotingProvider
"url":"php\/router.php", // url to connect to the Ext.Direct server-side router.
"actions":{ // each property within the actions object represents a Class
"TestAction":[ // array of methods within each server side Class
{
"name":"doEcho", // name of method
"len":1
},{
"name":"multiply",
"len":1
},{
"name":"doForm",
"formHandler":true, // handle form on server with Ext.Direct.Transaction
"len":1
}]
},
"namespace":"myApplication",// namespace to create the Remoting Provider in
},{
type: 'polling', // create a Ext.direct.PollingProvider
url: 'php/poll.php'
},
pollProv // reference to previously created instance
);
路由器
在客户端与服务端部分方法之间,Ext.Direct使用了服务端“路由器(router)”的概念来直接请求。 由于Ext.Direct是真正平台无关性的,所以你完全可以在以Java为解决方案的服务端,立刻替换成为C#的服务端,过程中你不需要对JavaScript作任何的变动或修改。
服务端事件。
由服务器通知而来的事件,可以添加一个事件侦听器来应接并触发:
{"type":"event","name":"message","data":"Successfully polled at: 11:19:30 am"}
// 对应服务端“message”的事件的处理函数。add a handler for a 'message' event sent by the server
Ext.Direct.on('message', function(e){
out.append(String.format('<p><i>{0}</i></p>', e.data));
out.el.scrollTo('t', 100000, true);
});
{"type":"event","name":"message","data":"Successfully polled at: 11:19:30 am"}
// 对应服务端“message”的事件的处理函数。add a handler for a 'message' event sent by the server
Ext.Direct.on('message', function(e){
out.append(String.format('<p><i>{0}</i></p>', e.data));
out.el.scrollTo('t', 100000, true);
});
供应器Provider究竟是什么呢?文档是这样描述的,“Ext.direct.Provider是一个抽象类,用来扩展的。”!太简单了吧,呵呵其实还没说完了,看看这层次图:
Provider
|
+---JsonProvider
|
+---PollingProvider
|
+---RemotingProvider
基类Provider提供了重要的三个属性如下表:
属性:类型 说明
id : String 供应器的id(默认的由Ext.id()方法产生)。如果你没有用全局变量保存着这个供应器,那么你就应该分配一个id来记住这个供应器,以便日后寻找。例如:
view plaincopy to clipboardprint?Ext.Direct.addProvider( { type: 'polling', url: 'php/poll.php', id: 'poll-provider' } ); Ext.Direct.addProvider(
{
type: 'polling',
url: 'php/poll.php',
id: 'poll-provider'
}
);
priority : Number 请求的优先权(priority),数值愈低表示优先权愈高,0 就表示“双工的”(总是打开)。 所有的供应器默认为1 ,但PollingProvider就除外,默认为3 。
type : String 这是Ext.Direct的类型,这是必须的 ,默认是undefined 。 执行addProvider创建新的供应器的时候就会用到这个类型。 默认可识别的类型如下规格:
polling : PollingProvider
remoting : RemotingProvider
RemotingProvider暴露了在客户端上访问服务端方法的方式方法。 这是一种RPC(remote procedure call,远程过程调录)的连接类型,即客户端可以初始化服务端上的进程。这样的话,组织代码的时候会更具可维护性,客户端与服务端之间的道路怎么走也会越加地清晰。如果单使用URL的话这点是不容易做到的。同时,服务端必须将有关类和方法的信息告诉给客户端知道。一般这些配置的信息由服务端的Ext.Direct包完成,构建一系列的API信息输出。
RemotingProvider.action是一个重要的配置项。它用对象字面化(Object literal)确定服务端的动作或方法。例如,如果供应器(Provider)是如下配置的:
view plaincopy to clipboardprint?
"actions":{ // actions对象下面的属性每个都代表者对应服务端的类。each property within the 'actions' object represents a server side Class
"TestAction":[ // 服务端的类其方法所组成的数组,要将他们暴露给客户端。array of methods within each server side Class to be
{ // stubbed out on client
"name":"doEcho",
"len":1
},{
"name":"multiply",// name of method
"len":2 // 参数的个数是多少。一定要是数字类型,而不能是字符串。The number of parameters that will be used to create an
// array of data to send to the server side function.
// Ensure the server sends back a Number, not a String.
},{
"name":"doForm",
"formHandler":true, // direct the client to use specialized form handling method
"len":1
}]
}
* </code></pre>
* <p>
* 注意Store不是必须的,一个服务端方法可以在任何的时候被调用。下面的例子中我们<b>客户端</b>的方法调用服务端中的“乘法”,就在服务端的“TestAction”类中:
* <br />
* Note that a Store is not required, a server method can be called at any time.
* In the following example a <b>client side</b> handler is used to call the
* server side method "multiply" in the server-side "TestAction" Class:</p>
* <pre><code>
TestAction.multiply(
2, 4, // 这两个参数都会传到服务器中,所以指定len=2。pass two arguments to server, so specify len=2
// 下面的回调函数在服务端调用后执行。callback function after the server is called
// result: the result returned by the server
// e: Ext.Direct.RemotingEvent object result就是由服务端返回的对象,例如Ext.Direct.RemotingEvent类型的对象
function(result, e){
var t = e.getTransaction();
var action = t.action; // 调用服务端的类。server side Class called
var method = t.method; // 调用服务端的方法。server side method called
if(e.status){
var answer = Ext.encode(result); // 8
}else{
var msg = e.message; // 失败的信息 failure message
}
}
);
"actions":{ // actions对象下面的属性每个都代表者对应服务端的类。each property within the 'actions' object represents a server side Class
"TestAction":[ // 服务端的类其方法所组成的数组,要将他们暴露给客户端。array of methods within each server side Class to be
{ // stubbed out on client
"name":"doEcho",
"len":1
},{
"name":"multiply",// name of method
"len":2 // 参数的个数是多少。一定要是数字类型,而不能是字符串。The number of parameters that will be used to create an
// array of data to send to the server side function.
// Ensure the server sends back a Number, not a String.
},{
"name":"doForm",
"formHandler":true, // direct the client to use specialized form handling method
"len":1
}]
}
* </code></pre>
* <p>
* 注意Store不是必须的,一个服务端方法可以在任何的时候被调用。下面的例子中我们<b>客户端</b>的方法调用服务端中的“乘法”,就在服务端的“TestAction”类中:
* <br />
* Note that a Store is not required, a server method can be called at any time.
* In the following example a <b>client side</b> handler is used to call the
* server side method "multiply" in the server-side "TestAction" Class:</p>
* <pre><code>
TestAction.multiply(
2, 4, // 这两个参数都会传到服务器中,所以指定len=2。pass two arguments to server, so specify len=2
// 下面的回调函数在服务端调用后执行。callback function after the server is called
// result: the result returned by the server
// e: Ext.Direct.RemotingEvent object result就是由服务端返回的对象,例如Ext.Direct.RemotingEvent类型的对象
function(result, e){
var t = e.getTransaction();
var action = t.action; // 调用服务端的类。server side Class called
var method = t.method; // 调用服务端的方法。server side method called
if(e.status){
var answer = Ext.encode(result); // 8
}else{
var msg = e.message; // 失败的信息 failure message
}
}
);
上面的例子中,服务端的“multiply”函数会送入两个参数(2和4)。“multiply”函数就应该返回8,最后变为result变量。
另外,设置enableBuffer为true或false决定是否捆绑多个方法调用在一起。如果指定一个数字表示就等待形成一次批调用的机会(默认为10毫秒)。多个调用按一定的时候聚集在一起然后统一在一次请求中发出,就可以优化程序了,因为减少了服务端之间的往返次数。
配置项namespace则指定了远程供应器的命名空间(默认为浏览器的全局空间window)。完全命名这个空间,或者指定一个String执行隐式命名。
最后介绍PollingProvider似乎更“猛”一些,因为它让笔者感觉Ext有点向Web消息同步的技术挑战,因为我们知道整个Web世界的模型都是从低成本通讯出发的,白话说就是,客户端要什么,就向服务端请求,我答应你就是,我(服务端)可不主动塞信息给你(客户端),也就是说,客户端从Server拿了东西就完事了,,越简单的模型越符合低成本通讯的要求,,,---Web之所以是天下做大的网络,可以想象,诸如窄带等的问题不一而足,条件制约多的很,故所以不能有太奢侈的功能,还是第一代嘛 呵呵。
随着人们的发展(WebIM等等),这方面的需求日益高涨,好比HMTL5就活脱把TCP Stocket拉进来算了。。。
现在Comet长连接/BOSH都是力图先走一步,提供上述问题的解决方案。。。这不,Ext也来奏热闹了,弄了个PollingProvider,比较雏形,我们看看官方的怎么说:
按一定的周期不断轮询服务端。最开始的数据由客户端发出,然后由服务端响应。应该由运行在服务端其余部分的Ext.Direct包来生成PollingProvider的所有配置内容。
创建一个PollingProvider实例可以通过new关键字实现,或者只是指定type = 'polling' 就可以,例如:
var pollA = new Ext.direct.PollingProvider({
type:'polling',
url: 'php/pollA.php',
});
Ext.Direct.addProvider(pollA);
pollA.disconnect();
Ext.Direct.addProvider(
{
type:'polling',
url: 'php/pollB.php',
id: 'pollB-provider'
}
);
var pollB = Ext.Direct.getProvider('pollB-provider');