配置DWR - dwr.xml

配置DWR - dwr.xml

dwr.xml是DWR的配置文件。默认情况下，应该把它放到WEB-INF目录(web.xml的目录)下。

DTD

这里还有一个dwr.xml对应的DTD文档以及一个用DTDDoc生成的参考手册。

创建dwr.xml文件

dwr.xml文件的结构如下:

<!DOCTYPE dwr PUBLIC
    "-//GetAhead Limited//DTD Direct Web Remoting 1.0//EN"
    "http://www.getahead.ltd.uk/dwr/dwr10.dtd">

<dwr>

  <!-- init is only needed if you are extending DWR -->
  <init>
    <creator id="..." class="..."/>
    <converter id="..." class="..."/>
  </init>

  <!-- without allow, DWR isn't allowed to do anything -->
  <allow>
    <create creator="..." javascript="..."/>
    <convert converter="..." match="..."/>
  </allow>

  <!-- you may need to tell DWR about method signatures -->
  <signatures>
    ...
  </signatures>

</dwr>

术语

这里是一些必须理解的术语 - 参数会被converted，远程Bean会被created。所以如果你有一个叫A的bean，它有一个方法叫A.blah(B) 那么你需要一个A的creator和一个B的converter。

<allow>

allow段落里面定义的试DWR可以创建和转换的类。

Creators

我们要调用的每个类都需要一个<create ...>定义。creator有几种。比较通用的是new关键字和Spring。更多的信息可以参见[Creaters]文档。

Converters

我们必须保证所有的参数都可以被转换。JDK中的多数类型已经有转换器了，但是你需要给DWR转换你的代码的权利。一般来说JavaBean的参数需要一个<convert ...>定义。

默认情况下，如下类型不需要定义就可以转换：

• 所有的原生类型 boolean,int,double, 等等
• 原生类型的对象类型 Boolean,Integer,等等
• java.lang.String
• java.util.Date 和SQL中的Date
• 以上类型组成的数组
• 以上类型的集合类型 (Lists, Sets, Maps, Iterators, 等)
• 从DOM, XOM, JDOM 和 DOM4J中的DOM对象 (类似 Element 和 Document)

要了解如何转换你的JavaBean或者其他类型的参数请查看Converters文档。

<init>

可选的init部分用来声明创造bean的类和转换bean的类。多数情况下你不需要用到他们。如果你需要定义一个新的Creator [JavaDoc] 和 Converter [JavaDoc] ， 那么你就需要在这里定义他们。但是建议你现检查一下DWR是不是已经支持了。

在init部分里有了定义只是告诉DWR这些扩展类的存在，给出了如何使用的信息。这时他们还没有被使用。这中方式很像Java中的import语句。多数类需要在使用前先import一下，但是只有import语句并不表明这个类已经被使用了。每一个creator和converter都用id属性，以便后面使用。

<signatures>

DWR使用反射来找出在转换时应该用那种类型。有时类型信息并不明确，这时你可以在这里写下方法的签名来明确类型。详细信息查看Signatures部分。

多个dwr.xml文件

可以有多个dwr.xml文件(详细信息见web.xml文档)。每个文件中的定义会被加在一起。DWR用这个功能来加载基础配置文件。我们可以看看标准被配置文件来了解dwr.xml的内容。

Converters
Creators
Signatures