DWR是一种AJAX(Asynchronous JavaScript and XML)的JAVA实现，它提供了一种能在web浏览器端采用JavaScript语言直接
调用后台业务商业组件的
解决方案。DWR通过 JavaScript直接
调用远程组件可以减少Web开发的时间，特别对于那些具有和
用户频繁交互的Web应用程序。DWR使得浏览器不用刷新
页面就可以 从远程Web服务器取得
用户需的数据，这种无刷新
页面的交互方式大大提高Web
页面的响应时间。至少
用户不会感觉到刷新
页面带来的等待响应心理感觉。 DWR采用浏览器端采用纯JavaScript实现，并且会
自动根据浏览器类型采用最高效率的远程组件
调用机制。DWR目前最新发布的稳定版本为1.0。 本次项目中采用的也是目前的最新发布版本1.0。 1、建立dwr.xml
配置文件 任何一个dwr.xml的
文件都需要包含DWR DOCTYPE的声明行，格式如下： <!DOCTYPE dwr PUBLIC "-//GetAhead Limited//DTD Direct Web Remoting 1.0//EN" "http://www.getahead.ltd.uk/dwr/dwr10.dtd"> 整个
配置文件的大体结构如下： <dwr> <init> <creator id="..." class="..."/> <converter id="..." class="..."/> </init> <allow> <create creator="..." javascript="..." scope="..."> <param name="..." value="..."/> </create> <convert convertor="..." match="..."/> </allow> <signatures> ... </signatures> </dwr> 有几个术语有必要理解,参数叫做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. 虽然你没有声明它，没有东西会加到类的创建列表中。 2、The Converters DWR已经默认定义和初始化了常用的Converter,他们分别如下： <converter id="null" class="uk.ltd.getahead.dwr.convert.NullConverter"/> <converter id="primitive" class="uk.ltd.getahead.dwr.convert.PrimitiveConverter"/> <converter id="bignumber" class="uk.ltd.getahead.dwr.convert.BigNumberConverter"/> <converter id="string" class="uk.ltd.getahead.dwr.convert.StringConverter"/> <converter id="date" class="uk.ltd.getahead.dwr.convert.DateConverter"/> <converter id="array" class="uk.ltd.getahead.dwr.convert.ArrayConverter"/> <converter id="map" class="uk.ltd.getahead.dwr.convert.MapConverter"/> <converter id="collection" class="uk.ltd.getahead.dwr.convert.CollectionConverter"/> <converter id="bean" class="uk.ltd.getahead.dwr.convert.BeanConverter"/> <converter id="hibernate" class="uk.ltd.getahead.dwr.convert.HibernateBeanConverter"/> <converter id="dom" class="uk.ltd.getahead.dwr.convert.DOMConverter"/> <converter id="dom4j" class="uk.ltd.getahead.dwr.convert.DOM4JConverter"/> <converter id="jdom" class="uk.ltd.getahead.dwr.convert.JDOMConverter"/> <converter id="xom" class="uk.ltd.getahead.dwr.convert.XOMConverter"/> <converter id="servlet" class="uk.ltd.getahead.dwr.convert.ServletConverter"/> 这里仅仅是定义了Converter并且简单的放在<converter….>元素之内,任何 的<converter….>元素
内容都有两个必须定义的
属性.是对converter引用的定义和converter能够转换的类的定义. 例如最简单的converter是null converter,它作用是把null和void值转换成javascript的null和undefined值.它是所有converter中最简单 的,就象
调用java的静态
方法一样,所以并不需要创建对象. 默认的时候DWR将java void值转换成javascript的null值就是这样设置<convert converter="null" match="void"/>. 有时java.lang.Void也需要进行这样的转换,所以设置也是相似的<convert converter="null" match="java.lang.Void"/>.从java中传递null值到javascript是没有任何危险性的,所以DWR将这个作为 默认的converter,所以你自己不用再把这个converter
添加到
配置文件的<allow>部分中去. 基本类型的converter转换int,double等.当然还
包括对应的对象形式Integerv,Boolean等等.DWR中在allow预定义了16个配置项目分别用于所有基本类型的转换.就象这样 <convert converter="primitive" match="java.lang.Long"/><convert converter="primitive" match="long"/>. String类型和Date同样预先定义了Converter,这些converter都没有办法进行改变的,所有的String,Date和数值类型都统一采用默认的converter. 2.1 Array Converters Array的配置项目没有上面介绍的那么直观,默认情况下DWR装载所有的基本类型和可装载的对象,这些
包括String,Date等先前介绍的类型.java高级程序员可能会理解为什么match的这行有点奇怪. <convert converter="array" match="[Z"/> <convert converter="array" match="[B"/> <convert converter="array" match="[S"/> <convert converter="array" match="[I"/> <convert converter="array" match="[J"/> <convert converter="array" match="[F"/> <convert converter="array" match="[D"/> <convert converter="array" match="[C"/> <convert converter="array" match="[L*"/> *符号在上面没有提到,其实这是个可以表示任何字符的
通配符号.这些数组可装载的的类型和其他可装载的类型是一样的. 2.2 Bean Converters 一种不能采用默认方式定义的converter就是Bean Converter,这个是将POJO对象转换成javascript相关的数组,反向也一样.基于安全因素的考虑这种类型的converter不能采用默认的方式实现. 假设有个bean并且通过<create ...>语句设置成远程可用,有种类型的参数他本身是一个带有setter的java bean,但setter会产生严重的隐患.攻击者可能促使这隐患的发生.通过下面的语句就可以设置但个类的bean converter <convert converter="bean" match="your.full.package.BeanName"/> 要想允许转换指定包或子包下所有类的转换可以按照下面的设置 <convert converter="bean" match="your.full.package.*"/> 很明显,可以采用下面的方式来转换所有的java bean <convert converter="bean" match="*"/> 2.3 Restricting Property Conversion(指定
属性转换) 将象用exclude和incluce来
通知DWR隔离creator的
方法一样,converter也有一个类似的配置
方法.因为指定
属性转换 只有针对bean才有效(基本类型的转换没有必要指定
属性),这个
功能只能应用与特定的converter即BeanConverter和从次类派生的所 有类.相关配置语法如下 <convert converter="bean" match="com.example.Fred"/> <param name="exclude" value="property1,property2"/> </convert> 这样就可以限定DWR不能
调用Fred对象的getProperty1()和getProperty2()
方法,通常这被成为拒绝访问方式,当然你也可以采用下面的方式配置可以访问的
方法(授权访问方式) <convert converter="bean" match="com.example.Fred"/> <param name="include" value="property1,property2"/> </convert> 较好的安全控制大部分都是采用授权访问方式. 2.4 Collection Converters DWR最后两个默认的converter是Maps和Collections <convert converter="collection" match="java.util.Collection"/> <convert converter="map" match="java.util.Map"/> 通常converter是采用递归
方法转换集合中的所有对象. 这里有两个地方需要注意： 仅仅通过反射
方法没有办法知道集合元素中的类型,所以上面的两个converter能将任何集合转换成相对javascript而言有意义的对 象.然而没有办法将不同的集合类类型分别采用不同的转换
方法.因为没有办法完全
自动进行转换,我们可以应用dwr.xml
文件的special signatures
Syntax配置部分设置类型的转换处理过程. 2.5 DOM Objects 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保留上面的
提示信息的原因. 3 The Creators 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的开发人员并不陌生. 3.1 Uing static methods 如果你想远程
调用一个creator的静态
方法,并且creator是new类型.因为
调用远程bean的
方法前DWR不会检测将要执行的
方法是 不是静态
方法,如果是静态
方法那么creator就不用创建.这种机制可以适用任何类型的creator,但new类型的creator是最简单配置的. 3.2 Security Creator可以配置类的成员
函数的访问权限.creator有授权访问(指明可以被访问的
方法)和拒绝访问(指明不允许访问的
方法)两种配置方式. 如果要设置除了setWibble
方法之外的所有
方法都不可访问可以采用下面的设置. <create creator="new" javascript="Fred"> <param name="class" value="com.example.Fred"/> <exclude method="setWibble"/> </create> 如果采用j2ee访问角色控制的模式 <create creator="new" javascript="Fred"> <param name="class" value="com.example.Fred"/> <auth method="setWibble" role="admin"/> </create> 3.3 The 'spring' Creator 3.4 The 'new' Creator DWR已经默认定义了new creator. <creator id="new" class="uk.ltd.getahead.dwr.create.NewCreator"/> DWR已经将这配置到了内置的dwr.xml
文件中,并不需要进行额外的配置. Creator通过
调用类的默认的构造
方法创建实例.应用new creator有以下几个优点: Ø 安全性 生命周期比较短的creator可以得到更好的安全性,通过不同的应用情况设置适合的生命周期. Ø 低内存开销 在访问量比较大的情况下,可以不用担心发生内存泄露的情况. 配置一个creator的创建和远程
方法调用设置: <allow> <create creator="new" javascript="Blah"> <param name="class" value="java.util.Date"/> </create> ... </allow> 上面的配置信息表示将java.util.date提供给客户端
调用,并且引用
名称是Blash.当你在客户端
调用 Blash.toString(reply)时,
后台将采用java.util.date的默认构造
方法创建一个实例.然后
调用实例的tostring方 法.客户端的javascript将返回给reply对象(此时reply是java.util.date的字符串形式) 3.5 The 'scripted' Creator DWR 已经默认配置了scripted creator配置,<creator id="script" class="uk.ltd.getahead.dwr.create.ScriptedCreator"/>这种类型的creator采用BSF执行脚本语言并返回bean.例如 <allow> ... <create creator="script" javascript="EmailValidator"> <param name="language" value="beanshell"/> <param name="script"> import org.apache.commons.validator.EmailValidator; return EmailValidator.getInstance(); </param> </create> ... </allow> 4 Signatures in dwr.xml Signatures部分用于配置Collections中装载对象元素的类型.举个例子来说:下面的java
代码没有办法对List集合中的对象进行转换. public class Check { public void setLotteryResults(List nos) { ... } } Singatures配置允许我们对DWR要操作的对象类型进行配置.对于了解JDK5泛型编程的开发人员来说下面的格式是很容易理解的. <signatures> <![CDATA[ import java.util.List; import com.example.Check; Check.setLotteryResults(List<Integer> nos); ]]> </signatures> DWR有个专门用于解析上面配置语句的解析器,虽然上面的是JDK5中才有的特性,因为有解析器的原因这也可以应用与JDK5之前的版本. 解析规则是不可见的,但有两种例外情况. 一种情况是因为DWR1.0的解析器中有个Bug,在有些场合会无法处理返回值的类型.所以应该要避免这种情况的发生. 一种情况是因为解析器是一个语法宽松的解析器,他不象编译器一样对语法有非常严格的要求,所有有时可能一些重要的语句没有配置而无法事先发现. <signatures> <![CDATA[ import java.util.List; Check.setLotteryResults(List<Integer>); ]]> </signatures> DWR的将来版本可能会采用符合java官方规范的解析器,这样可以避免许多出错的情况. Signature部分只用于泛型参数到基本类型参数的转换,对于其他的类型DWR采用反射机制或运行时类型来确定.在没有泛型参数的情况下可以不配置Signature. public void method(String p); public void method(String[] p); 下面的就需要配置,因为反射机制无法完成次类
功能. public void method(List<Date> p); public void method(Map<String,WibbleBean> p); 下面可以不用配置,DWR可以
自动完成转换. public void method(List<String> p); public void method(Map<String,String> p); 下面可以不用设置,DWR可以采用运行时转换. public List<Date> method(String p); 有一个值得注意的地方是在javascript中所有对象的keys都是一个字符串,你也可以把其他对象作为keys.他们在使用之前都会转换成字符串形式.DWR1.x将采用这个特性来转换成String.以后对象的转换将会在服务器端完成. 5 Scripting Introduction DWR
生成的javascript
代码和java
代码很相似并通过dwr.xml配置
输出.相比普通java异步
调用之下,通过ajax
生成远程接口和java
代码的最大挑战是AJAX异步
功能. DWR通过引入一个回调
函数，当数据从服务返回数据是
调用这个
函数。有两种推荐的
方法使用回调
函数。一在参数列表加入回调
功能。二
增加调用元数据对象
调用。 也可以将回调的
功能放在参数列表的前头，但是不建议使用这样的
用法,因为在处理
自动HTTP对象时候会出现问题。这些
方法一般会保持向后兼容。 5.1 Simple Callback Functions 假设有个下面的java
方法。 public class Remote { public String getData(int index) { ... } } 在javascript中就可以以下面的方式引用。 <script type="text/javascript" src="[WEBAPP]/dwr/interface/Remote.js"> </script> <script type="text/javascript" src="[WEBAPP]/dwr/engine.js"> </script> ... function handleGetData(str) { alert(str); } Remote.getData(42,handleGetData); “42”只是一个传给getdata
方法的参数。当然你可以采用下面的写法。 Remote.getData(42,function(str) { alert(str); }); 5.2 Call
Meta-Data Objects 另一种使用回调
功能的
方法是指定一个回调
功能选项或其他可选项。上面的例子就变成下面的形式。 Remote.getData(42,{ callback:function(str) { alert(str); } }); 这个
方法具有以下几个优点：可以依照你的编码习惯来编写程序，更重要的是允许你
增加额外的
调用选项。 5.3 Timeouts and Handling Errors 除了使用回调
功能你还可以指定超时时限和
错误处理
方法。例如： Remote.getData(42,{ callback:function(str) { alert(str); },timout:5000,errorHandler:function(message) { alert("Oops: " + message); } }); 5.4 Finding the callback method 下面有几个实例来说明回调
功能各个参数选项的配置,因为javascript是
不支持函数重载的。 Remote.method({ timeout:3 },{ errorHandler:somefunc }); 上面的两个参数一个是bean的参数一个是回调元数据对象。但是没有
方法去区别这两种参数选项。在抛开特定的浏览器环境，我们假设null==undefined，所以具有以下规则： 一、如果一个
函数的每个
调用都是回调
函数，那么他就没有
调用元数据对象，所有的参数都是普通java参数。 二、如果一个最后一个参数具有一个回调
功能，那么这个参数就是
调用元数据对象。其余的就是普通java参数。 三、如果第一个参数为null，我们就认为没有回调
功能。其余的就是普通java参数。此外还要检查最后一个参数是否为null，如果是则会给予
提示信息。 四、如果最后一个参数为null，则没有回调
功能。 五、还有一个不是很好的约定格式，要表示
错误信息。 6 Engin.js
文件 这个
文件是DWR的引擎
文件，他承担着把
后台自动生成的javascript接口与
前台调用之间的衔接责任。所以任何使用DWR的地方都需要这个
文件。 每个使用DWR的
页面都必须引入这个
文件： <script type='text/javascript' src='/[YOUR-WEB-APP]/dwr/engine.js'> </script> 6.1 Call Batching 应用批量
功能可以一次性
调用多个远程bean
方法，因为他是将多个
调用做为一次请求，这就减少了与服务器的交互。可以减少许多的开销。 一个批量
方法调用以DWREngine.beginBatch()开始WREngine.endBatch()结束。当DWREngine.endBatch()被
调用时就说明开始
调用批量
方法，DWR就将这些
方法打包在一起作为一次请求发送给服务器。 DWR会确保所有的
方法都回被
调用，所以使用批量
功能是要注意是否提交了批量
调用，如果没有提交批量
调用那么这些需要
调用的
方法将永远排在
调用队列中直到提交批量
调用。 注意：批量
调用方法会有一些缺点，比如他不能在那些已经帮定在一起的
方法调用顺序不能保证同步。 例如所有的
调用元数据对象的接管
函数，超时设定,
错误处理等的
调用都是在批量的级别上，而不是在
调用的级别上。如果一个批量
调用含有两个不同超时时间设定的
方法，那么除了最后一个之外的所有其他
方法的超时设定都被忽略。 6.2 Call Ordering 因为AJAX是个普通的异步远程
方法调用模式，所以远程
调用的返回结果的顺序可能和你发送请求的顺序不一致。 DWREngine.setOrdered(boolean)
方法允许你设置远程
调用返回结果的顺序和你发送
调用请求的顺序保持一致。DWR是通过一个远 程
方法调用已经结束后在发送下一个
调用请求来实现这个
功能的。 一般情况我们并不需要返回结果顺序和发送请求顺序保持一致。DWR默认是不保持一致的。
提示：因为保持上面的顺序会对应用程序的
性能和响应时间，如果其中的一个消息发生丢失那么浏览器可能会有意想不到以外情况发生。在使用这个
功能的时候必须认真考虑是否真的有必要使用。通常比较好的
方法是使用异步模式
调用。 6.3 Handling Errors and Warnings 对于一些服务器端发生的
错误或警告情况DWR都回
调用默认的
错误和警告
方法并且传递一个相关信息，通常这些发生的
错误和异常对于
用户来说是不可见的。 下面这个
方法主要用于以消息框的方式或者在状态栏里
显示一个
错误或警告的消息。 要改变
错误的处理
方法可以使用这个
方法：DWREngine.setErrorHandler(function),改变警告的处理
方法可以使用这个
方法：DWREngine.setWarningHandler(function). 6.4 Remoting Hooks 参考 DWREngine.setPreHook(function) and DWREngine.setPostHook(function). 如果你想在执行远程
方法调用之前或之后进行一些处理的话，你可以使用上面的两个
方法。上面参数中设置的目标
方法必须是没有参数的。如果你想限制特定的组件在一次
方法调用没有结束之前不允许再次
调用，那么使用上面的
方法将很有用。 Post 执行Hooks通常是设置pre-hooks，一般用来撤消先前的操作。关于Hooks的例子可以参照；DWRUtil.useLoadingMessage()
函数。 6.5 Remoting Options(远程
调用设置) 关于DWR处理远程
调用有若干个设置选项，Method和Verbs对于
用户来说是透明的，但对于不同的浏览器可能会有影响。通常DWR会选择正确的
方法处理，如果想饶过某些浏览器产生的影响这些参数设置将非常有用。 DWREngine.setMethod(newmethod) 设置Method的实际执行
方法，但被设置的
方法不能确保被
调用。只是DWR首先会尝试
调用这个
方法。newmethod 必须是DWREngine.XMLHttpRequest 或着 DWREngine.IFrame. DWREngine.setVerb(verb) 允许设置iframe 和 XMLHttpRequest提交数据时的方式,必须是POST或者GET，如果浏览器
不支持POST形式，DWR会
自动切换到GET方式。
原文链接：https://www.f2er.com/ajax/166722.html
