DWR框架

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

从DWR官网下载最新版本的jar包，地址：http://directwebremoting.org/dwr/downloads/index.html
将j
ar包放入WEB-INF的lib文件夹下。同时，dwr依赖于commons-logging.jar这个包，所以必须将这个jar包
也放入到WEB-INF的lib文件夹下。
   首先是配置dwr环境：
   1. web.xml文件：
   
    <servlet>
        <servlet-name>dwr</servlet-name>
        <servlet-class>org.directwebremoting.servlet.DwrServlet</servlet-class>
        <init-param>
            <param-name>debug</param-name>
            <param-value>true</param-value>
        </init-param>
        <load-on-startup>-1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>dwr</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中定义的转换器映射到的具体类型，如：

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

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

<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整合的例子：
 

<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配置文件：

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

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

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

 3. 页面配置

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

<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代码：

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

 java代码：

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

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

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