DWR

DWR（Direct Web Remoting）是一個用於改善web頁面與Java類交互的遠程服務器端Ajax開源框架,可以幫助開發人員開發包含AJAX技術的網站.它可以允許在瀏覽器裏的代碼使用運行在WEB服務器上的JAVA函數,就像它就在瀏覽器裏一樣。

 

介紹

　　它包含兩個主要的部分:允許JavaScript從WEB服務器上一個遵循了AJAX原則的Servlet中獲取數據.另外一方面一個JavaScript庫可以幫助網站開發人員輕鬆地利用獲取的數據來動態改變網頁的內容.

　　DWR採取了一個類似AJAX的新方法來動態生成基於JAVA類的JavaScript代碼.這樣WEB開發人員就可以在JavaScript裏使用Java代碼就像它們是瀏覽器的本地代碼(客戶端代碼)一樣;但是Java代碼運行在WEB服務器端而且可以自由訪問WEB 服務器的資源.出於安全的理由,WEB開發者必須適當地配置哪些Java類可以安全的被外部使用.

　　這個從JAVA到JavaScript的遠程功能方法給DWR的用戶帶來非常像傳統的RPC機制,就像RMI或者SOAP一樣,而且擁有運行在WEB上但是不需要瀏覽器插件的好處.

　　DWR不認爲瀏覽器/WEB服務器協議是重要的,而更樂於保證編程界面的簡單自然.對此最大的挑戰就是把AJAX的異步特性和正常JAVA方法調用的同步特性相結合.在異步模式下,結果數據在開始調用之後的一段時間之後纔可以被異步訪問獲取到.DWR允許WEB開發人員傳遞一個回調函數,來異步處理Java函數調用過程.

 

使用方法-------------------

　1.1、dwr.xml的配置

　　<dwr>

　　<allow>

　　<create creator="new" javascript="testClass" >

　　<include method="testMethod1"/>

　　</create>

　　</allow>

　　</dwr>

　　<allow>標籤中包括可以暴露給javascript訪問的東西。

　　<create>標籤中指定javascript中可以訪問的java類，並定義DWR應當如何獲得要進行遠程的類的實例。creator="new"屬性指定java類實例的生成方式，new意味着DWR應當調用類的默認構造函數來獲得實例，其他的還有spring方式，通過與IOC容器Spring進行集成來獲得實例等等。javascript=" testClass "屬性指定javascript代碼訪問對象時使用的名稱。

　　標籤指定要公開給javascript的java類名。

　　<include>標籤指定要公開給javascript的方法。不指定的話就公開所有方法。

　　<exclude>標籤指定要防止被訪問的方法。

　　1.2、javascript中調用

　　首先，引入javascript腳本

　　<script src='dwr/interface/ testClass.js'></script>

　　<script src='dwr/engine.js'></script>

　　<script src='dwr/util.js'></script>

　　其中TestClass.js是dwr根據配置文件自動生成的，engine.js和util.js是dwr自帶的腳本文件。

　　其次，編寫調用java方法的javascript函數

　　Function callTestMethod1(){

　　testClass.testMethod1();

　　}

　　2、調用有簡單返回值的java方法

　　2.1、dwr.xml的配置

　　配置同1.1

　　<dwr>

　　<allow>

　　<create creator="new" javascript="testClass" >

　　<include method="testMethod2"/>

　　</create>

　　</allow>

　　</dwr>

　　2.2、javascript中調用

　　首先，引入javascript腳本

　　其次，編寫調用java方法的javascript函數和接收返回值的回調函數

　　Function callTestMethod2(){

　　testClass.testMethod2(callBackFortestMethod2);

　　}

　　Function callBackFortestMethod2(data){

　　//其中data接收方法的返回值

　　//可以在這裏對返回值進行處理和顯示等等

　　alert("the return value is " + data);

　　}

　　其中callBackFortestMethod2是接收返回值的回調函數

　　3、調用有簡單參數的java方法

　　3.1、dwr.xml的配置

　　配置同1.1

　　<dwr>

　　<allow>

　　<create creator="new" javascript="testClass" >

　　<include method="testMethod3"/>

　　</create>

　　</allow>

　　</dwr>

　　3.2、javascript中調用

　　首先，引入javascript腳本

　　其次，編寫調用java方法的javascript函數

　　Function callTestMethod3(){

　　//定義要傳到java方法中的參數

　　var data;

　　//構造參數

　　data = “test String”;

　　testClass.testMethod3(data);

　　}

　　4、調用返回JavaBean的java方法

　　4.1、dwr.xml的配置

　　<dwr>

　　<allow>

　　<create creator="new" javascript="testClass" >

　　<include method="testMethod4"/>

　　</create>

　　<convert converter="bean" match=""com.dwr.TestBean">

　　</convert>

　　</allow>

　　</dwr>

　　<creator>標籤負責公開用於Web遠程的類和類的方法，<convertor>標籤則負責這些方法的參數和返回類型。convert元素的作用是告訴DWR在服務器端Java 對象表示和序列化的JavaScript之間如何轉換數據類型。DWR自動地在Java和JavaScript表示之間調整簡單數據類型。這些類型包括Java原生類型和它們各自的封裝類表示，還有String、Date、數組和集合類型。DWR也能把JavaBean轉換成JavaScript 表示，但是出於安全性的原因，要求顯式的配置，<convertor>標籤就是完成此功能的。converter="bean"屬性指定轉換的方式採用JavaBean命名規範，match=""com.dwr.TestBean"屬性指定要轉換的javabean名稱，標籤指定要轉換的JavaBean屬性。

　　4.2、javascript中調用

　　首先，引入javascript腳本

　　其次，編寫調用java方法的javascript函數和接收返回值的回調函數

