dwr.xml 配置
dwr.xml 是你用来配置 DWR 的文件，默认是将其放入 WEB-INF 文件夹。
创建一个 dwr.xml 文件
dwr.xml 有如下的结构：
1 <?xml version="1.0" encoding="UTF-8"?> 2 <!DOCTYPE dwr PUBLIC 3 "-//GetAhead Limited//DTD Direct Web Remoting 3.0//EN" 4 "http://getahead.org/dwr/dwr30.dtd"> 5 6 <dwr> 7 <!-- 仅当需要扩展DWR时才需要 --> 8 <init> 9 <creator class="..." id="..."/> 10 <converter class="..." id="..."/> 11 </init> 12 13 <!-- 没有它DWR什么也做不了 --> 14 <allow> 15 <create creator="..." javascript="..."></create> 16 <convert match="..." converter="..."></convert> 17 </allow> 18 19 <!-- 有必要告诉DWR方法签名 --> 20 <signatures>...</signatures> 21 </dwr>
<init>标签
这个初始化部分申明被用来创建远程 beans 而且这个类能被用来以某种过程转换。大多数例子你将不需要用它，如果你想去定义一个新的 Creator 或者 Converter，就要在此被申明。
在 init 部分里有了定义只是告诉 DWR 这些扩展类的存在，给出了如何使用的信息。这时他们还没有被使用。这种方式很像 Java 中的 import 语句。多数类需要在使用前先 import 一下，但是只有 import 语句并不表明这个类已经被使用了。每一个 creator 和 converter 都用 id 属性，以便后面使用。
<allow>标签
allow 部分定义了 DWR 能够创建和转换的类。
Creator
每一个在类中被调用的方法需要一个<create …>有若干类型的 creator，使用“new”关键字或者 Spring 框架等。
create 元素是如下的结构
1 <allow> 2 <create creator="..." javascript="..." scope="..."> 3 <param name="..." value=".."/> 4 <auth role="..." method="..."/> 5 <exclude method="..."/> 6 <include method="..."/> 7 </create> 8 9 ... 10 11 </allow>
1、create 属性
¤new：Java 用“new”关键字创造对象
是 DWR 默认的 creator，如下所示
1 <create id="new" class="org.directwebremoting.create.NewCreator"/>
没有必要把它加入 dwr.xml，它已经在 DWR 内部文件了。
这个 creator 将使用默认构造器创建类的实例，以下是用 new 创建器的好处
√ 安全:DWR 创造的对象生存的时间越短，多次调用中间的值不一致的错误机会越少。
√ 内存消耗低： 如果你的站点用户量非常大，这个创造器可以减少 VM 的内存溢出。
¤ none: 它不创建对象，看下面的原因。 (v1.1+)
none 创建器不创建任何对象，它会假设你不须要创建对象。有 2 个使用的原因：
√ 你可能在使用的 scope 不是"page"(看上面)，并在在前面已经把这个对象创建到这个 scope 中了，这时你就不需要再创建对象了。
√ 还有一种情况是要调用的方法是静态的，这时也不需要创建对象。DWR 会在调用创建器之前先检查一下这个方法是不是静态的。
对于上诉两种情况，你仍然需要 class 参数，用来告诉 DWR 它是在操作的对象类型是什么。
¤scripted: 通过BSF使用脚本语言创建对象，例如BeanShell或Groovy。
要使用这个创造器，你需要把一些辅助库放到 WEB-INF/lib 文件夹下：比如 BSF 的 jar 包 ，你要用的脚本语言的 jar 包 。
new 创造器在 DWR 中已经默认声明了：
<creator id="script" class="uk.ltd.getahead.dwr.create.ScriptedCreator"/>
这个创造器用 BSF 来执行脚本得到 Bean，例如：
1 <allow> 2 ... 3 <create creator="script" javascript="EmailValidator"> 4 <param name="language" value="beanshell" /> 5 <param name="script"> 6 import org.apache.commons.validator.EmailValidator; 7 return EmailValidator.getInstance(); 8 </param> 9 </create> 10 ... 11 </allow> 12 <signatures>...</signatures> 13 </dwr>
2、javascript 属性
在浏览器里给你创建的对象命名。避免使用 JavaScript 保留字。这个名字将在页面里作为 js 被导入
dwr.xml
1 <create creator="new" javascript="service"> 2 <param name="class" value="web.service.Service"/> 3 </create>
html/jsp
1 <html> 2 <head> 3 … 4 <script type='text/javascript' src='dwr/interface/service.js'> 5 …
3、scope 属性
和定义在 servlet 的 scope 一样大的范围，它允许你指定哪个 bean 是可以获得的。选项可以是：application,session, request 和 page。这些值应该已经被开发者们熟悉了。
scope 选项是可选的，默认为 page， 使用 session 请求 cookies。目前，DWR 还不支持 URL 重写。
4、param 元素
被用来指定创造器的其他参数，每种构造器各有不同。例如，"new"创造器需要知道要创建的对象类型是什么。每一个创造器的参数在各自的文档中能找到。
5、include 和 exclude 元素
允许一个创造器去限制进入类的方法。一个创造器必须指定 include 列表或 exclude 列表之一。如果是include 列表则暗示默认的访问策略是"拒绝"，include 中的每个方法就是允许访问的方法；如果是 exclude列表则暗示默认的访问策略是"允许"，exclude 中的每个方法就是拒绝访问的方法。
<create creator="new" javascript="Fred"> <param name="class" value="com.example.Fred" /> <include method="setWibble" /> </create>
说明你只能在 DWR 中使用 Fred 的是 setWibble 方法。
6、auth 元素
允许你指定一个 J2EE 的角色作为将来的访问控制检查:
1 <create creator="new" javascript="Fred"> 2 <param name="class" value="com.example.Fred" /> 3 <auth method="setWibble" role="admin" /> 4 </create>
7、使用静态方法
DWR 会在调用创建器之前先检查一下这个方法是不是静态的，如果是那么创造器不会被调用。很显然这个逻辑适用于所有创造器，尽管如此"null"创造器是最容易配置的。
8、使用单例类
对于单例类的创建，最好适用 BeanShell 和 BSF 来实例化对象。
9、DWR 与 HttpSessionBindingListeners
DWR1.x 中存贮已经创造的 Bean 的方法需要注意，它在每次请求时都会调用相同的 setAttribute() 方法。就是说，如果一个 Bean 在 dwr.xml 中的声明周期设置为 session，再每次调用 bean 中的方法时，DWR都会执行一次 session.setAttribute(yourBean) 。这看上去没有什么危害，但是如果你要使用 servlet 的事件机制的，就是说用了 HttpSessionBindingListener 接口，你就会发现 valueBound 和 valueUnbound 事件在每次调用时都会发生，而不是你想像的在 bean 被创建时以及 session 过期时。
DWR2 只在第一次创建对象时调用 setAttribute() 。
====================================================
Converter
我们需要确认所有的参数能被转换。许多 JDK 提供的类型使你能够使用，但是你如果要转换你自己的代码，就必须告诉 DWR。一般是指 JavaBean 的参数需要一个<convert…>标签作为入口。
你不需要在 dwr.xml 中<allow>部分的<convert>中定义。它们默认支持。
•所有主要的类型，boolean, int , double 等等。
•包装类，Boolean, Integer 等等。
•java.lang.String
•java.util.Date 和 java.sql.Times，java.sql.Timestamp。
•数组(存放以上类型的)
•集合类型 (List, Set, Map, Iterator 等等) (存放以上类型的)
•DOM 对象(来自于 DOM, XOM, JDOM 和 DOM4J)
================================================
<signatures>标签
DWR 使用反射机制在转换过程中找到它应该使用的类型。有时候类型的信息无法获得，在这种情况下你要在此处用方法签名给予暗示。
signatures 段使 DWR 能确定集合中存放的数据类型。例如下面的定义中我们无法知道 list 中存放的是什么类型。
1 public class Check { 2 public void setLotteryResults(List nos) 3 { 4 ... 5 } 6 }
signatures 段允许我们暗示 DWR 应该用什么类型去处理。格式对以了解 JDK5 的泛型的人来说很容易理解。
1 <signatures> 2 <![CDATA[ 3 import java.util.List; 4 import com.example.Check; 5 Check.setLotteryResults(List<Integer> nos); 6 ]]> 7 </signatures>
