分类： Java
2008-11-19 16:15:19
DWR生成的javascript代码和java代码很相似并通过dwr.xml配置输出.相比普通java异步调用之下,通过ajax生成远程接口和java 代码的最大挑战是AJAX异步功能.
DWR通过引入一个回调函数，当数据从服务返回数据是调用这个函数。有两种推荐的方法使用回调函数。一在参数列表加入回调功能。二增加调用元数据对象调用。
也可以将回调的功能放在参数列表的前头，但是不建议使用这样的用法,因为在处理自动HTTP对象时候会出现问题。这些方法一般会保持向后兼容。
假设有个下面的java方法。
public class Remote
{
public String getData(int index) { ... }
}
在javascript中就可以以下面的方式引用。
...
function handleGetData(str)
{
alert(str);
}
Remote.getData(42, handleGetData);
“
Remote.getData(42, function(str) { alert(str); });
另一种使用回调功能的方法是指定一个回调功能选项或其他可选项。上面的例子就变成下面的形式。
Remote.getData(42, {
callback:function(str) { alert(str); }
});
这个方法具有以下几个优点：可以依照你的编码习惯来编写程序，更重要的是允许你增加额外的调用选项。
除了使用回调功能你还可以指定超时时限和错误处理方法。例如：
Remote.getData(42, {
callback:function(str) { alert(str); },
timout:5000,
errorHandler:function(message) { alert("Oops: " + message); }
});
下面有几个实例来说明回调功能各个参数选项的配置,因为javascript是不支持函数重载的。
Remote.method({ timeout:3 }, { errorHandler:somefunc });
上面的两个参数一个是bean的参数一个是回调元数据对象。但是没有方法去区别这两种参数选项。在抛开特定的浏览器环境，我们假设null==undefined，所以具有以下规则：
一、如果一个函数的每个调用都是回调函数，那么他就没有调用元数据对象，所有的参数都是普通java参数。
二、如果一个最后一个参数具有一个回调功能，那么这个参数就是调用元数据对象。其余的就是普通java参数。
三、如果第一个参数为null，我们就认为没有回调功能。其余的就是普通java参数。此外还要检查最后一个参数是否为null，如果是则会给予提示信息。
四、如果最后一个参数为null，则没有回调功能。
五、还有一个不是很好的约定格式，要表示错误信息。
这个文件是DWR的引擎文件，他承担着把后台自动生成的javascript接口与前台调用之间的衔接责任。所以任何使用DWR的地方都需要这个文件。
每个使用DWR的页面都必须引入这个文件：
应用批量功能可以一次性调用多个远程bean方法，因为他是将多个调用做为一次请求，这就减少了与服务器的交互。可以减少许多的开销。
一个批量方法调用以DWREngine.beginBatch()开始WREngine.endBatch()结束。当DWREngine.endBatch()被调用时就说明开始调用批量方法，DWR就将这些方法打包在一起作为一次请求发送给服务器。
DWR会确保所有的方法都回被调用，所以使用批量功能是要注意是否提交了批量调用，如果没有提交批量调用那么这些需要调用的方法将永远排在调用队列中直到提交批量调用。
注意：批量调用方法会有一些缺点，比如他不能在那些已经帮定在一起的方法调用顺序不能保证同步。
例如所有的调用元数据对象的接管函数，超时设定,错误处理等的调用都是在批量的级别上，而不是在调用的级别上。如果一个批量调用含有两个不同超时时间设定的方法，那么除了最后一个之外的所有其他方法的超时设定都被忽略。
因为AJAX是个普通的异步远程方法调用模式，所以远程调用的返回结果的顺序可能和你发送请求的顺序不一致。DWREngine.setOrdered(boolean)方法允许你设置远程调用返回结果的顺序和你发送调用请求的顺序保持一致。DWR是通过一个远程方法调用已经结束后在发送下一个调用请求来实现这个功能的。
一般情况我们并不需要返回结果顺序和发送请求顺序保持一致。DWR默认是不保持一致的。
提示：因为保持上面的顺序会对应用程序的性能和响应时间，如果其中的一个消息发生丢失那么浏览器可能会有意想不到以外情况发生。在使用这个功能的时候必须认真考虑是否真的有必要使用。通常比较好的方法是使用异步模式调用。
对于一些服务器端发生的错误或警告情况DWR都回调用默认的错误和警告方法并且传递一个相关信息，通常这些发生的错误和异常对于用户来说是不可见的。
下面这个方法主要用于以消息框的方式或者在状态栏里显示一个错误或警告的消息。
要改变错误的处理方法可以使用这个方法：DWREngine.setErrorHandler(function),
改变警告的处理方法可以使用这个方法：DWREngine.setWarningHandler(function).
参考 DWREngine.setPreHook(function) and DWREngine.setPostHook(function).
如果你想在执行远程方法调用之前或之后进行一些处理的话，你可以使用上面的两个方法。上面参数中设置的目标方法必须是没有参数的。如果你想限制特定的组件在一次方法调用没有结束之前不允许再次调用，那么使用上面的方法将很有用。
Post 执行Hooks通常是设置pre-hooks，一般用来撤消先前的操作。关于Hooks的例子可以参照；DWRUtil.useLoadingMessage() 函数。
关于DWR处理远程调用有若干个设置选项，Method和Verbs对于用户来说是透明的，但对于不同的浏览器可能会有影响。通常DWR会选择正确的方法处理，如果想饶过某些浏览器产生的影响这些参数设置将非常有用。
DWREngine.setMethod(newmethod)
设置Method的实际执行方法，但被设置的方法不能确保被调用。只是DWR首先会尝试调用这个方法。newmethod 必须是DWREngine.XMLHttpRequest 或着 DWREngine.IFrame.
DWREngine.setVerb(verb)
允许设置iframe 和 XMLHttpRequest提交数据时的方式,必须是POST或者GET，如果浏览器不支持POST形式，DWR会自动切换到GET方式。
