DWR(Direct Web Remoting)

DWR(Direct Web Remoting)是一个WEB远程调用框架.利用这个框架可以让AJAX开发变得很简单.利用DWR可以在客户端利用JavaScript直接调用服务 端的Java方法并返回值给JavaScript就好像直接本地客户端调用一样(DWR根据Java类来动态生成JavaScrip代码).它的最新版本 DWR0.6添加许多特性如:支持Dom Trees的自动配置,支持Spring(JavaScript远程调用spring bean),更好浏览器支持,还支持一个可选的commons-logging日记操作.

http://getahead.ltd.uk/dwr/
这段时间较闲,研究了一番dwr.发现dwr实现的AJAX有些地方确实很是先进.比如动态生成javascript代码;隐藏的http协议;javascript于java代码交互的是javascript对象(或字符串)等.
以下是我临时译的一些东西.本来想全译,发现dwr实在是简单,就随便写了.英文居差,现一把.

1、DWR: Easy AJAX for JAVA

作为一个java open source library,DWR可以帮助开发人员完成应用AJAX技术的web程序。它可以让浏览器上的javascript方法调用运行在web服务器上java方法。

DWR主要由两部门组成。javascript与web服务器通信并更新web页；运行在web服务器的Servlet处理请求并把响应发回浏览器。

DWR采用新颖的方法实现了AJAX(本来也没有确切的定义)，在java代码基础上动态的生成javascript代码。web开发者可以直接调 用这些javascript代码，然而真正的代码是运行在web服务器上的java code。出与安全考虑，开发者必须配置哪些java class暴露给DWR.(dwr.xml)

这种从(java到javascript)调用机制给用户一种感觉，好象常规的RPC机制，或RMI or SOAP.但是它运行在web上，不需要任何浏览器插件。

DWR不认为浏览器和web服务器之间协议重要，把系统界面放在首位。最大挑战是java method call的同步特征与ajax异步特性之间的矛盾。在异步模型里，结果只有在方法结束后才有效。DWR解决了这个问题，把回调函数当成参数传给方法，处理 完成后，自动调用回调方法。

这个图表显示了，通过javascript事件，DWR能改变select的内容，当然这些内容由java代码返回。 javascript函数Data.getOptions(populateList)由DWR动态生成，这个函数会调用java class Data类的方法。DWR处理如何远程调用，包括转换所有的参数和返回的结果（javascript\java）。java方法执行完后，执行回调方法 populateList。在整个过程中我们就想在用本地的方法一样。

2、Getting Started

废话少说，试试就ok了。
web.xml

 

dwr-invoker
uk.ltd.getahead.dwr.DWRServlet


