DWR可以让你在浏览器中的Javascript代码调用Web服务器上的Java,就像是Java代码就在浏览器中一样。
DWR主要包括两部分:
在服务器上运行的Servlet来处理请求并把结果返回浏览器。
运行在浏览器上的Javascript,可以发送请求,并动态改变页面。
DWR会根据你的Java类动态的生成Javascript代码。这些代码的魔力是让你感觉整个Ajax调用都是在浏览器上
发生的,但事实上是服务器执行了这些代码,DWR负责数据的传递和转换。
这一过程不需要额外的浏览器插件。
下载地址 http://directwebremoting.org/dwr/download
配置文件dwr.xml 默认情况下,应该把它放到WEB-INF下的lib目录(同web.xml的目录)下
结构如下:
<?xml version="1.0" encoding="UTF-8"?> <!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.test(B) 那么你需要一个A的creator和一个B的converter。
<allow>段落里面定义的是DWR可以创建和转换的类。
<create>定义我们要调用的每个类。creator有几种,比较通用的是new关键字和Spring。
<convert>一般来说JavaBean的参数需要一个<convert ...>定义,我们必须保证所有的参数都可以被转换。JDK中的多数类型已经有转换器了,但是你需要给DWR转换你的代码的权利。
默认情况下,如下类型不需要定义就可以转换:
- 所有的原生类型 boolean,int,double, 等等
- 原生类型的对象类型 Boolean,Integer,等等
- java.lang.String
- java.util.Date 和SQL中的Date
- 以上类型组成的数组
- 以上类型的集合类型 (Lists, Sets, Maps, Iterators, 等)
- 从DOM, XOM, JDOM 和 DOM4J中的DOM对象 (类似 Element 和 Document)
<init>可选的init部分用来声明创造bean的类和转换bean的类。多数情况下不需要用到他们。如果需要定义一个新的Creator 和 Converter , 那么就需要在这里定义他们。但是建议先检查一下DWR是不是已经支持了。
在init部分里有了定义只是告诉DWR这些扩展类的存在,给出了如何使用的信息。这时他们还没有被使用。这中方式很像Java中的import语句。多数类需要在使用前先import一下,但是只有import语句并不表明这个类已经被使用了。每一个creator和converter都用id属性,以便后面使用。
<signatures>DWR使用反射来找出在转换时应该用哪种类型。有时类型信息并不明确,这时就可以在这里写下方法的签名来明确类型。
其实,一个项目中可以有多个dwr.xml文件,每个文件中的定义会被加在一起。
DWR提供了两个Javascript库:
DWR不是一个通用的Javascript库,所以我们尽可能使那些非远程调用相关的功能清晰。尽管如此,util.js有一些小功能会使工作更加容易。
将dwr.jar放到应该把它放到WEB-INF下的lib目录下:
配置web.xml:
<servlet> <servlet-name>dwr-invoker</servlet-name> <servlet-class>uk.ltd.getahead.dwr.DWRServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>dwr-invoker</servlet-name> <url-pattern>/dwr/*</url-pattern><!--dwr也可以写成别的,只是导入js时要注意路径--> </servlet-mapping>
在页面上使用要用到dwr的javascript库:
<script type="text/javascript" src="dwr/engine.js"></script> <script type="text/javascript" src="dwr/util.js"></script>
相关要用的要自己导入,但要存在于interface包下,如:
<script type="text/javascript" src="dwr/interface/math.js"></script>
上面的js文件来源于dwr.xml的配置:
<allow> <create javascript="math" creator="new"> <param name="class" value="java.lang.Math"></param> </create> </allow>
使用math.js:
//输出随机数 function mm(){ math.random(getm); <--使用Math的方法random--> } function getm(data){ alert(data); }
<button οnclick="mm();">Math</button>
点击Math按钮即可得到一个随机数字。这就是dwr的简单使用。
想学dwr,http://wiki.javascud.org/display/dwrcn/Home是个好地方。