“scope参数允许你配置creator的生命周期,共有以下几个选项:application,session,request,page.这些参数对于用过jsp或servlet的开发人员并不陌生.

3.1 Uing static methods

如果你想远程调用一个creator的静态方法,并且creator是new类型.因为调用远程bean的方法前DWR不会检测将要执行的方法是不是静态方法,如果是静态方法那么creator就不用创建.这种机制可以适用任何类型的creator,但new类型的creator是最简单配置的.

3.2 Security

Creator可以配置类的成员函数的访问权限.creator有授权访问(指明可以被访问的方法)和拒绝访问(指明不允许访问的方法)两种配置方式.

如果要设置除了setWibble方法之外的所有方法都不可访问可以采用下面的设置.

<create creator="new" javascript="Fred">

  <param name="class" value="com.example.Fred"/>

  <exclude method="setWibble"/>

</create>

如果采用j2ee访问角色控制的模式

<create creator="new" javascript="Fred">

  <param name="class" value="com.example.Fred"/>

  <auth method="setWibble" role="admin"/>

</create>

3.3 The 'spring' Creator

3.4 The 'new' Creator

DWR已经默认定义了new creator.

<creator id="new" class="uk.ltd.getahead.dwr.create.NewCreator"/>DWR已经将这配置到了内置的dwr.xml文件中,并不需要进行额外的配置.

Creator通过调用类的默认的构造方法创建实例.应用new creator有以下几个优点:

?         安全性   

生命周期比较短的creator可以得到更好的安全性,通过不同的应用情况设置适合的生命周期.

?         低内存开销

在访问量比较大的情况下,可以不用担心发生内存泄露的情况.

配置一个creator的创建和远程方法调用设置:

<allow>

  <create creator="new" javascript="Blah">

    <param name="class" value="java.util.Date"/>

  </create>

  ...

</allow>

上面的配置信息表示将java.util.date提供给客户端调用,并且引用名称是Blash.当你在客户端调用Blash.toString(reply)时,后台将采用java.util.date的默认构造方法创建一个实例.然后调用实例的tostring方法.客户端的javascript将返回给reply对象(此时reply是java.util.date的字符串形式)

3.5 The 'scripted' Creator

DWR 已经默认配置了scripted creator配置,

<creator id="script" class="uk.ltd.getahead.dwr.create.ScriptedCreator"/>这种类型的creator采用BSF执行脚本语言并返回bean.例如

<allow>

  ...

  <create creator="script" javascript="EmailValidator">

    <param name="language" value="beanshell"/>

    <param name="script">

      import org.apache.commons.validator.EmailValidator;

      return EmailValidator.getInstance();

    </param>

  </create>

  ...

</allow>

4 Signatures in dwr.xml

Signatures部分用于配置Collections中装载对象元素的类型.举个例子来说:下面的java代码没有办法对List集合中的对象进行转换.

public class Check

{

  public void setLotteryResults(List nos)

  {

      ...

  }

}

Singatures配置允许我们对DWR要操作的对象类型进行配置.对于了解JDK5泛型编程的开发人员来说下面的格式是很容易理解的.

<signatures>

  <![CDATA[

  import java.util.List;

  import com.example.Check;

  Check.setLotteryResults(List<Integer> nos);

  ]]>

</signatures>

DWR有个专门用于解析上面配置语句的解析器,虽然上面的是JDK5中才有的特性,因为有解析器的原因这也可以应用与JDK5之前的版本.

解析规则是不可见的,但有两种例外情况.

一种情况是因为DWR1.0的解析器中有个Bug,在有些场合会无法处理返回值的类型.所以应该要避免这种情况的发生.

一种情况是因为解析器是一个语法宽松的解析器,他不象编译器一样对语法有非常严格的要求,所有有时可能一些重要的语句没有配置而无法事先发现.

<signatures>

  <![CDATA[

  import java.util.List;

  Check.setLotteryResults(List<Integer>);

  ]]>

</signatures>

DWR的将来版本可能会采用符合java官方规范的解析器,这样可以避免许多出错的情况.

Signature部分只用于泛型参数到基本类型参数的转换,对于其他的类型DWR采用反射机制或运行时类型来确定.在没有泛型参数的情况下可以不配置Signature.

public void method(String p);

public void method(String[] p);

下面的就需要配置,因为反射机制无法完成次类功能.

public void method(List<Date> p);

public void method(Map<String, WibbleBean> p);

下面可以不用配置,DWR可以自动完成转换.

public void method(List<String> p);

public void method(Map<String, String> p);

下面可以不用设置,DWR可以采用运行时转换.

public List<Date> method(String p);

有一个值得注意的地方是在javascript中所有对象的keys都是一个字符串,你也可以把其他对象作为keys.他们在使用之前都会转换成字符串形式.DWR1.x将采用这个特性来转换成String.以后对象的转换将会在服务器端完成.

5 Scripting Introduction

DWR生成的javascript代码和java代码很相似并通过dwr.xml配置输出.相比普通java异步调用之下,通过ajax生成远程接口和java 代码的最大挑战是AJAX异步功能.

DWR通过引入一个回调函数，当数据从服务返回数据是调用这个函数。有两种推荐的方法使用回调函数。一在参数列表加入回调功能。二增加调用元数据对象调用。

也可以将回调的功能放在参数列表的前头，但是不建议使用这样的用法,因为在处理自动HTTP对象时候会出现问题。这些方法一般会保持向后兼容。

5.1 Simple Callback Functions

假设有个下面的java方法。

public class Remote

{

    public String getData(int index) { ... }

}

在javascript中就可以以下面的方式引用。

<script type="text/javascript"

    src="[WEBAPP]/dwr/interface/Remote.js"> </script>

