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

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章