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

<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中定義的轉換器映射到的具體類型，如：

<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 （客戶端）的交互方式。其基本格式如下：

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

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

　　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（默認）為異步

　　以及dwr對于異常的處理，這里我只列出個簡單的全局性異常捕獲，具體到針對某個方法的異常捕獲，大家可以自己上網找找。

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

　　dwr同樣支持參數為對象的方法，這需要在dwr.xml中配置下<convert>標簽：

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

　　那么關于dwr我也只介紹到這里了，這基本就是dwr的基本內容了，可以滿足普通的項目需求了。

　　想進一步對于dwr的深入可以查詢下相關文章或查看api，這里我就不再說的那么詳細了。