Ajax的開源框架 DWR

DWR（Direct Web Remoting）是一個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配置文件

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

 

　dwr一樣支持參數爲對象的方法，這須要在dwr.xml中配置下<convert>標籤：

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

那麼關於dwr我也只介紹到這裏了，這基本就是dwr的基本內容了，能夠知足普通的項目需求了。

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