DWR（Direct Web Remoting）是一個(gè)開源的類庫(kù),可以幫助開發(fā)人員開發(fā)包含AJAX技術(shù)的網(wǎng)站.它可以允許在瀏覽器里的代碼使用運(yùn)行在WEB服務(wù)器上的JAVA函數(shù),就像它就在瀏覽器里一樣.
它包含兩個(gè)主要的部分:允許JavaScript從WEB服務(wù)器上一個(gè)遵循了AJAX原則的Servlet(小應(yīng)用程序)中獲取數(shù)據(jù).另外一方面一個(gè)JavaScript庫(kù)可以幫助網(wǎng)站開發(fā)人員輕松地利用獲取的數(shù)據(jù)來(lái)動(dòng)態(tài)改變網(wǎng)頁(yè)的內(nèi)容.
DWR采取了一個(gè)類似AJAX的新方法來(lái)動(dòng)態(tài)生成基于JAVA類的JavaScript代碼.這樣WEB開發(fā)人員就可以在JavaScript里使用Java代碼就像它們是瀏覽器的本地代碼(客戶端代碼)一樣;但是Java代碼運(yùn)行在WEB服務(wù)器端而且可以自由訪問WEB 服務(wù)器的資源.出于安全的理由,WEB開發(fā)者必須適當(dāng)?shù)嘏渲媚男㎎ava類可以安全的被外部使用.
這個(gè)從JAVA到JavaScript的遠(yuǎn)程功能方法給DWR的用戶帶來(lái)非常像傳統(tǒng)的RPC機(jī)制,就像RMI或者SOAP一樣,而且擁有運(yùn)行在WEB上但是不需要瀏覽器插件的好處.
DWR不認(rèn)為瀏覽器/WEB服務(wù)器協(xié)議是重要的,而更樂于保證編程界面的簡(jiǎn)單自然.對(duì)此最大的挑戰(zhàn)就是把AJAX的異步特性和正常JAVA方法調(diào)用的同步特性相結(jié)合.在異步模式下,結(jié)果數(shù)據(jù)在開始調(diào)用之后的一段時(shí)間之后才可以被異步訪問獲取到.DWR允許WEB開發(fā)人員傳遞一個(gè)回調(diào)函數(shù),來(lái)異步處理Java函數(shù)調(diào)用過程.
其配置如下:
1.1、dwr.xml的配置
<dwr>
<allow>
<create creator="new" javascript="testClass" >
<include method="testMethod1"/>
</create>
</allow>
</dwr>
<allow>標(biāo)簽中包括可以暴露給javascript訪問的東西。
<create>標(biāo)簽中指定javascript中可以訪問的java類，并定義DWR應(yīng)當(dāng)如何獲得要進(jìn)行遠(yuǎn)程的類的實(shí)例。creator="new"屬性指定java類實(shí)例的生成方式，new意味著DWR應(yīng)當(dāng)調(diào)用類的默認(rèn)構(gòu)造函數(shù)來(lái)獲得實(shí)例，其他的還有spring方式，通過與IOC容器Spring進(jìn)行集成來(lái)獲得實(shí)例等等。javascript=" testClass "屬性指定javascript代碼訪問對(duì)象時(shí)使用的名稱。
標(biāo)簽指定要公開給javascript的java類名。
<include>標(biāo)簽指定要公開給javascript的方法。不指定的話就公開所有方法。
<exclude>標(biāo)簽指定要防止被訪問的方法。
1.2、javascript中調(diào)用
首先，引入javascript腳本
<script src='dwr/interface/ testClass.js'></script>
<script src='dwr/engine.js'></script>
<script src='dwr/util.js'></script>
其中TestClass.js是dwr根據(jù)配置文件自動(dòng)生成的，engine.js和util.js是dwr自帶的腳本文件。
其次，編寫調(diào)用java方法的javascript函數(shù)
Function callTestMethod1(){
testClass.testMethod1();
}
2、調(diào)用有簡(jiǎn)單返回值的java方法
2.1、dwr.xml的配置
配置同1.1
<dwr>
<allow>
<create creator="new" javascript="testClass" >
<include method="testMethod2"/>
</create>
</allow>
</dwr>
2.2、javascript中調(diào)用
首先，引入javascript腳本
其次，編寫調(diào)用java方法的javascript函數(shù)和接收返回值的回調(diào)函數(shù)
Function callTestMethod2(){
testClass.testMethod2(callBackFortestMethod2);
}
Function callBackFortestMethod2(data){
//其中date接收方法的返回值
//可以在這里對(duì)返回值進(jìn)行處理和顯示等等
alert("the return value is " + data);
}
其中callBackFortestMethod2是接收返回值的回調(diào)函數(shù)
3、調(diào)用有簡(jiǎn)單參數(shù)的java方法
3.1、dwr.xml的配置
配置同1.1
<dwr>
<allow>
<create creator="new" javascript="testClass" >
<include method="testMethod3"/>
</create>
</allow>
</dwr>
3.2、javascript中調(diào)用
首先，引入javascript腳本
其次，編寫調(diào)用java方法的javascript函數(shù)
Function callTestMethod3(){
//定義要傳到j(luò)ava方法中的參數(shù)
var data;
//構(gòu)造參數(shù)
data = “test String”;
testClass.testMethod3(data);
}
4、調(diào)用返回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>標(biāo)簽負(fù)責(zé)公開用于Web遠(yuǎn)程的類和類的方法，<convertor>標(biāo)簽則負(fù)責(zé)這些方法的參數(shù)和返回類型。convert元素的作用是告訴DWR在服務(wù)器端Java 對(duì)象表示和序列化的JavaScript之間如何轉(zhuǎn)換數(shù)據(jù)類型。DWR自動(dòng)地在Java和JavaScript表示之間調(diào)整簡(jiǎn)單數(shù)據(jù)類型。這些類型包括Java原生類型和它們各自的封裝類表示，還有String、Date、數(shù)組和集合類型。DWR也能把JavaBean轉(zhuǎn)換成JavaScript 表示，但是出于安全性的原因，要求顯式的配置，<convertor>標(biāo)簽就是完成此功能的。converter="bean"屬性指定轉(zhuǎn)換的方式采用JavaBean命名規(guī)范，match=""com.dwr.TestBean"屬性指定要轉(zhuǎn)換的javabean名稱，標(biāo)簽指定要轉(zhuǎn)換的JavaBean屬性。
4.2、javascript中調(diào)用
首先，引入javascript腳本
其次，編寫調(diào)用java方法的javascript函數(shù)和接收返回值的回調(diào)函數(shù)
Function callTestMethod4(){
testClass.testMethod4(callBackFortestMethod4);
}
Function callBackFortestMethod4(data){
//其中date接收方法的返回值
//對(duì)于JavaBean返回值，有兩種方式處理
//不知道屬性名稱時(shí)，使用如下方法
for(var property in data){
alert("property:"+property);
alert(property+":"+data[property]);
}
//知道屬性名稱時(shí)，使用如下方法
alert(data.username);
alert(data.password);
}
其中callBackFortestMethod4是接收返回值的回調(diào)函數(shù)
5、調(diào)用有JavaBean參數(shù)的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中調(diào)用
首先，引入javascript腳本
其次，編寫調(diào)用java方法的javascript函數(shù)
Function callTestMethod5(){
//定義要傳到j(luò)ava方法中的參數(shù)
var data;
//構(gòu)造參數(shù)，date實(shí)際上是一個(gè)object
data = { username:"user", password:"password" }
testClass.testMethod5(data);
}
6、調(diào)用返回List、Set或者M(jìn)ap的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或者M(jìn)ap中的元素均為簡(jiǎn)單類型（包括其封裝類）或String、Date、數(shù)組和集合類型，則不需要<convert>標(biāo)簽。
6.2、javascript中調(diào)用(以返回List為例，List的元素為TestBean)
首先，引入javascript腳本
其次，編寫調(diào)用java方法的javascript函數(shù)和接收返回值的回調(diào)函數(shù)
Function callTestMethod6(){
testClass.testMethod6(callBackFortestMethod6);
}
Function callBackFortestMethod6(data){
//其中date接收方法的返回值
//對(duì)于JavaBean返回值，有兩種方式處理
//不知道屬性名稱時(shí)，使用如下方法
for(var i=0;i<data.length;i++){
for(var property in data){
alert("property:"+property);
alert(property+":"+data[property]);
}
}
//知道屬性名稱時(shí)，使用如下方法
for(var i=0;i<data.length;i++){
alert(data.username);
alert(data.password);
}
}
7、調(diào)用有List、Set或者M(jìn)ap參數(shù)的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>標(biāo)簽是用來(lái)聲明java方法中List、Set或者M(jìn)ap參數(shù)所包含的確切類，以便java代碼作出判斷。
7.2、javascript中調(diào)用(以返回List為例，List的元素為TestBean)
首先，引入javascript腳本
其次，編寫調(diào)用java方法的javascript函數(shù)
Function callTestMethod7(){
//定義要傳到j(luò)ava方法中的參數(shù)
var data;
//構(gòu)造參數(shù)，date實(shí)際上是一個(gè)object數(shù)組，即數(shù)組的每個(gè)元素均為object
data = [
{
username:"user1",
password:"password2"
},
{
username:"user2",
password:" password2"
}
];
testClass.testMethod7(data);
}
注意：
1、對(duì)于第6種情況，如果java方法的返回值為Map，則在接收該返回值的javascript回調(diào)函數(shù)中如下處理：
function callBackFortestMethod(data){
//其中date接收方法的返回值
for(var property in data){
var bean = data[property];
alert(bean.username);
alert(bean.password);
}
}
2、對(duì)于第7種情況，如果java的方法的參數(shù)為Map（假設(shè)其key為String，value為TestBean），則在調(diào)用該方法的javascript函數(shù)中用如下方法構(gòu)造要傳遞的參數(shù)：
function callTestMethod (){
//定義要傳到j(luò)ava方法中的參數(shù)
var data;
//構(gòu)造參數(shù)，date實(shí)際上是一個(gè)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、由以上可以發(fā)現(xiàn)，對(duì)于java方法的返回值為L(zhǎng)ist(Set)的情況，DWR將其轉(zhuǎn)化為Object數(shù)組，傳遞個(gè)javascript；對(duì)于java方法的返回值為Map的情況，DWR將其轉(zhuǎn)化為一個(gè)Object，其中Object的屬性為原Map的key值，屬性值為原Map相應(yīng)的value值。
4、如果java方法的參數(shù)為L(zhǎng)ist(Set)和Map的情況，javascript中也要根據(jù)3種所說，構(gòu)造相應(yīng)的javascript數(shù)據(jù)來(lái)傳遞到j(luò)ava中
1. 安裝 DWR JAR 包
下載 dwr.jar 文件，然后將它放在 web 程序的 WEB-INF/lib 目錄下面，很可能在這個(gè)目錄下已經(jīng)有一些 jar 文件了。
2. 編輯 config 文件
將下面的代碼添加到 WEB-INF/web.xml 文件中，<servlet>需要放在另外的<servlet>之后，<servlet-mapping>也是如此。
<servlet>
<servlet-name>dwr-invoker</servlet-name>
<display-name>DWR Servlet</display-name>
<servlet-class>uk.ltd.getahead.dwr.DWRServlet</servlet-class>
<init-param>
debug</param-name>
true</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>dwr-invoker</servlet-name>
<url-pattern>/dwr/*</url-pattern>
</servlet-mapping>
接下來(lái)創(chuàng)建 dwr.xml 文件并將此放在 web.xml 所在的 WEB-INF 目錄下。文件中類似下面的內(nèi)容：
<!DOCTYPE dwr PUBLIC
”-//GetAhead Limited//DTD Direct Web Remoting 1.0//EN”
”http://www.getahead.ltd.uk/dwr/dwr10.dtd”>
<dwr>
<allow>
<create creator=”new” javascript=”JDate”>
</create>
<create creator=”new” javascript=”Demo”>
</create>
</allow>
</dwr>
DWR 配置文件定義了由 DWR 創(chuàng)建和被 Javascript 遠(yuǎn)程使用的類。在上面的例子中我們?cè)谶h(yuǎn)程創(chuàng)建了2個(gè)類，并且給出了在 Javascript 中的類名。
上面使用的 new creator 使用了所有的 JavaBeans 必須含有的公有（public）無(wú)參（no-args）的構(gòu)造函數(shù)。值得一提的是， DWR 還有一些限制：
避免使用 JavaScript 保留字；以保留字命名的方法將自動(dòng)被排除。大多數(shù) JavaScript 的保留字同時(shí)也是 Java 的保留字，因此無(wú)論如何你也不能使用一個(gè)名為 “try()” 的方法。但是最常用的一個(gè)詞 “delete()”，在 JavaScript 中有特殊的含義而在 Java 中沒有。
重載方法（Overloaded methods）將會(huì)在調(diào)用的時(shí)候陷入未知的狀況，因此應(yīng)該避免重載方法。
3. 訪問下面的地址
http://localhost:8080/[YOUR-WEBAPP]/dwr/
你應(yīng)該會(huì)看到一個(gè)頁(yè)面，上面顯示了剛才你在第二步所創(chuàng)建的類。進(jìn)入一個(gè)鏈接之后你會(huì)看到所有等待調(diào)用方法的列表。這些動(dòng)態(tài)產(chǎn)生的例子你也能通過 DWR 來(lái)實(shí)現(xiàn)。
親自嘗試和體會(huì)下吧。
怎樣應(yīng)用到你的 Web 程序中？
在側(cè)邊欄有很多例子演示了怎樣改變網(wǎng)頁(yè)中的文本、更新列表、操作表單和動(dòng)態(tài)修改表格。每一個(gè)例子都有詳細(xì)的說明。
另外一個(gè)開始方法就是從頁(yè)面中查看源代碼，這些頁(yè)面你剛剛瀏覽過：
進(jìn)入 http://localhost:8080/[YOUR-WEBAPP]/dwr/ 然后點(diǎn)擊你創(chuàng)建的類；
查看源代碼然后定位到你所感興趣的方法的代碼行；
將這些文本粘貼到你 Web 程序的一個(gè) HTML 或 JSP頁(yè)面中；
包含下面的 javascrip 文件：
<script src=’/[YOUR-WEBAPP]/dwr/interface/[YOUR-SCRIPT].js’></script>
<script src=’/[YOUR-WEBAPP]/dwr/engine.js’></script>
你可以根據(jù)實(shí)際情況修改 /[YOUR-WEBAPP]/ 部分。
關(guān)于怎樣書寫 DWR 控制的 Javascript 代碼請(qǐng)查看 腳本簡(jiǎn)介。
官方網(wǎng)站：http://getahead.org/dwr