当前位置: 代码迷 >> Web前端 >> DWR筹建以及使用教程
  详细解决方案

DWR筹建以及使用教程

热度:521   发布时间:2014-02-12 21:25:08.0
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文件:

01 <servlet>
02 ??<servlet-name>dwr-invoker</servlet-name>
03 ??<servlet-class>uk.ltd.getahead.dwr.DWRServlet</servlet-class>
04 ??<init-param>
05 ????<param-name>debug</param-name>
06 ????<param-value>true</param-value>
07 ??</init-param>
08 </servlet>
09 ?
10 <servlet-mapping>
11 ??<servlet-name>dwr-invoker</servlet-name>
12 ??<url-pattern>/dwr/*</url-pattern>
13 </servlet-mapping>

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

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

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

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

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

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

?
1 <allow>
2 ??<create creator="..." javascript="..." scope="...">
3 ????<param name="..." value="..."/>
4 ????<auth method="..." role="..."/>
5 ????<exclude method="..."/>
6 ????<include method="..."/>
7 ??</create>
8 ??...
9 </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整合的例子:

  

?
01 <create creator="spring" javascript="backUpDocumentService">
02 ??<param name="beanName" value="testDWR1" />
03 ??<include method="modifyBackUpFiles"></include>
04 ??<include method="isSafeCodeRight"></include>
05 </create>
06 ?
07 <!-- 加include可以具体指定java类中关的方法,不加则默认类中全部为public的方法 -->????
08 <create creator="spring" javascript="testDWR2">
09 ??<param name="beanName" value="testDWR2" />
10 </create>

?  spring配置文件

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

  3. 页面配置

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

?
1 <script type='text/javascript' src='js/util.js'></script>
2 <script type='text/javascript' src='js/engine.js'></script>
3 <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 function testFun() {
2 ????var name = "aaaaa";
3 ????testDWR1.testFun(name, returnFun);? //调用java方法,第二个参数是回调函数
4 }function returnFun(data) {? //data对应着java方法的返回值
5 ????alert(data);
6 }

?  java代码:

?
1 package com.test;
2 ?
3 public class testDWR1 {
4 ????public String test(String str) {
5 ????????str += "bbb";
6 ????????return str;
7 ????}
8 }

?  5.? 其他

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

?
1 dwr.engine.setAsync(false);? //false为同步,true(默认)为异步

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

?
1 dwr.engine.setErrorHandler(errh);
2 function errh(errorString, exception) {
3 ????errorFlag = true;
4 ????alert("操作失败!");
5 }

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

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

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

  相关解决方案