DWR学习详解

condor_mk7

浏览: 44590 次
性别:
来自: 南京

最近访客更多访客>>

小灬安

1754575407

shizhe0612

labmem_000

博主相关

博客

微博

相册

留言

关于我

文章分类

全部博客 (38)

社区版块

存档分类

DWR JavaScript Java Web XML

DWR的原理为：把JAVA类注入JS从且达到可以在JS中调用JAVA类中的方法，实现了异步调用。
同GWT相比DWR的优点有
一、ＤＷＲ可以同ＪＳ和ＨＴＭＬ同步调用，从且解决ＧＷＴ中页面美工排版的困难。
二、dwr是把ＪＡＶＡ类注入ＪＳ中，而不需要学习新的技术。

web.xml文件配置如下：
<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<servlet>
<servlet-name>dwr-invoker</servlet-name>
<servlet-class>
   org.directwebremoting.servlet.DwrServlet
</servlet-class>
<init-param>
   <param-name>debug</param-name>
   <param-value>true</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>dwr-invoker</servlet-name>
<url-pattern>/dwr/*</url-pattern>
</servlet-mapping>
</web-app>
dwr文件配置如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE dwr PUBLIC "-//GetAhead Limited//DTD Direct Web Remoting 2.0//EN" "http://www.getahead.ltd.uk/dwr/dwr20.dtd">
<dwr>
<allow>
<create creator="new" javascript="service">
   <param name="class" value="cn.epem.admin.Service" />
</create>
</allow>
</dwr>

test.jsp

<%@ page language="java" pageEncoding="UTF-8"%>
<html>
<head>
<title>My JSP 'first_dwr.jsp' starting page</title>
<script type="text/javascript" src="<%=request.getContextPath()%>/loadreport.js"></script>
<script type="text/javascript" src="<%=request.getContextPath()%>/dwr/engine.js"></script>
<script type="text/javascript" src="<%=request.getContextPath()%>/dwr/util.js"></script>
<script type='text/javascript' src='<%=request.getContextPath()%>/dwr/interface/service.js'> </script>

</head>
<body>
<input type="button" name="button" value="测试" onclick="firstDwr()">
</body>
</html>

loadreport.js

    function firstDwr(){
   service.sayHello("Jorwen",callBackHello);
   }
   function callBackHello(data){
    alert(data);
    }

Service.java

package cn.epem.admin;

public class Service {
public String sayHello(String yourName) {
System.out.println(yourName);
return "Hello World " + yourName;
}
}

============================================================
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

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">

<web-app id="dwr">
<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>
</web-app>

dwr.xml 与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>
<allow>
<create creator="new" javascript="JDate">
<param name="class" value="java.util.Date"/>
</create>
</allow>
</dwr>

index.html
<html>
<head>
<title>DWR - Test Home</title>
<script type='text/javascript' src='dwr/interface/JDate.js'></script>
<script type='text/javascript' src='dwr/engine.js'></script>
<script>
function init(){
JDate.getYear(load);
}
function load(data){
alert(data+1900+'年')
}
</script>
</head>
<body onload="init()">
</body>
</html>

dwr.jar 下载放lib下

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

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

java代码:

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>
</servlet-mapping>

这样所有的/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()方法中已经初始化了。

java代码:

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);
        }
    }

哦。这些恍然大悟。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 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字符串,在浏览器执行。哈，一切就这么简单，巧妙。

dwr的设计构思很是巧妙。
第一、把java类转化为javascript类由dwr自动完成，只需简单的配置。
第二、应用起来极其简单。开发者不要该服务器代码就可以集成。
第三、容易测试。和webwork一样，隐藏的http协议。
第四、及强扩展性。例如与spring集成，只需修改一点代码。
第五、性能。就我与jason,等简单比较，dwr性能可能是最好的。
第六、自动把java对象转化为javascript对象，并且及易扩展。

1 dwr支持的java类型于javascript类型如何转化.
2 dwr配置说明.
3 于spring,struts,webwork的集成.
4 dwr是如何解决我的那些疑问的.
http://forum.iteye.com/viewtopic.php?t=14083
5 见 http://forum.iteye.com/viewtopic.php?t=13995.现在我自己倾向于用javascript代替xml.毕竟浏览器消费最好是javascript对象.

1、最小配置

java代码:

<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>

2、当我们想看DWR自动生成的测试页（Using debug/test mode）时，可在
java代码:

servlet中加
<init-param>
   <param-name>debug</param-name>
   <param-value>true</param-value>
</init-param>

这个参数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()方法，以下配置是有效的。

java代码:

<init-param>
<param-name>logLevel</param-name>
<param-value>DEBUG</param-value>
</init-param>

有效的值是 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配置文件；

java代码:

<servlet>
     <servlet-name>dwr-invoker</servlet-name>
     <servlet-class>uk.ltd.getahead.dwr.DWRServlet</servlet-class>
     <init-param>
       <param-name>config-1</param-name>
       <param-value>WEB-INF/dwr1.xml</param-value>
     </init-param>
     <init-param>
       <param-name>config-2</param-name>
       <param-value>WEB-INF/dwr2.xml</param-value>
     </init-param>
</servlet>

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

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

java代码:

<servlet>
    <servlet-name>dwr-invoker</servlet-name>
     <servlet-class>uk.ltd.getahead.dwr.DWRServlet</servlet-class>

</servlet>
<servlet>
    <servlet-name>dwr-invoker1</servlet-name>
    <servlet-class>uk.ltd.getahead.dwr.DWRServlet</servlet-class>
    <init-param>
      <param-name>config-admin</param-name>
      <param-value>WEB-INF/dwr1.xml</param-value>
    </init-param>
    <init-param>
      <param-name>debug</param-name>
      <param-value>true</param-value>
    </init-param>
</servlet>
<servlet-mapping>
    <servlet-name>dwr-invoker</servlet-name>
    <url-pattern>/dwr/*</url-pattern>
</servlet-mapping>
<servlet-mapping>
    <servlet-name>dwr-invoker1</servlet-name>
    <url-pattern>/dwr1/*</url-pattern>
</servlet-mapping>

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

java代码:

uk.ltd.getahead.dwr.AccessControl
uk.ltd.getahead.dwr.Configuration
uk.ltd.getahead.dwr.ConverterManager
uk.ltd.getahead.dwr.CreatorManager
uk.ltd.getahead.dwr.Processor
uk.ltd.getahead.dwr.ExecutionContext

一点感想：

1、java的方法避免用 java 和 javascript的关键字。如 try()方法或 delete()方法。
2、在你的java类中不要出现重载 avoid overloaded methods.
3、在生产环境下，你可以把deprecated.js engine.js util.js 合并成一个，并放到web容器内，直接在htm,jsp中引用。（对于java代码转换成的javascript代码也可以这么做，免得每次生成javascript代码浪费时间）
4、研究一下Bean Converters。POJOjava对象必须严格按照 getProperty() setProperty()定义。Bean Converters是按照 java对象的 get set方法工作的。DWR1.1加了Object Converters,是按private int property;这类属性工作的。
<convert converter="bean" match="example.Fred"/>
<param name="exclude" value="property1, property2"/>
</convert>
当你这样配置时，java对象转化成的javascript对象不包括property1和property2。
<convert converter="bean" match="example.Fred"/>
<param name="include" value="property1, property2"/>
</convert>
反过来java对象转化成的javascript对象直包括property1和property2。
5、<convert converter="collection" match="java.util.Collection"/>
<convert converter="map" match="java.util.Map"/>
这也是容易出问题的地方.
如
package example;
public class Person{
private String name;
get ... set
private List relationPerson;
public List setRelationPerson(List relationPerson){
this.relationPerson=relationPerson;
}
}
<convert converter="bean" match="example.Person"/>
</convert>
<signatures>
<![CDATA[
import java.util.Set;
import example.Person;

Person.setRelationPerson(List<Person>);
]]>
</signatures>

在jdk1.5泛型中有写法区别

6、另外在Set,List等做为方法参数时也会出现混淆。返回集合类型不会出现问题，想想就知道了。
如在Test类中有 public Set testBeanSetParam(Set test) 这个方法，客户端得到的javascript方法可能是Test.testBeanSetParam(p0,callback);当我们 javascript调用这个方法时，鬼才知道怎么确定p0的类型,也不可能知道Set集合中该放什么类型的java对象，所以dwr的 special signatures syntax 确定这些集合和内容的类型
<signatures>
<![CDATA[
import java.util.Set;
import example.Test;

Test.testBeanSetParam(Set<TestBean>);

]]>
</signatures>
7、Creators
<allow>
<create creator="..." javascript="..." scope="...">
<param name="..." value="..."/>
<auth method="..." role="..."/>
<exclude method="..."/>
<include method="..."/>
</create>
...
</allow>
为了更少的暴露业务方法，最好配置include属性。
dwr支持new ,script,struts....几种集成方法，也支持static方法的调用，我觉得最好的是spring,其他感觉是处理遗留问题处理。
8、engine_js 作为dwr框架客户端核心，主要完成xmlHttp或iframe的构造，我们没必要关心它如何实现。有几点创新的我们可以学习下。
Call Batching 我们可以把几个客户端请求一起放送到服务器端，减少了网络交互，但要注意依存关系和他们处理的顺序。
Call Ordering 同步异步调整。一般用默认的就好了。注意依存关系。
Remoting Hooks 钩子，"small AOP"
依存关系解释。如果 request1() request2()两个业务逻辑方法，request2方法需要用到request1方法从服务器端返回的结果。如果调用request2时，request1还没处理或还没请求。下拉框连动可能有这个问题。
9、util.js propotype.js有些重复，这让我很难受。只能改代码了，可别坏了开元协议。
10、如果你的回调方法想加其他参数
var dataFromBrowser = ...;
var callbackProxy = function(dataFromServer) {
callbackFunc(dataFromServer, dataFromBrowser);
};
var callMetaData = { callback:callbackProxy };
Remote.method(params, callMetaData);
11、dwr1.1
1.1只能算一个bug消除版本，没有什么大的功能调整。源代码结构做了些调整。2.0有新的特征加入。

分享到：