Ajax是时下比较流行的一种web界面设计新思路,其核心思想是从浏览器获取XMLHttp对象与服务器端进行交互. DWR(Direct Web Remoting)就是实现了这种Ajax技术的一种web框架. 最近做的项目中我也将它用上了,感觉很是方便,比如动态生成javascript代码,隐藏的http协议,java代码和javascript交互的是 javascript的对象(或字符串). 下面是我整理的文档.
DWR主要由两部门组成.javascript与web服务器通信并更新web页；运行在web服务器的Servlet处理请求并把响应发回浏览器.
1.配置web.xml 2.当我们想看dwr自动生成的测试页时,可在java代码
servlet中加
这个参数DWR默认是false.如果选择true.我们可以通过url http://localhost:port/app/dwr ,你就可以看到你部署的每个DWR class.并且可以测试java代码的每个方法是否运行正常.为了安全考虑,在正式环境下你一定把这个参数设为false.
<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>
</servlet-mapping>
<init-param>
<param-name>debug</param-name>
<param-value>true</param-value>
</init-param>
3.log信息配置
我喜欢用log4j输出日志,那么在log4j.properties下加,log4j.logger.uk.ltd.getahead.dwr = debug.这样可以看DWR的调试日志.
4.配置dwr.xml (和web.xml同目录)
这里的多数元素都是可选的 - 你真正必须知道的是指定一个creator和一个javascript名字.
<create creator="new" javascript="JDate">
<param name="class" value="java.util.Date"/>
</create>
creator属性 是必须的 - 它用来指定使用那种创造器.
默认情况下DWR1.1有8种创造器.它们是:
* new: 用Java的new关键字创造对象.
* none: 它不创建对象,看下面的原因. (v1.1+)
* scripted: 通过BSF使用脚本语言创建对象,例如BeanShell或Groovy.
* spring: 通过Spring框架访问Bean.
* jsf: 使用JSF的Bean. (v1.1+)
* struts: 使用Struts的FormBean. (v1.1+)
* pageflow: 访问Beehive或Weblogic的PageFlow. (v1.1+)
javascript属性 用于指定浏览器中这个被创造出来的对象的名字.你不能使用Javascript的关键字.
scope属性 非常类似servlet规范中的scope. 它允许你指定这个bean在什么生命范围.选项有"application", "session", "request" 和"page".这些值对于Servlet和JSP开发者来说应该相当熟悉了.
scope属性是可选的.默认是"page".如果要使用"session"需要cookies.当前的DWR不支持ULR重写.
param元素 被用来指定创造器的其他参数,每种构造器各有不同.例如,"new"创造器需要知道要创建的对象类型是什么.每一个创造器的参数在各自的文档中能找到.请查看上面的链接.
include和exclude元素 允许创造器来限制类中方法的访问.一个创造器必须指定include列表或exclude列表之一.如果是include列表则暗示默认的访问策略是"拒绝"；如果是exclude列表则暗示默认的访问策略是"允许".
5.dwr.jar下载后放lib下
源码浅析
dwr的设计很象webwork2的设计,隐藏http协议,扩展性,兼容性及强.
通过研究uk.ltd.getahead.dwr.DWRServlet这个servlet来研究下dwr到底是如何工作的.
这样/dwr/*下的所有的请求都是由这个servlet来处理,到底生理了什么呢,我们还是以例子来说明吧.
<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>
</servlet-mapping>
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()方法中已经初始化了.
代码
public void handle(HttpServletRequest req, HttpServletResponse resp)
throws IOException
...{
String pathinfo = req.getPathInfo();
if(pathinfo == null || pathinfo.length() == 0 || pathinfo.equals("/"))
...{
resp.sendRedirect(req.getContextPath() + req.getServletPath() + ''''/'''' + "index.html");
} else
if(pathinfo != null && pathinfo.equalsIgnoreCase("/index.html"))
...{
doIndex(req, resp);
} else
if(pathinfo != null && pathinfo.startsWith("/test/"))
...{
doTest(req, resp);
} else
if(pathinfo != null && pathinfo.equalsIgnoreCase("/engine.js"))
...{
doFile(resp, "engine.js", "text/javascript");
} else
if(pathinfo != null && pathinfo.equalsIgnoreCase("/util.js"))
...{
doFile(resp, "util.js", "text/javascript");
} else
if(pathinfo != null && pathinfo.equalsIgnoreCase("/deprecated.js"))
...{
doFile(resp, "deprecated.js", "text/javascript");
} else
if(pathinfo != null && pathinfo.startsWith("/interface/"))
...{
doInterface(req, resp);
} else
if(pathinfo != null && pathinfo.startsWith("/exec"))
...{
doExec (req, resp);
} else
...{
log.warn("Page not found. In debug/test mode try viewing /[WEB-APP]/dwr/");
resp.sendError(404);
}
}
(1)dwr/index.html,dwr/test/这种只能在debug模式下使用,调试用.
dwr/engine.js,dwr/util.js,dwr/deprecated.js当这个请求到达,从dwr.jar包中读取文件流,响应回去.(重复请求有缓存)
(2)当dwr/interface/这种请求到来,(例如我们在index.html中的 <script type=''''text/javascript'''' src=''''dwr/interface/JDate.js''''></script>)DWR做一件伟大的事.把我们在WEB- INF/dwr.xml中的
<create creator="new" javascript="JDate">
<param name="class" value="java.util.Date"/>
</create>
java.util.Date转化为javascript函数.
http://localhost:port/simpledwr/dwr/interface/JDate.js看看吧.
细节也比较简单,通过java反射,把方法都写成javascript特定的方法.(我觉得这些转换可以放到缓存里,下次调用没必要再生成一遍,不知道作者为什么没这样做).
(3)dwr/exec
javascript调用方法时发送这种请求,可能是XMLHttpRequest或IFrame发送.
当然,javascript调用的方法签名与java代码一致,包括参数,还有javascript的回调方法也传到了服务器端,在服务器端很容易实现.回调方法的java的执行结果 返回类似 <script>callMethod(结果)<script>的javascript字符串,在浏览器执行.哈,一切就这么简单,巧妙.