　　Function callTestMethod4(){

　　testClass.testMethod4(callBackFortestMethod4);

　　}

　　Function callBackFortestMethod4(data){

　　//其中data接收方法的返回值

　　//對於JavaBean返回值，有兩種方式處理

　　//不知道屬性名稱時，使用如下方法

　　for(var property in data){

　　alert("property:"+property);

　　alert(property+":"+data[property]);

　　}

　　//知道屬性名稱時，使用如下方法

　　alert(data.username);

　　alert(data.password);

　　}

　　其中callBackFortestMethod4是接收返回值的回調函數

　　5、調用有JavaBean參數的java方法

　　5.1、dwr.xml的配置

　　配置同4.1

　　<dwr>

　　<allow>

　　<create creator="new" javascript="testClass" >

　　<include method="testMethod5"/>

　　</create>

　　<convert converter="bean" match="com.dwr.TestBean">

　　</convert>

　　</allow>

　　</dwr>

　　5.2、javascript中調用

　　首先，引入javascript腳本

　　其次，編寫調用java方法的javascript函數

　　Function callTestMethod5(){

　　//定義要傳到java方法中的參數

　　var data;

　　//構造參數，data實際上是一個object

　　data = { username:"user", password:"password" }

　　testClass.testMethod5(data);

　　}

　　6、調用返回List、Set或者Map的java方法

　　6.1、dwr.xml的配置

　　配置同4.1

　　<dwr>

　　<allow>

　　<create creator="new" javascript="testClass" >

　　<include method="testMethod6"/>

　　</create>

　　<convert converter="bean" match="com.dwr.TestBean">

　　</convert>

　　</allow>

　　</dwr>

　　注意：如果List、Set或者Map中的元素均爲簡單類型（包括其封裝類）或String、Date、數組和集合類型，則不需要<convert>標籤。

　　6.2、javascript中調用(以返回List爲例，List的元素爲TestBean)

　　首先，引入javascript腳本

　　其次，編寫調用java方法的javascript函數和接收返回值的回調函數

　　Function callTestMethod6(){

　　testClass.testMethod6(callBackFortestMethod6);

　　}

　　Function callBackFortestMethod6(data){

　　//其中data接收方法的返回值

　　//對於JavaBean返回值，有兩種方式處理

　　//不知道屬性名稱時，使用如下方法

　　for(var i=0;i<data.length;i++){

　　for(var property in data[i]){

　　alert("property:"+property);

　　alert(property+":"+data[i][property]);

　　}

　　}

　　//知道屬性名稱時，使用如下方法

　　for(var i=0;i<data.length;i++){

　　alert(data[i].username);

　　alert(data[i].password);

　　}

　　}

　　7、調用有List、Set或者Map參數的java方法

　　7.1、dwr.xml的配置

　　<dwr>

　　<allow>

　　<create creator="new" javascript="testClass" >

　　<include method="testMethod7"/>

　　</create>

　　<convert converter="bean" match="com.dwr.TestBean">

　　</convert>

　　</allow>

　　<signatures>

　　<![CDATA[

　　import java.util.List;

　　import com.dwr.TestClass;

　　import com.dwr.TestBean;

　　TestClass.testMethod7(List<TestBean>);

　　]]>

　　</signatures>

　　</dwr>

　　<signatures>標籤是用來聲明java方法中List、Set或者Map參數所包含的確切類，以便java代碼作出判斷。

　　7.2、javascript中調用(以返回List爲例，List的元素爲TestBean)

　　首先，引入javascript腳本

　　其次，編寫調用java方法的javascript函數

　　Function callTestMethod7(){

　　//定義要傳到java方法中的參數

　　var data;

　　//構造參數，data實際上是一個object數組，即數組的每個元素均爲object

　　data = [

　　{

　　username:"user1",

　　password:"password2"

　　},

　　{

　　username:"user2",

　　password:" password2"

　　}

　　];

　　testClass.testMethod7(data);

　　}

　　注意：

　　1、對於第6種情況，如果java方法的返回值爲Map，則在接收該返回值的javascript回調函數中如下處理：

　　function callBackFortestMethod(data){

　　//其中data接收方法的返回值

　　for(var property in data){

　　var bean = data[property];

　　alert(bean.username);

　　alert(bean.password);

　　}

　　}

　　2、對於第7種情況，如果java的方法的參數爲Map（假設其key爲String，value爲TestBean），則在調用該方法的javascript函數中用如下方法構造要傳遞的參數：

　　function callTestMethod (){

　　//定義要傳到java方法中的參數

　　var data;

　　//構造參數，date實際上是一個object，其屬性名爲Map的key，屬性值爲Map的value

　　data = {

　　"key1":{

　　username:"user1",

　　password:"password2"

　　},

　　"key2":{

　　username:"user2",

　　password:" password2"

　　}

　　};

　　testClass.testMethod(data);

　　}

　　並且在dwr.xml中增加如下的配置段

　　<signatures>

　　<![CDATA[

　　import java.util.List;

　　import com.dwr.TestClass;

　　import com.dwr.TestBean;

　　TestClass.testMethod7(Map<String,TestBean>);

　　]]>

　　</signatures>

　　3、由以上可以發現，對於java方法的返回值爲List(Set)的情況，DWR將其轉化爲Object數組，傳遞個javascript；對於java方法的返回值爲Map的情況，DWR將其轉化爲一個Object，其中Object的屬性爲原Map的key值，屬性值爲原Map相應的value值。

　　4、如果java方法的參數爲List(Set)和Map的情況，javascript中也要根據3種所說，構造相應的javascript數據來傳遞到java中

　　特別說明：

　　創建時要先實例化：var obj = new Object(); obj = {key:"value"}; 也可以obj.key = "value"; 如果沒有初始化，則會轉換出錯。