DWR搭建以及使用教程

DWR（Direct Web Remoting）是一个Ajax的开源框架，用于改善web页面与Java类交互的远程服务器端的交互体验，可以帮助开发人员开发包含AJAX技术的网站。它可以允许在浏览器里的代码使用运行在WEB服务器上的JAVA函数，就像它就在浏览器里一样。

　　从DWR官网下载最新版本的jar包，地址：http://directwebremoting.org/dwr/downloads/index.html

　　将jar包放入WEB-INF的lib文件夹下。同时，dwr依赖于commons-logging.jar这个包，所以必须将这个jar包也放入到WEB-INF的lib文件夹相爱。

　　

　　首先是配置dwr的环境：

　　1. web.xml文件：

?

1 2 3 4 5 6 7 8 9 10 11 12 13

< servlet >    < servlet-name >dwr-invoker</ servlet-name >    < servlet-class >uk.ltd.getahead.dwr.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 >

　　2. 从官网的jar.war文件中利用winRAR等软件提取出dwr.xml文件，并将其放入到WEB-INF文件夹下。

　　dwr.xml是dwr的核心配置文件，主要的标签有：<converter>、<convert>、<create>这三个标签。

　　<converter>标签是dwr中内置的转换器。我们也可以使用自己写的转换器，不过dwr提供的转换器已经足够了，所以这个标签，一般不会自己去写。

　　<convert>标签是将converter中定义的转换器映射到的具体类型，如：

?

1 2 3 4

< converter id = "date" class = "org.directwebremoting.convert.DateConverter" />　 <!-- 注册了 date 转换器 --> <!-- 注意:converter标签必须放到<init>标签内，而convert是放在<allow>标签内，这里只是示例，并不是完整的dwr.xml --> < convert converter = "date" match = "java.util.Date" />　 <!-- 将注册的 date 转换器应用到 java.util.Date 类型   -->

　　<create>标签是dwr中重要的标签，用来描述 java（服务器端） 与 javascript （客户端）的交互方式。其基本格式如下：

?

1 2 3 4 5 6 7 8 9

< allow >    < create creator = "..." javascript = "..." scope = "..." >      < param name = "..." value = "..." />      < auth method = "..." role = "..." />      < exclude method = "..." />      < include method = "..." />    </ create >    ... </ allow >

　　其中，creator和javascript是必须属性，其他可以忽略。creator包含有以下几个值：

　　new：Java用“new”关键字创造对象

　　none：它不创建对象  (v1.1+)

　　scripted：通过BSF使用脚本语言创建对象，例如BeanShell或Groovy

　　spring：通过Spring框架访问Bean

　　struts：使用Struts的FormBean  (v1.1+)

　　jsf：使用JSF的Bean  (v1.1+)

　　pageflow：访问Weblogic或Beehive的PageFlow  (v1.1+)

　　ejb3：使用EJB3 session bean  (v2.0+)

　　关于这几个属性如何使用，这里就不在详细阐述了。我只列出一个与spring整合的例子：

　　

?

1 2 3 4 5 6 7 8 9 10

< create creator = "spring" javascript = "backUpDocumentService" >    < param name = "beanName" value = "testDWR1" />    < include method = "modifyBackUpFiles" ></ include >    < include method = "isSafeCodeRight" ></ include > </ create >   <!-- 加include可以具体指定java类中关的方法，不加则默认类中全部为public的方法 -->     < create creator = "spring" javascript = "testDWR2" >    < param name = "beanName" value = "testDWR2" /> </ create >

 　　spring配置文件

?

1 2	< bean id = "testDWR1" class = "com.test.testDWR1" ></ bean > < bean id = "testDWR2" class = "com.test.testDWR2" ></ bean >

　　3. 页面配置

　　在jsp页面添加三个 js 文件，分别是

?

1 2 3

< script type = 'text/javascript' src = 'js/util.js' ></ script > < script type = 'text/javascript' src = 'js/engine.js' ></ script > < script type = 'text/javascript' src = 'dwr/interface/testDWR1.js' >

　　其中engine.js必须要，如果需要用到dwr提供的一些方便的工具要引用util.js ，然后是dwr自动生成的js文件，名字必须和dwr.xml中create标签的javascript属性值一样，且是dwr/interface开头的目录

　　4. 接下来就可以分别写javascript和java代码了。

　　javascript代码：

?

1 2 3 4 5 6

function testFun() {      var name =  "aaaaa" ;      testDWR1.testFun(name, returnFun);   //调用java方法，第二个参数是回调函数 } function returnFun(data) {   //data对应着java方法的返回值      alert(data); }

 　　java代码：

?

1 2 3 4 5 6 7 8

package com.test;   public class testDWR1 {      public String test(String str) {          str +=  "bbb" ;          return str;      } }

 　　5.  其他

　　dwr可以设置是否采用异步方式访问java代码，其代码为：

?

1	dwr.engine.setAsync( false );   //false为同步，true（默认）为异步

　　以及dwr对于异常的处理，这里我只列出个简单的全局性异常捕获，具体到针对某个方法的异常捕获，大家可以自己上网找找。

?

1 2 3 4 5

dwr.engine.setErrorHandler(errh); function errh(errorString, exception) {      errorFlag =  true ;      alert( "操作失败！" ); }

　　dwr同样支持参数为对象的方法，这需要在dwr.xml中配置下<convert>标签：

?

1	< convert converter = "bean" match = "com.example.Person" />

　　那么关于dwr我也只介绍到这里了，这基本就是dwr的基本内容了，可以满足普通的项目需求了。

　　想进一步对于dwr的深入可以查询下相关文章或查看api，这里我就不再说的那么详细了。