分类: Java
2008-11-19 16:14:16
任何一个dwr.xml的文件都需要包含DWR DOCTYPE的声明行,格式如下:
"-//GetAhead Limited//DTD Direct Web Remoting 1.0//EN"
"http://www.getahead.ltd.uk/dwr/dwr10.dtd">
整个配置文件的大体结构如下:
...
有几个术语有必要理解,参数叫做converted,远程Bean叫做created.如果远程Bean A有个方法A.blah(B),那么你需要为A建立一个created,为B建立一个converted.
配置文件init部分声明那些用于建立远程bean和在方法调用中转换bean的类.这部分是可选择性配置的,多数情况下可以不必使用它,如果你想定义一个新的creator或者converter那么就必须在部分中声明,but do double check on the ones that are currently available first.
在init部分的作用是告诉DWR一些类实例和关于这些类怎样运行的信息.实际上并不会使用.这有点向java中的import语句,多数类在使用之前需要引入,但引入了类并不意味着这些在使用,每个creator和converter需要有个id属性来允许以后进行引用.
配置文件的allow部分定义哪些类可以建立和转换,每个被准许的类都可以有一个'create'或者'convert'配置行.下面列出的类的转换在默认情况下不需要进一步的设置.
1、所有基本类型,boolean,int,double等等
2、基本类型的对象形式实现的类,Boolean,Integer等等
3、java.lang.String
4、java.util.date 和三个SQL形式的派生类
5、以上所有类型的数组形式
6、以上所有类型的集合,List,Set,Map(有些局限性)
However nothing is added to the list of classes that can be created (i.e. put up for remoting) without you declaring it.
DWR已经默认定义和初始化了常用的Converter,他们分别如下:
class="uk.ltd.getahead.dwr.convert.NullConverter"/>
class="uk.ltd.getahead.dwr.convert.PrimitiveConverter"/>
class="uk.ltd.getahead.dwr.convert.BigNumberConverter"/>
class="uk.ltd.getahead.dwr.convert.StringConverter"/>
class="uk.ltd.getahead.dwr.convert.DateConverter"/>
class="uk.ltd.getahead.dwr.convert.ArrayConverter"/>
class="uk.ltd.getahead.dwr.convert.MapConverter"/>
class="uk.ltd.getahead.dwr.convert.CollectionConverter"/>
class="uk.ltd.getahead.dwr.convert.BeanConverter"/>
class="uk.ltd.getahead.dwr.convert.HibernateBeanConverter"/>
class="uk.ltd.getahead.dwr.convert.DOMConverter"/>
class="uk.ltd.getahead.dwr.convert.DOM4JConverter"/>
class="uk.ltd.getahead.dwr.convert.JDOMConverter"/>
class="uk.ltd.getahead.dwr.convert.XOMConverter"/>
这里仅仅是定义了Converter并且简单的放在
例如最简单的converter是null converter,它作用是把null和void值转换成javascript的null和undefined值.它是所有converter中最简单的,就象调用java的静态方法一样,所以并不需要创建对象.
默认的时候DWR将java void值转换成javascript的null值就是这样设置
. 有时java.lang.Void也需要进行这样的转换,所以设置也是相似的
基本类型的converter转换int,boolean,double等.当然还包括对应的对象形式Integerv,Boolean等等.DWR中在allow预定义了16个配置项目分别用于所有基本类型的转换.就象这样
String类型和Date同样预先定义了Converter,这些converter都没有办法进行改变的,所有的String,Date和数值类型都统一采用默认的converter.
Array的配置项目没有上面介绍的那么直观,默认情况下DWR装载所有的基本类型和可装载的对象,这些包括String,Date等先前介绍的类型.java高级程序员可能会理解为什么match的这行有点奇怪.
*符号在上面没有提到,其实这是个可以表示任何字符的通配符号.这些数组可装载的的类型和其他可装载的类型是一样的.
一种不能采用默认方式定义的converter就是Bean Converter,这个是将POJO对象转换成javascript相关的数组,反向也一样.基于安全因素的考虑这种类型的converter不能采用默认的方式实现.
假设有个bean并且通过
要想允许转换指定包或子包下所有类的转换可以按照下面的设置
很明显,可以采用下面的方式来转换所有的java bean
将象用exclude和incluce来通知DWR隔离creator的方法一样,converter也有一个类似的配置方法.因为指定属性转换只有针对bean才有效(基本类型的转换没有必要指定属性),这个功能只能应用与特定的converter即BeanConverter和从次类派生的所有类.相关配置语法如下
这样就可以限定DWR不能调用Fred对象的getProperty1()和getProperty2()方法,通常这被成为拒绝访问方式,当然你也可以采用下面的方式配置可以访问的方法(授权访问方式)
较好的安全控制大部分都是采用授权访问方式.
DWR最后两个默认的converter是Maps和Collections
通常converter是采用递归方法转换集合中的所有对象.
这里有两个地方需要注意:
仅仅通过反射方法没有办法知道集合元素中的类型,所以上面的两个converter能将任何集合转换成相对javascript而言有意义的对象.然而没有办法将不同的集合类类型分别采用不同的转换方法.因为没有办法完全自动进行转换,我们可以应用dwr.xml文件的special signatures syntax配置部分设置类型的转换处理过程.
DWR 自动将DOM、DOM4J、JDOM和XOM转换成DOM树,前面这几种类型都仅仅返回Document,Element,Node.DWR会自动将这些转换成浏览器DOM对象.通常在启动JDOM Converter时会有一个提示信息,除非你想采用JDOMconverter否则可以忽略.
INFO: Missing classdef for converter 'jdom'. Failed to load uk.ltd.getahead.dwr.convert.JDOMConverter. Cause: org/jdom/Document
因为DWR没有办法知道你是否采用jdom converter,所以提示信息是info级别.如果你想采用jdom converter,你必须很清楚地知道jdom converter是否可以被加载.这就是DWR保留上面的提示信息的原因.
DWR共有三种Creator,最简单的”new”是调用bean的默认构造函数创建实例.”scripted”允许采用其他脚本语言创建实例.如BeanShell.在远程bean的默认构造函数不能进行进一步配置的情况下这种类型的creator比较有用.”Spring”类型允许你通过spring创建实例.
下面是关于creator的参考资料和配置参数说明.
Creator |
Parameter |
User |
new |
class |
类的全名称(包括包路径) |
scripted |
language |
BSF框架支持的脚本语言名称(BSF为apache项目) |
scripted |
script |
返回远程对象的脚本,脚本可以指定一些属性,多数情况下一般只设置param节点配置.属性很少设置. |
spring |
Location* |
任何以location开头的参数,每个参数都是指定一个spring的配置文件,在参数没有设置的情况下DWR会去读取spring的全局的配置文件. |
spring |
beanName |
从配置文件中读取的bean的名称 |
“scope参数允许你配置creator的生命周期,共有以下几个选项:application,session,request,page.这些参数对于用过jsp或servlet的开发人员并不陌生.
如果你想远程调用一个creator的静态方法,并且creator是new类型.因为调用远程bean的方法前DWR不会检测将要执行的方法是不是静态方法,如果是静态方法那么creator就不用创建.这种机制可以适用任何类型的creator,但new类型的creator是最简单配置的.
Creator可以配置类的成员函数的访问权限.creator有授权访问(指明可以被访问的方法)和拒绝访问(指明不允许访问的方法)两种配置方式.
如果要设置除了setWibble方法之外的所有方法都不可访问可以采用下面的设置.
如果采用j2ee访问角色控制的模式
DWR已经默认定义了new creator.
Creator通过调用类的默认的构造方法创建实例.应用new creator有以下几个优点:
Ø 安全性
生命周期比较短的creator可以得到更好的安全性,通过不同的应用情况设置适合的生命周期.
Ø 低内存开销
在访问量比较大的情况下,可以不用担心发生内存泄露的情况.
配置一个creator的创建和远程方法调用设置:
...
上面的配置信息表示将java.util.date提供给客户端调用,并且引用名称是Blash.当你在客户端调用Blash.toString(reply)时,后台将采用java.util.date的默认构造方法创建一个实例.然后调用实例的tostring方法.客户端的javascript将返回给reply对象(此时reply是java.util.date的字符串形式)
DWR 已经默认配置了scripted creator配置,
...
import org.apache.commons.validator.EmailValidator;
return EmailValidator.getInstance();
...
Signatures部分用于配置Collections中装载对象元素的类型.举个例子来说:下面的java代码没有办法对List集合中的对象进行转换.
public class Check
{
public void setLotteryResults(List nos)
{
...
}
}
Singatures配置允许我们对DWR要操作的对象类型进行配置.对于了解JDK5泛型编程的开发人员来说下面的格式是很容易理解的.
import java.util.List;
import com.example.Check;
Check.setLotteryResults(List
]]>
DWR有个专门用于解析上面配置语句的解析器,虽然上面的是JDK5中才有的特性,因为有解析器的原因这也可以应用与JDK5之前的版本.
解析规则是不可见的,但有两种例外情况.
一种情况是因为DWR1.0的解析器中有个Bug,在有些场合会无法处理返回值的类型.所以应该要避免这种情况的发生.
一种情况是因为解析器是一个语法宽松的解析器,他不象编译器一样对语法有非常严格的要求,所有有时可能一些重要的语句没有配置而无法事先发现.
import java.util.List;
Check.setLotteryResults(List
]]>
DWR的将来版本可能会采用符合java官方规范的解析器,这样可以避免许多出错的情况.
Signature部分只用于泛型参数到基本类型参数的转换,对于其他的类型DWR采用反射机制或运行时类型来确定.在没有泛型参数的情况下可以不配置Signature.
public void method(String p);
public void method(String[] p);
下面的就需要配置,因为反射机制无法完成次类功能.
public void method(List
public void method(Map
下面可以不用配置,DWR可以自动完成转换.
public void method(List
public void method(Map
下面可以不用设置,DWR可以采用运行时转换.
public List
有一个值得注意的地方是在javascript中所有对象的keys都是一个字符串,你也可以把其他对象作为keys.他们在使用之前都会转换成字符串形式.DWR1.x将采用这个特性来转换成String.以后对象的转换将会在服务器端完成.