`
sunnytttty
  • 浏览: 25329 次
最近访客 更多访客>>
社区版块
存档分类
最新评论

DWR中文文档

    博客分类:
  • ajax
阅读更多

http://www.iteye.com/topic/40313

DWR是作为远程调用的ajax框架,将服务端的java类,方法和浏览器的javascript的类,方法对应起来。现在官方最新的版本是DWR2.0,可以在http://getahead.ltd.uk/dwr/download下载到。
我们真对DWR2.0做一些例子讲解一下它的特性:
Hello World:
新建一个web项目DWRStudy,在项目中构建路径中加入dwr.jar,
新建类Hello如下:

代码
  1. package org.li.dwr;   
  2.   
  3. package org.li.dwr;   
  4.   
  5. import java.util.Date;   
  6.   
  7. public class Hello   
  8. {   
  9.     public String getHelloWorld()   
  10.     {   
  11.         return "现在的时间为:"+new Date();   
  12.     }   
  13. }  
<script type="text/javascript">render_code();</script>
在WEB-INF目录下新建dwr.xml文件:
代码
  1. <!---->xml version="1.0" encoding="UTF-8"?>  
  2. <!---->>  
  3. <dwr>  
  4.     <allow>  
  5.     <!---->  
  6.         <create javascript="jshello" creator="new" scope="application">  
  7.             <param name="class" value="org.li.dwr.Hello">param>  
  8.         create>  
  9.     allow>  
  10. dwr>  
<script type="text/javascript">render_code();</script>
在WebRoot目录里新建hello.js
代码
  1. function load()//载入的时候调用   
  2. {   
  3.     var jbutton = document.getElementById("jbutton");   
  4.     jbutton.onclick=function(event)//注册按钮点击事件   
  5.     {   
  6.         jbClick();   
  7.     };   
  8. }   
  9. function jbClick()//按钮点击事件   
  10. {   
  11.     jshello.getHelloWorld(callback);//没有参数传递,只传递回调函数就行   
  12. }   
  13. function callback(msg)//回调函数   
  14. {   
  15.     DWRUtil.setValue('jdiv',msg);   
  16. }  
<script type="text/javascript">render_code();</script>
在WebRoot目录里新建HelloWorld.html
代码
  1. <!---->>  
  2. <html>  
  3.   <head>  
  4.     <title>HelloWorld.htmltitle>  
  5.     <meta http-equiv="content-type" content="text/html; charset=UTF-8">  
  6.     <script type='text/javascript' src='dwr/interface/jshello.js'>script>  
  7.     <script type='text/javascript' src='dwr/engine.js'>script>  
  8.     <script type='text/javascript' src='dwr/util.js'>script>  
  9.     <script type="text/javascript" src="hello.js">script>  
  10.   
  11.   head>  
  12.      
  13.   <body>  
  14.     <input id="jbutton" type="button" value="得到Hello World"/>  
  15.     <div id="jdiv">div>  
  16.     <script>load()script>  
  17.   body>  
  18. html>  
<script type="text/javascript">render_code();</script>
在web.xml中加入一个dwr的servlet:
代码
  1. <servlet>  
  2.         <servlet-name>dwr-invokerservlet-name>  
  3.         <servlet-class>  
  4.             org.directwebremoting.servlet.DwrServlet   
  5.         servlet-class>  
  6.         <init-param>  
  7.             <param-name>debugparam-name>  
  8.             <param-value>trueparam-value>  
  9.         init-param>  
  10.         <load-on-startup>1load-on-startup>  
  11.     servlet>  
  12.   
  13.     <servlet-mapping>  
  14.         <servlet-name>dwr-invokerservlet-name>  
  15.         <url-pattern>/dwr/*url-pattern>  
  16.     servlet-mapping>  
<script type="text/javascript">render_code();</script>
在运行一下服务器在浏览器里输入http://localhost:8080/DWRStudy/HelloWorld.html,然后点一下按钮下面就会显示服务端的系统时间了,而浏览器页面并没有被刷新。
下面解释一下:
1. 新建的Hello类中有一个getHelloWorld方法这个方法就是作为远程调用的服务端方法,这个Hello类也就是远程调用的类。方法的返回值为服务端当前的时间
2. dwr.xml是DWR用来配置服务端类和浏览器端javascript类之间的映射。可以下载dtd看一下,在<allow></allow>里类配置映射类如:<create javascript="jshello" creator="new" scope="application"></create>


javascript="jshello"是在浏览器端的javascript的映射的类名,(不要用javascript里的关键字)creator="new"是表示这个类是dwr自己创建的,如果creator="new"那么就必须有下面的 ,creator还可为spring(与spring集成的时候),script(与apache的一个框架BSF集成的时候用),后来又加入了struts,jsf,ejb3.现在是个HelloWorld让大家体验一下,具体后面会细讲。最后的scope=”application”是说这个pojo类的范围,和jsp是一样的。
3. 创建hello.js和HelloWorld.html都是看自己是怎么发挥了,注意的是在HelloWorld.html中导入js文件的时候注意顺序和路径命名规律,自己发挥的这个hello.js一定放在后面,因为要调用其它js文件中的函数。由于在HelloWorld.html里写入了<script>load()</script>所以在html加载的时候会调用hello.js里的load方法(注意这几个js文件里的函数最好不要重名)在load里面做的事情就是注册一下id为jbutton的按钮的点击事件。当我们点击id为jbutton的按钮的时候就开始用与服务器端的类相对应的javascript类了(jshello),直接调用jshello类的getHelloWorld方法,可以向函数传递参数,不过要在最后加一个回调函数。而我们的服务端的类没有参数就直接传回调函数了。在回调函数的形参msg是服务端Hello类中getHelloWorld方法返回值。在回调函数里面调用了DWR的工具类DWRUtil类的setValue方法设置id为jdiv的值。另外我们把doucment.getElementById(“jbutton”);换与$(“jbutton”)也可以得到同样的效果,这就有点像prototype了。
4. 在web.xml里加入DWRServlet的配置一是为了远程调用,二是自动生成了<script type="text/javascript" src="dwr/interface/jshello.js"></script>
<script type="text/javascript" src="dwr/engine.js"></script>
<script type="text/javascript" src="dwr/util.js"></script>文件。
上个HelloWorld例子只是返回了一个字符串,当然我们显示字符串很容易,可是如果返回一个对象怎么办呢?,DWR为我们将java类和javascript的DOM对象,不过这得需要我们在dwr.xml里配置。
再看一个综合的例子:
新建类User
代码
  1. package org.li.dwr;   
  2.   
  3. import java.io.FileInputStream;   
  4. import java.io.FileNotFoundException;   
  5. import java.io.IOException;   
  6. import java.util.ArrayList;   
  7. import java.util.List;   
  8. import java.util.Properties;   
  9.   
  10. public class User   
  11. {   
  12.     private String welcome;   
  13.     private String username;   
  14.     private String address;   
  15.     private List<book></book> books;   
  16.     private int age;   
  17.     public String getAddress()   
  18.     {   
  19.         return address;   
  20.     }   
  21.     public void setAddress(String address)   
  22.     {   
  23.         this.address = address;   
  24.     }   
  25.     public int getAge()   
  26.     {   
  27.         return age;   
  28.     }   
  29.     public void setAge(int age)   
  30.     {   
  31.         this.age = age;   
  32.     }   
  33.     public String getUsername()   
  34.     {   
  35.         return username;   
  36.     }   
  37.     public void setUsername(String username)   
  38.     {   
  39.         this.username = username;   
  40.     }   
  41.     public String getWelcome()   
  42.     {   
  43.         return welcome;   
  44.     }   
  45.     public void setWelcome(String welcome)   
  46.     {   
  47.         this.welcome = welcome;   
  48.     }   
  49.     public List<book></book> getBooks()   
  50.     {   
  51.         return books;   
  52.     }   
  53.     public void setBooks(List<book></book> books)   
  54.     {   
  55.         this.books = books;   
  56.     }   
  57.     public List<book></book> getBook()   
  58.     {   
  59.         this.books = new ArrayList<book></book>();   
  60.         Book javaBook = new Book();   
  61.         Book vcBook = new Book();   
  62.         javaBook.setAuthor("孙鑫");   
  63.         vcBook.setAuthor("孙鑫");   
  64.         javaBook.setName("java Web开发详解");   
  65.         vcBook.setName("vc++深入详解");   
  66.         this.books.add(javaBook);   
  67.         this.books.add(vcBook);   
  68.         return this.books;   
  69.     }   
  70.     public User getUser(String welcome)   
  71.     {   
  72.         this.welcome=welcome;   
  73.         try  
  74.         {   
  75.             FileInputStream fis = new FileInputStream("D:\\workspace\\DWRStudy\\src\\user.properties");   
  76.             Properties pp = new Properties();   
  77.             pp.load(fis);   
  78.             this.username=pp.getProperty("username");   
  79.             this.age=Integer.valueOf(pp.getProperty("age"));   
  80.             this.address=pp.getProperty("address");   
  81.             fis.close();   
  82.         }   
  83.         catch (FileNotFoundException e)   
  84.         {   
  85.             // TODO Auto-generated catch block   
  86.             e.printStackTrace();   
  87.         }   
  88.         catch (IOException e)   
  89.         {   
  90.             // TODO Auto-generated catch block   
  91.             e.printStackTrace();   
  92.         }   
  93.         return this;   
  94.     }   
  95. }   
<script type="text/javascript">render_code();</script>
新建Book类:
代码
  1. package org.li.dwr;   
  2.   
  3. public class Book   
  4. {   
  5.     private String name;   
  6.     private String author;   
  7.     public String getAuthor()   
  8.     {   
  9.         return author;   
  10.     }   
  11.     public void setAuthor(String author)   
  12.     {   
  13.         this.author = author;   
  14.     }   
  15.     public String getName()   
  16.     {   
  17.         return name;   
  18.     }   
  19.     public void setName(String name)   
  20.     {   
  21.         this.name = name;   
  22.     }   
  23. }  
<script type="text/javascript">render_code();</script>
新建DWRLog类
代码
  1. package org.li.dwr.log;   
  2.   
  3. import java.lang.reflect.Method;   
  4.   
  5. import org.directwebremoting.AjaxFilterChain;   
  6.   
  7. public class DWRLog implements org.directwebremoting.AjaxFilter   
  8. {   
  9.   
  10.     public Object doFilter(Object obj, Method method, Object[] params, AjaxFilterChain chain) throws Exception   
  11.     {   
  12.         System.out.println("过滤器Log输出:..对象:"+obj.getClass().getName()+"方法:"+method.getName());   
  13.         return chain.doFilter(obj, method,params);   
  14.     }   
  15.        
  16. }  
<script type="text/javascript">render_code();</script>
新建D:\\workspace\\DWRStudy\\src\\user.properties
username=javafish
age=21
address=北京市海淀区
然后在dwr.xml里加入
代码
  1. <create javascript="jsuser" creator="new">  
  2.             <param name="class" value="org.li.dwr.User">param>  
  3.             <!---->  
  4.             <include method="getUser"/>  
  5.             <include method="getBook"/>  
  6.             <!---->  
  7.             <filter class="org.li.dwr.log.DWRLog">filter>  
  8.         create>  
  9.         <!---->  
  10.         <convert match="org.li.dwr.User" converter="bean">convert>  
  11.         <convert match="org.li.dwr.Book" converter="bean">convert>  
<script type="text/javascript">render_code();</script>
新建UserInfo.html
代码
  1. <!---->>  
  2. <html>  
  3.   <head>  
  4.     <title>UserInfo.htmltitle>  
  5.     <meta http-equiv="content-type" content="text/html; charset=UTF-8">  
  6.     <script type='text/javascript' src='dwr/interface/jsuser.js'>script>  
  7.     <script type='text/javascript' src='dwr/engine.js'>script>  
  8.     <script type='text/javascript' src='dwr/util.js'>script>  
  9.     <script type="text/javascript" src="userInfo.js">script>  
  10.   
  11.   head>  
  12.      
  13.   <body>  
  14.     请输入你的名字:   
  15.     <input id="name" type="text"/>  
  16.     <input id="jbutton" type="button" value="得到javafish的信息"/>  
  17.     <input id="sbutton" type="button" value="得到javafish的书"/>  
  18.     <div id="result">div>  
  19.     <script>load()script>  
  20.   body>  
  21. html>  
<script type="text/javascript">render_code();</script>
新建userInfo.js
代码
  1. function load()   
  2. {   
  3.     var jbutton = $("jbutton");   
  4.     jbutton.onclick=function(event)   
  5.     {   
  6.         bOnClick();   
  7.     };   
  8.     var sbutton = $("sbutton");   
  9.     sbutton.onclick=function(event)   
  10.     {   
  11.         sOnClick();   
  12.     };   
  13. }   
  14. function bOnClick()   
  15. {   
  16.     jsuser.getUser($("name").value,callback);   
  17. }   
  18. function callback(msg)   
  19. {   
  20.     var user = msg;   
  21.     DWRUtil.setValue('result',"欢迎你!"+user.welcome+"   姓名:"+user.username+",年龄:"+user.age+",住址:"+user.address+user.books[0].author);   
  22. }   
  23.   
  24. function sOnClick()   
  25. {   
  26.     jsuser.getBook(callbackBooks);   
  27. }   
  28. function callbackBooks(msg)   
  29. {   
  30.     alert(msg);   
  31.     DWRUtil.setValue('result',msg);   
  32. }  
<script type="text/javascript">render_code();</script>
运行服务器输入http://localhost:8080/DWRStudy/UserInfo.html,可看到运行结果
这个例子需要解释的就是dwr.xml了
在这里用到了两个java类,User、Book,方法呢就是User.getUser和User.getBook,而Book类呢由于我们没有在javascript中调用,所以就不用配置Book的create了。
大家可能会奇怪为什么会多出来两个<convert match="org.li.dwr.User" converter="bean"></convert>
<convert match="org.li.dwr.Book" converter="bean"></convert>
呢,是因为在调用getBook和getUser的时候会返回给javascript有关User和Book的对象或数据,这里的用<convert match="”类”" converter="”bean”/"></convert>做一下转换,否则javascript将不会得到有效的数据。
下面讨论一下DWR的安全性,由于我们将javaBean整体都对外暴露了,所以说会有非常多的安全问题,真对这些DWR也作了一些的措施就是上面例子中dwr.xml的配置:
<include method="getUser"></include>
<include method="getBook"></include>
<filter class="org.li.dwr.log.DWRLog"></filter>
这样配置的话就只暴露了User类的两个方法getUser,getBook。就相对安全多了,相反还有<exclude></exclude>的配置它们是类似的。对于安全我们也可以用DWR的过滤器来实现,这里我用过滤器实现的是一个日志记录。过滤器类只需要实现AjaxFilter接口就可以了,不过注意的是这个过滤器不是HttpServelt的过滤器而是DWR自己内部实现的(有兴趣可以查看一下源代码)。
真对DWR的安全性上来说,官方也不敢保证,官方只是说自己可以看一下源代码因地施宜。
不过DWR可以和acegi集成,让acegi来管理安全问题。由于acegi我还没有完全搞定关于DWR和acegi的集成,先放一放日后补充。
下面对DWR.xml的配置具体补充一下:
首先是<init></init>里面有<converter></converter>和<create></create>是配置在初始化的时候需要创建和转化的类。
然后是<allow></allow>里面有<converter></converter>和<create></create>这个地方就是正式的配置了,creator里有param,filter,include,exclude,auth,除了auth我们都接触过了,而auth是集成J2EE的安全认证用的,这个可能和acegi的集成有关吧(?)。<converter></converter>呢,它的converter有很多
? Array Converter
? Bean and Object Converters
? Collection Converter
? Enum Converter
? DOM Objects
这些都是转换的时候配置的
还有就是<signatures></signatures>的配置了,申明一些不java用反射不可得到的参数类型。
我在上面例子上用的getBook来本来想用signatures实现List<book></book>的转换可是没有成功(不用配置就可以)
主要是真对jdk1.4以下的,我本机用的是jdk6,所以屡试不爽最后在官方DWR2的特性中看到如果你用的是DWR2和JDK5以上的话就不用配置了DWR会自动转换。
下面讲一下DWR与Spring的集成:
还是上面那个例子用Spring搞定大部分和上面一样
新建类User(包换了)
代码
  1. package org.li.dwr.spring;   
  2.   
  3. import java.util.List;   
  4.   
  5. import org.li.dwr.Book;   
  6.   
  7. public class User   
  8. {   
  9.     private String welcome;   
  10.     private String username;   
  11.     private String address;   
  12.     private List<book></book> books;   
  13.     private int age;   
  14.     public String getAddress()   
  15.     {   
  16.         return address;   
  17.     }   
  18.     public void setAddress(String address)   
  19.     {   
  20.         this.address = address;   
  21.     }   
  22.     public int getAge()   
  23.     {   
  24.         return age;   
  25.     }   
  26.     public void setAge(int age)   
  27.     {   
  28.         this.age = age;   
  29.     }   
  30.     public String getUsername()   
  31.     {   
  32.         return username;   
  33.     }   
  34.     public void setUsername(String username)   
  35.     {   
  36.         this.username = username;   
  37.     }   
  38.     public String getWelcome()   
  39.     {   
  40.         return welcome;   
  41.     }   
  42.     public void setWelcome(String welcome)   
  43.     {   
  44.         this.welcome = welcome;   
  45.     }   
  46.     public List<book></book> getBooks()   
  47.     {   
  48.         return books;   
  49.     }   
  50.     public void setBooks(List<book></book> books)   
  51.     {   
  52.         this.books = books;   
  53.     }   
  54.     public User getUser(String welcome)   
  55.     {   
  56.         this.welcome=welcome;   
  57.         return this;   
  58.     }   
  59. }  
<script type="text/javascript">render_code();</script>
Book还是以前那个
在src下新建application.xml文件(spring的配置文件)
代码
  1. <!---->xml
分享到:
评论
1 楼 wangdi 2007-01-23  
http://likunkun.iteye.com/blog/40313
呵呵……

相关推荐

    DWR中文文档DWR

    这份“DWR中文文档”将深入探讨DWR的核心概念、配置、API以及实际应用。 1. **核心概念**: - **Reverse Ajax**:DWR的核心特性是反向Ajax,即服务器可以主动向客户端发送数据,而不仅仅局限于客户端发起请求。 -...

    DWR中文文档v0.9PDF

    《DWR中文文档v0.9PDF》是一个关于Direct Web Remoting (DWR)技术的中文版指南,主要面向希望了解和使用DWR框架的开发者。DWR是一种JavaScript库,它允许Web应用程序与服务器端Java代码进行实时交互,实现AJAX...

    DWR中文文档.pdfDWR中文文档.pdf

    这个“DWR中文文档.pdf”可能是对DWR的详细解释和使用指南,包括了DWR的基本概念、配置、API使用以及实际开发中的示例。 1. **DWR基本概念**:DWR的核心是远程方法调用(Remote Method Invocation,RMI),它允许...

    DWR中文文档(pdf)

    ### DWR中文文档知识点概述 #### 一、DWR简介 **DWR**(Direct Web Remoting)是一种简化Ajax应用程序开发的技术。它提供了一种简单的方式,使得客户端JavaScript可以直接调用服务器端Java方法,就像调用本地方法...

    Ajax DWR中文文档

    Ajax DWR中文文档Ajax DWR中文文档Ajax DWR中文文档Ajax DWR中文文档Ajax DWR中文文档Ajax DWR中文文档Ajax DWR中文文档Ajax DWR中文文档Ajax DWR中文文档

    DWR中文文档 (DWR 2.0)

    ### DWR中文文档知识点概述 #### 一、DWR简介 **DWR(Direct Web Remoting)** 是一个开源的类库,旨在帮助开发者轻松构建包含AJAX技术的网站。其核心价值在于允许浏览器中的JavaScript代码能够直接调用运行在Web...

    DWR中文文档 ,非常详细

    以下是对DWR中文文档中的关键知识点的详细说明: 1. **DWR的基本概念**: - **Remoting**:远程方法调用,DWR的核心特性,使得JavaScript可以直接调用服务器上的Java方法。 - **AJAX**:异步JavaScript和XML,DWR...

    DWR中文文档和jar

    标题中的"DWR中文文档和jar"表明我们拥有关于DWR的中文版官方文档以及对应的jar包。这对于我们理解和使用DWR非常有帮助,特别是对于中文使用者,中文文档能够降低学习和理解的难度,提高开发效率。 DWR中文文档可能...

    dwr中文文档,dwr例子

    总之,这个DWR中文文档为Java Web开发者提供了一个深入理解DWR并将其应用于实际项目中的宝贵资源。通过阅读和实践,开发者能够掌握DWR的基本原理和高级特性,从而提升Web应用的交互性和响应速度。

    DWR中文文档pdf文档 实例下载

    提供的`DWR中文文档.pdf`可能包含了DWR的详细教程和使用指南,包括如何配置DWR、创建Java端接口、编写JavaScript调用代码等方面。此外,`DWRTest.rar`可能包含了一些示例项目,可以帮助开发者快速上手和理解DWR的...

    DWR中文文档和dwr.jar包

    DWR中文文档和dwr.jar包 DWR中文文档v0.9Ajax向我们袭来的时候,很多写代码的程序员看到了Ajax的发展前景,但并不是每一个程序员都能将页面与代码完美整合在一起,DOM、CSS、javascript让人眼花缭乱,不知从何下手。...

    ajax_DWR 中文文档

    DWR中文文档详细介绍了如何使用DWR来构建富互联网应用程序(Rich Internet Applications,RIA)。以下是文档可能包含的主要内容: 1. **DWR的基本概念**:包括DWR的工作原理,如反向AJAX、CORS(跨源资源共享)支持...

    dwr中文文档和实例.rar

    "dwr中文文档和实例.rar"包含了对DWR全面的中文解释和实践案例,对于想要深入理解和使用DWR的人来说,是一份极其宝贵的学习资源。 首先,DWR中文文档会详细介绍DWR的基本概念和工作原理。DWR的核心功能是提供了一个...

    DWR中文文档,自学好帮手

    DWR中文文档是为帮助中文用户更好地理解和使用DWR而编写的指南,对于自学DWR的初学者来说是一份非常实用的资源。 DWR的核心功能包括: 1. **Ajax通信**:DWR通过XMLHttpRequest对象在后台与服务器进行异步通信,使...

    DWR中文文档 dwr入门 dwr.jar

    1. `DWR中文文档.pdf`:这份文档提供了DWR的详细使用指南,包括安装、配置、基本用法、高级特性和最佳实践等。 2. `dwr.txt`:可能包含了DWR的快速参考或示例代码,帮助理解DWR的工作原理和API。 3. `dwr_fun_api....

Global site tag (gtag.js) - Google Analytics