The Creators – 创造器

dwr.xml文件中的create元素的结构如下：

<allow>
  <create creator="..." javascript="..." scope="...">
    <param name="..." value="..."/>
    <auth method="..." role="..."/>
    <exclude method="..."/>
    <include method="..."/>
  </create>
  ...
</allow>

这里的多数元素都是可选的 - 你真正必须知道的是指定一个creator和一个javascript名字。

creator属性 是必须的 - 它用来指定使用那种创造器。

默认情况下DWR1.1有8种创造器。它们是：

new: 用Java的new关键字创造对象。
none: 它不创建对象，看下面的原因。 (v1.1+)
scripted: 通过BSF使用脚本语言创建对象，例如BeanShell或Groovy。
spring: 通过Spring框架访问Bean。
jsf: 使用JSF的Bean。 (v1.1+)
struts: 使用Struts的FormBean。 (v1.1+)
pageflow: 访问Beehive或Weblogic的PageFlow。 (v1.1+)

如果你需要写自己的创造器，你必须在init部分注册它。

javascript属性 用于指定浏览器中这个被创造出来的对象的名字。你不能使用Javascript的关键字。

scope属性 非常类似servlet规范中的scope。它允许你指定这个bean在什么生命范围。选项有"application", "session", "request" 和"page"。这些值对于Servlet和JSP开发者来说应该相当熟悉了。

scope属性是可选的。默认是"page"。如果要使用"session"需要cookies。当前的DWR不支持ULR重写。

param元素 被用来指定创造器的其他参数，每种构造器各有不同。例如，"new"创造器需要知道要创建的对象类型是什么。每一个创造器的参数在各自的文档中能找到。请查看上面的链接。

include和exclude元素 允许创造器来限制类中方法的访问。一个创造器必须指定include列表或exclude列表之一。如果是include列表则暗示默认的访问策略是"拒绝"；如果是exclude列表则暗示默认的访问策略是"允许"。

例如要拒绝防范除了setWibble()以外的所有方法，你应该把如下内容添加到dwr.xml中。

<create creator="new" javascript="Fred">
  <param name="class" value="com.example.Fred"/>
  <include method="setWibble"/>
</create>

对于加入到create元素中的类的所有方法都是默认可见的。

auth元素 允许你指定一个J2EE的角色作为将来的访问控制检查:

<create creator="new" javascript="Fred">
  <param name="class" value="com.example.Fred"/>
  <auth method="setWibble" role="admin"/>
</create>

'none' 创造器

'none' 创造器不创建任何对象 - 它会假设你不需要创建对象。这有可能是对的，有两个原因。

你可能在使用的scope不是"page"(看上面)，并在在前面已经把这个对象创建到这个scope中了，这时你就不需要再创建对象了。

还有一种情况是要调用的方法是静态的，这时也不需要创建对象。DWR会在调用创建器之前先检查一下这个方法是不是静态的。

对于上诉两种情况，你仍然需要class参数，用来告诉DWR它是在操作的对象类型是什么。

使用静态方法

DWR会在调用创建器之前先检查一下这个方法是不是静态的，如果是那么创造器不会被调用。很显然这个逻辑适用于所有创造器，尽管如此"null"创造器是最容易配置的。

适用单例类

对于单例类的创建，最好适用BeanShell和BSF来实例化对象。详细信息参见'Scripted'创造器

其他创造器

我么偶尔也需要一些新的创造器，最常见的是一个EjbCreator。讨论新的创造器的好地方是在邮件列表。

DWR和HttpSessionBindingListeners

DWR1.x中存贮已经创造的Bean的方法需要注意，它在每次请求时都会调用相同的 setAttribute() 方法。就是说，如果一个Bean在dwr.xml中的声明周期设置为session，再每次调用bean中的方法时，DWR都会执行一次 session.setAttribute(yourBean) 。这看上去没有什么危害，但是如果你要使用servlet的事件机制的，就是说用了HttpSessionBindingListener接口，你就会发现valueBound和valueUnbound事件在每次调用时都会发生，而不是你想像的在bean被创建时以及session过期时。

DWR2 只在第一次创建对象时调用 setAttribute() 。