下面是从一个实例的构建过程进行分析。
1、DWR 介绍
DWR是一个可以允许你去创建AJAX WEB 站点的JAVA 开源库。它可以让你在浏览器中的Javascript代码调用Web服务器上的Java 代码,就像在Java代码就在浏览器中一样。
DWR包含 2个主要部分:
(1) 一个运行在服务器端的Java Servlet,它处理请求并且向浏览器发回响应。
(2) 运行在浏览器端的JavaScript,它发送请求而且还能动态更新网页。
DWR工作原理是通过动态把Java类生成为Javascript。它的代码就像Ajax魔法一样,你感觉调用就像发生在浏览器端,但是实际上代码调用发生在服务器端,DWR负责数据的传递和转换。这种从Java 到JavaScript的远程调用功能的方式使DWR用起来有种非常像RMI或者SOAP的常规RPC机制,而且DWR的优点在于不需要任何的网页浏览器插件就能运行在网页上。
2、DWR 配置文件说明
web.xml
<servlet> <servlet-name>dwr</servlet-name> <!-- 如果是dwr1.x 的话,下面的class为:uk.ltd.getahead.dwr.DWRServlet --> <servlet-class>org.directwebremoting.servlet.DwrServlet</servlet-class> <!-- 在开发期间,把这个设成true,有助于调试,可通过 http://localhost/XXXX(应用空间名)/dwr 进行查看 --> <init-param> <param-name>debug</param-name> <param-value>true</param-value> </init-param> </servlet> <servlet-mapping> <servlet-name>dwr</servlet-name> <url-pattern>/dwr/*</url-pattern> </servlet-mapping>
关于这个配置文件,没什么好说的,等深入了解后再做解析。。
dwr.xml
<dwr> <!-- 仅当需要扩展DWR时才需要,这里不做例子,等深入分析后才做介绍 --> <!-- <init> <creator id="..." class="..." /> <converter id="..." class="..." /> </init> --> <allow> <create javascript="UserDao" creator="new" scope="session"> <param name="class" value="user.UserDao"></param> <!-- 也可以设置不可访问的方法 <exclude method="xxx"/> --> <!-- 设置可访问的方法 --> <include method="say" /> <include method="getUser" /> <include method="setDates" /> </create> <!-- 声明的javascript 调用Bean--> <convert match="user.User" converter="bean"> <param name="include" value="id,name"></param> </convert> </allow> <!-- 使DWR能确定集合中存放的数据类型 --> <signatures> <![CDATA[ import java.util.Date; public void setDates(List<Date> dates); ]]> </signatures> </dwr>
配置的参数简单分析:
(详细分析,请参考dwr 文档)
<init>标签
这个初始化部分申明被用来创建远程beans 而且这个类能被用来以某种过程转换。大多数例子你将不需要
用它,如果你想去定义一个新的Creator 或者Converter,就要在此被申明。
<allow>标签
allow部分定义了DWR能够创建和转换的类。
<create> 标签
每一个在类中被调用的方法需要一个<create …>有若干类型的creator,使用“new”关键字或者Spring 框架等。
<convert>标签
我们需要确认所有的参数能被转换。 许多JDK提供的类型使你能够使用,但是你如果要转换你自己的代码,就必须告诉DWR。一般是指JavaBean 的参数需要一个<convert…>标签作为入口。
<signatures>标签
DWR使用反射机制在转换过程中找到它应该使用的类型。有时候类型的信息无法获得,在这种情况下你要在此处用方法签名给予暗示。
signatures段使DWR能确定集合中存放的数据类型。例如下面的定义中我们无法知道list中存放的是什么类型。
3、Html 分析
<html> <head> <title>dwr-demo</title> <!-- javascript 能访问的类都要在此设定,命名以javascript 属性为准,结合dwr.xml <create javascript="UserDao" creator="new" scope="session"> --> <script type="text/javascript" src="/dwr-dome/dwr/interface/UserDao.js"></script> <!--这个属性必须设定 --> <script type="text/javascript" src="/dwr-dome/dwr/engine.js"></script> <!--当用到dwr 集成的javascript 工具类时要设定 --> <script type="text/javascript" src="/dwr-dome/dwr/util.js"></script> <!-- 外部的javascript 文件 --> <script type="text/javascript" src="/dwr-dome/user.js"></script> </head> <body> <form id="userform"> <input type="text" id="name" name="name"> <input type="button" onclick="say()" value="say"> <input type="button" onclick="getuser()" value="getuser"> <input type="button" onclick="setdates()" value="setdates"> </form> <font color="red"><div id="say"></div> </font> <font color="red"><div id="getuser"></div> </font> <font color="red"><div id="setdates"></div> </font> </body> </html>
分析:
engine.js文件
engine.js对 DWR非常重要,因为它是用来转换来至动态生成的接口的javascript 函数调用的,所以只要用到DWR的地方就需要它。
util.js文件
util.js包含了一些工具函数来帮助你用javascript 数据(例如从服务器返回的数据)来更新你的 web页面。你可以在DWR以外使用它,因为它不依赖于DWR的其他部分。你可以下载整个DWR或者单独下载.
这个工具类能使dwr 更加方便的使用,具体的函数分析,请参考dwr文档。
4、外面的js 文件(user.js)
function say(){ var name=$("name").value; UserDao.say(name,callback); } function callback(data){ $("say").innerHTML=data; } function getuser(){ UserDao.getUser(calluser); } function calluser(user){ var info="you id is "+user.id+" .you name is "+user.name; $("getuser").innerHTML=info; } function setdates(){ var list=[new Date(),new Date()]; UserDao.setDates(list,calldate); } function calldate(datestring){ $("setdates").innerHTML=datestring; }
这个文件主要应用到了dwr 的util.js 的工具类。还有关于回调函数这两方面比较重要。
关于回调函数,主要是在java 类函数的基础上,加多个参数,
如在java 中的函数:UserDao.say(name); 在javascript的函数(包括回调):UserDao.say(name,callback);
有篇文章分析的很多,请参考: http://blog.sina.com.cn/s/blog_496aa28601000738.html
实际的运行结果图:
其他的文件没什么可分析的,请参考下面给出的源码。
关于在做这个实例的时候遇到的几个问题:
1、dwr2.05 中除了加入dwr.jar 还必须加入commons-logging.jar,不然会报错。。
2、在dwr.xml 配置中 <create javascript="UserDao" creator="new" scope="session">
scope 应设为session,在getuser中才能取得User 的属性值。
下面给出一些参考的网站:
DWR 中文文档 : http://wiki.javascud.org/display/dwrcn/Home