<script type="text/javascript"

    src="[WEBAPP]/dwr/engine.js"> </script>

...

function handleGetData(str)

{

  alert(str);

}

Remote.getData(42, handleGetData);

“42”只是一个传给getdata方法的参数。当然你可以采用下面的写法。

Remote.getData(42, function(str) { alert(str); });

5.2 Call Meta-Data Objects

另一种使用回调功能的方法是指定一个回调功能选项或其他可选项。上面的例子就变成下面的形式。

Remote.getData(42, {

  callback:function(str) { alert(str); }

});

这个方法具有以下几个优点：可以依照你的编码习惯来编写程序，更重要的是允许你增加额外的调用选项。

5.3 Timeouts and Handling Errors

除了使用回调功能你还可以指定超时时限和错误处理方法。例如：

Remote.getData(42, {

  callback:function(str) { alert(str); },

  timout:5000,

  errorHandler:function(message) { alert("Oops: " + message); }

});

5.4 Finding the callback method

下面有几个实例来说明回调功能各个参数选项的配置,因为javascript是不支持函数重载的。

Remote.method({ timeout:3 }, { errorHandler:somefunc });

上面的两个参数一个是bean的参数一个是回调元数据对象。但是没有方法去区别这两种参数选项。在抛开特定的浏览器环境，我们假设null==undefined，所以具有以下规则：

一、如果一个函数的每个调用都是回调函数，那么他就没有调用元数据对象，所有的参数都是普通java参数。

二、如果一个最后一个参数具有一个回调功能，那么这个参数就是调用元数据对象。其余的就是普通java参数。

三、如果第一个参数为null，我们就认为没有回调功能。其余的就是普通java参数。此外还要检查最后一个参数是否为null，如果是则会给予提示信息。

四、如果最后一个参数为null，则没有回调功能。

五、还有一个不是很好的约定格式，要表示错误信息。

6 Engin.js文件

这个文件是DWR的引擎文件，他承担着把后台自动生成的javascript接口与前台调用之间的衔接责任。所以任何使用DWR的地方都需要这个文件。

每个使用DWR的页面都必须引入这个文件：

<script type='text/javascript'

    src='/[YOUR-WEB-APP]/dwr/engine.js'>

</script>

6.1 Call Batching

应用批量功能可以一次性调用多个远程bean方法，因为他是将多个调用做为一次请求，这就减少了与服务器的交互。可以减少许多的开销。

一个批量方法调用以DWREngine.beginBatch()开始WREngine.endBatch()结束。当DWREngine.endBatch()被调用时就说明开始调用批量方法，DWR就将这些方法打包在一起作为一次请求发送给服务器。

DWR会确保所有的方法都回被调用，所以使用批量功能是要注意是否提交了批量调用，如果没有提交批量调用那么这些需要调用的方法将永远排在调用队列中直到提交批量调用。

注意：批量调用方法会有一些缺点，比如他不能在那些已经帮定在一起的方法调用顺序不能保证同步。

例如所有的调用元数据对象的接管函数，超时设定,错误处理等的调用都是在批量的级别上，而不是在调用的级别上。如果一个批量调用含有两个不同超时时间设定的方法，那么除了最后一个之外的所有其他方法的超时设定都被忽略。

6.2 Call Ordering

因为AJAX是个普通的异步远程方法调用模式，所以远程调用的返回结果的顺序可能和你发送请求的顺序不一致。DWREngine.setOrdered(boolean)方法允许你设置远程调用返回结果的顺序和你发送调用请求的顺序保持一致。DWR是通过一个远程方法调用已经结束后在发送下一个调用请求来实现这个功能的。

一般情况我们并不需要返回结果顺序和发送请求顺序保持一致。DWR默认是不保持一致的。

提示：因为保持上面的顺序会对应用程序的性能和响应时间，如果其中的一个消息发生丢失那么浏览器可能会有意想不到以外情况发生。在使用这个功能的时候必须认真考虑是否真的有必要使用。通常比较好的方法是使用异步模式调用。

6.3 Handling Errors and Warnings

对于一些服务器端发生的错误或警告情况DWR都回调用默认的错误和警告方法并且传递一个相关信息，通常这些发生的错误和异常对于用户来说是不可见的。

下面这个方法主要用于以消息框的方式或者在状态栏里显示一个错误或警告的消息。

要改变错误的处理方法可以使用这个方法：DWREngine.setErrorHandler(function),

改变警告的处理方法可以使用这个方法：DWREngine.setWarningHandler(function).

6.4 Remoting Hooks

参考 DWREngine.setPreHook(function) and DWREngine.setPostHook(function).

如果你想在执行远程方法调用之前或之后进行一些处理的话，你可以使用上面的两个方法。上面参数中设置的目标方法必须是没有参数的。如果你想限制特定的组件在一次方法调用没有结束之前不允许再次调用，那么使用上面的方法将很有用。

Post 执行Hooks通常是设置pre-hooks，一般用来撤消先前的操作。关于Hooks的例子可以参照；DWRUtil.useLoadingMessage() 函数。

6.5 Remoting Options(远程调用设置)

关于DWR处理远程调用有若干个设置选项，Method和Verbs对于用户来说是透明的，但对于不同的浏览器可能会有影响。通常DWR会选择正确的方法处理，如果想饶过某些浏览器产生的影响这些参数设置将非常有用。

DWREngine.setMethod(newmethod)

设置Method的实际执行方法，但被设置的方法不能确保被调用。只是DWR首先会尝试调用这个方法。newmethod 必须是DWREngine.XMLHttpRequest 或着 DWREngine.IFrame.

DWREngine.setVerb(verb)