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，這裡我就不再說的那麼詳細了。