dwr-invoker
/dwr/*

dwr.xml 与web.xml同目录

index.html



<script src="dwr/interface/JDate.js" type="text/javascript"></script>
<script src="dwr/engine.js" type="text/javascript"></script>
<script type="text/javascript"></script>

dwr.jar 下载放lib下

完了，什么，够了，就这些。访问ok!
3、Examples
http://www.aboutmyhealth.org/ 这不是Google Suggest吗!ok.
4、源码浅析
dwr的设计很象webwork2的设计,隐藏http协议,扩展性，兼容性及强。

通过研究uk.ltd.getahead.dwr.DWRServlet这个servlet来研究下dwr到底是如何工作滴。

代码

1. web.xml配置  
2. <servlet>  
3.     <servlet-name>dwr-invokerservlet-name>  
4.     <servlet-class>uk.ltd.getahead.dwr.DWRServletservlet-class>  
5.   servlet>  
6.   <servlet-mapping>  
7.     <servlet-name>dwr-invokerservlet-name>  
8.     <url-pattern>/dwr/*url-pattern>  
9. servlet-mapping>  

<script type="text/javascript"></script>
这样所有的/ dwr/*所有请求都由这个servlet来处理，它到底处理了些什么能。我们还以上面最简单的例子来看。
1、 web服务器启动， DWRServlet init()方法调用，init主要做了以下工作。
设置日志级别、实例化 DWR用到的单例类（这些类在jvm中只有一个实例对象）、读去配置文件（包括 dwr.jar包中的 dwr.xml,WEB-INF/ dwr.xml. config*.xml）。
2、请求处理
DWRServlet.doGet, doPost方法都调用processor.handle(req, resp)方法处理。Processor对象在init()方法中已经初始化了。

代码

1. public void handle(HttpServletRequest req, HttpServletResponse resp)  
2.         throws IOException  
3.     {  
4.         String pathinfo = req.getPathInfo();  
5.         if(pathinfo == null || pathinfo.length() == 0 || pathinfo.equals("/"))  
6.         {  
7.             resp.sendRedirect(req.getContextPath() + req.getServletPath() + '/' + "index.html");  
8.         } else  
9.         if(pathinfo != null && pathinfo.equalsIgnoreCase("/index.html"))  
10.         {  
11.             doIndex(req, resp);  
12.         } else  
13.         if(pathinfo != null && pathinfo.startsWith("/test/"))  
14.         {  
15.             doTest(req, resp);  
16.         } else  
17.         if(pathinfo != null && pathinfo.equalsIgnoreCase("/engine.js"))  
18.         {  
19.             doFile(resp, "engine.js", "text/javascript");  
20.         } else  
21.         if(pathinfo != null && pathinfo.equalsIgnoreCase("/util.js"))  
22.         {  
23.             doFile(resp, "util.js", "text/javascript");  
24.         } else  
25.         if(pathinfo != null && pathinfo.equalsIgnoreCase("/deprecated.js"))  
26.         {  
27.             doFile(resp, "deprecated.js", "text/javascript");  
28.         } else  
29.         if(pathinfo != null && pathinfo.startsWith("/interface/"))  
30.         {  
31.             doInterface(req, resp);  
32.         } else  
33.         if(pathinfo != null && pathinfo.startsWith("/exec"))  
34.         {  
35.             doExec(req, resp);  
36.         } else  
37.         {  
38.             log.warn("Page not found. In debug/test mode try viewing /[WEB-APP]/dwr/");  
39.             resp.sendError(404);  
40.         }  
41.     }  

<script type="text/javascript"></script>
哦。这些恍然大悟。 dwr/*处理的请求也就这几种。
（1） dwr/index.html， dwr/test/这种只能在debug模式下使用，调试用。
dwr/engine.js， dwr/util.js， dwr/deprecated.js当这个请求到达，从 dwr.jar包中读取文件流，响应回去。（重复请求有缓存）
（2）当 dwr/interface/这种请求到来，（例如我们在index.html中的 <script src="dwr/interface/JDate.js" type="text/javascript"></script> ） DWR做一件伟大的事。把我们在WEB- INF/ dwr.xml中的



java.util.Date转化为javascript函数。
http://localhost:port/simple dwr/ dwr/interface/JDate.js看看吧。
细节也比较简单，通过java反射，把方法都写成javascript特定的方法。（我觉得这些转换可以放到缓存里，下次调用没必要再生成一遍，不知道作者为什么没这样做）。
（3） dwr/exec
javascript调用方法时发送这种请求，可能是XMLHttpRequest或IFrame发送。
当然，javascript调用的方法签名与java代码一致，包括参数，还有javascript的回调方法也传到了服务器端，在服务器端很容 易实现。回调方法的java的执行结果 返回类似 <script type="text/javascript"></script>
2、当我们想看 DWR自动生成的测试页（Using debug/test mode）时，可在

代码

1. servlet中加  
2. <init-param>  
3.   <param-name>debugparam-name>  
4.   <param-value>trueparam-value>  
5. init-param>  

<script type="text/javascript"></script> 这 个参数 DWR默认是false.如果选择true.我们可以通过url http://localhost:port/app/ dwr ,你就可以看到你部署的每个 DWR class。并且可以测试java代码的每个方法是否运行正常。为了安全考虑，在正式环境下你一定把这个参数设为false.
3、logging信息配置。
在无java.util.logging的jdk1.3下运行 DWR,我们不希望强制用户加一个logging包，而是用 HttpServlet.log()方法来输出日志。如果classpath中包括logging jar包， DWR自动切换用logging输出日志。
如果用HttpServlet.log()方法，以下配置是有效的。

代码

1. <init-param>  
2.  <param-name>logLevelparam-name>  
3.  <param-value>DEBUGparam-value>  
4. init-param>  

<script type="text/javascript"></script> 有效的值是 FATAL, ERROR, WARN (the default), INFO and DEBUG

我是喜欢用log4j输出日志，那么在log4j.properties下加，log4j.logger.uk.ltd.getahead.dwr = debug。这样可以看DWR的调试日志。
4、多dwr.xml文件的配置
可能有几种情况，我们一一列举。 一个servlet,多个dwr.xml配置文件；多个servlet，每个servlet对应一个或多个dwr.xml.
一个servlet,多个dwr.xml配置文件；

代码

1. <servlet>  
2.     <servlet-name>dwr-invokerservlet-name>  
3.     <servlet-class>uk.ltd.getahead.dwr.DWRServletservlet-class>   
4.     <init-param>  
5.       <param-name>config-1param-name>  
6.       <param-value>WEB-INF/dwr1.xmlparam-value>  
7.     init-param>  
8.     <init-param>  
9.       <param-name>config-2param-name>  
10.       <param-value>WEB-INF/dwr2.xmlparam-value>  
11.     init-param>  
12. servlet>  

<script type="text/javascript"></script> 在 这种配置下，param-name的值必须以config开头。param-name可以有>=0个。如果没有param-name，那么将会读取 WEB-INF/ dwr.xml。如果有大于零个param-name，那么WEB-INF/ dwr.xml文件将不会被读取。

多个servlet，每个servlet对应一个或多个dwr.xml

代码

1. <servlet>  
2.    <servlet-name>dwr-invokerservlet-name>  
3.     <servlet-class>uk.ltd.getahead.dwr.DWRServletservlet-class>   
4.   
5. servlet>  
6. <servlet>  
7.    <servlet-name>dwr-invoker1servlet-name>  
8.    <servlet-class>uk.ltd.getahead.dwr.DWRServletservlet-class>   
9.    <init-param>  
10.      <param-name>config-adminparam-name>  
11.      <param-value>WEB-INF/dwr1.xmlparam-value>  
12.    init-param>  
13.    <init-param>  
14.      <param-name>debugparam-name>  
15.      <param-value>trueparam-value>  
16.    init-param>  
17. servlet>  
18. <servlet-mapping>  
19.    <servlet-name>dwr-invokerservlet-name>  
20.    <url-pattern>/dwr/*url-pattern>  
21. servlet-mapping>  
22. <servlet-mapping>  
23.    <servlet-name>dwr-invoker1servlet-name>  
24.    <url-pattern>/dwr1/*url-pattern>  
25. servlet-mapping>  

<script type="text/javascript"></script> 在这种情况下，我们可以根据J2EE security来控制权限，针对不同url,加不同的角色。
5、 dwr的几个扩展点（Plug-ins）
DWR对以下接口提供的默认的实现，用户可以继承 DWR的默认实现类来达到我们想要的效果。但这至少需要我们读了 DWR源码才能做这些工作( dwr源码很是清晰，有兴趣可以学习一下)，以后可能补存这部分。

代码

1. uk.ltd.getahead.dwr.AccessControl      
2. uk.ltd.getahead.dwr.Configuration   
3. uk.ltd.getahead.dwr.ConverterManager   
4. uk.ltd.getahead.dwr.CreatorManager   
5. uk.ltd.getahead.dwr.Processor   
6. uk.ltd.getahead.dwr.ExecutionContext  
   

• simpledwr.rar (137.9 KB)
• 描述: simpledwr
• 下载次数: 190

• 
• 描述: howitworks.png
• 大小: 34.5 KB