DWR文档之dwr.xml

原文出处: http://www.javatang.com/archives/2007/03/11/3030123.html
翻译: Jet Mah
声明: 请维持文章的完整性任意转载

dwr.xml 是用来配置DWR的文件。默认情况下需要将其同web.xml一起放在WEB-INF文件夹中。

DTD
这里有一个用于 dwr.xml的 DTD文档,另外还有一个用DTDDoc创建的参考文档

创建 dwr.xml 文件
dwr.xml 文件结构如下:











...


术语
一些术语是值得去理解的 - 参数会被 转换(converted),但是远程的beans会被创建(created)。因此如果bean A有一个方法 A.blah(B),那么需要一个A的创建器(creator) 和 B 的转换器(converter)

(1) <allow>
allow部分定义的是DWR可以创建和转换的类。

(2) Creators
每个被调用的类都需要一个 <create …> 来定义。有几种类型的creator,最常用的是“new”关键字和Spring框架。更多的信息请参考 Creator 文档。

(3) Converters
所有的参考都需要被转换。你有权限转换JDK所提供的多数类型,但是需要给DWR权限来转换你自己的代码。也就是说JavaBean参数需要一个 <convert …> 来定义。

默认情况下下述类型可以直接被转换:

  • 所有的基本类型,比如boolean、int、double等等
  • 基本类型的对象类如Boolean、Integer等
  • java.lang.String
  • java.util.Date 和 SQL 表达式
  • 上述类型的数组
  • 上述类型的集合类 (Lists、Sets、Maps、Iterators等)
  • 从DOM、XOM、JDOM和DOM4J创建的DOM对象(像Element和Document)

具体怎样转换你自己的JavaBeans和其他参数请参考Converter 文档。

(4) <init>
init部分是可选的,用来声明用来创建和转换beans的类。大多数情况下你用不到它。如果你想定义一个新的Creator [JavaDoc] 和 Converter [JavaDoc] 的话,需要在此声明。不过务必检查你所使用的DWR是否以及支持上述功能了。

init部分只是告诉DWR存在这个类,并且给出了这个类的一些基本的运行信息。但这些类并没有开始使用,这点有点类似Java中的import语句。大多数类在使用前必须被导入,但是声明导入并不意味着类开始被使用。每个 creator 和 converter 都有一个id属性,这样方便后面调用。

(5) <signatures>
DWR 使用映射来确定哪些类型需要被转换。有的时候这些类型信息不明确,这时你可以在此写下方法的签名来指明其类型。更多细节请参考signatures 部分。

多个 dwr.xml 文件

可以有一个以上的 dwr.xml 文件 (更多细节可参考 web.xml 文档 )。每个文件中的节点会被整合在一起。这个功能可以使DWR来加载基础配置文件来运行每个文件。

我们可以通过查看标准的配置文件对 dwr.xml 进行一个良好的认识。

英文出处:
http://getahead.org/dwr/server/dwrxml
DWR文档翻译文档列表:
http://www.javatang.com/dwr-chinese-documents/

发表评论

电子邮件地址不会被公开。 必填项已用*标注