1、調(diào)用沒(méi)有返回值和參數(shù)的JAVA方法
1.1、dwr.xml的配置
<dwr>
<allow>
<create creator="new" javascript="testClass" >
<param name="class" value="/com.dwr.TestClass" />
<include method="testMethod1"/>
</create>
</allow>
</dwr>
<allow>標(biāo)簽中包括可以暴露給javascript訪問(wèn)的東西。
<create>標(biāo)簽中指定javascript中可以訪問(wèn)的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方式,通過(guò)與IOC容器 Spring進(jìn)行集成來(lái)獲得實(shí)例等等。javascript=" testClass "屬性指定javascript代碼訪問(wèn)對(duì)象時(shí)使用的名稱。
<param>標(biāo)簽指定要公開給javascript的java類名。
<include>標(biāo)簽指定要公開給javascript的方法。不指定的話就公開所有方法。
<exclude>標(biāo)簽指定要防止被訪問(wèn)的方法。
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" >
<param name="class" value="/com.dwr.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" >
<param name="class" value="/com.dwr.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" >
<param name="class" value="/com.dwr.TestClass" />
<include method="testMethod4"/>
</create>
<convert converter="bean" match=""com.dwr.TestBean">
<param name="include" value="username,password" />
</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名稱,< param>標(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" >
<param name="class" value="/com.dwr.TestClass" />
<include method="testMethod5"/>
</create>
<convert converter="bean" match="com.dwr.TestBean">
<param name="include" value="username,password" />
</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" >
<param name="class" value="/com.dwr.TestClass" />
<include method="testMethod6"/>
</create>
<convert converter="bean" match="com.dwr.TestBean">
<param name="include" value="username,password" />
</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" >
<param name="class" value="/com.dwr.TestClass" />
<include method="testMethod7"/>
</create>
<convert converter="bean" match="com.dwr.TestBean">
<param name="include" value="username,password" />
</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種所說(shuō),構(gòu)造相應(yīng)的javascript數(shù)據(jù)來(lái)傳遞到j(luò)ava中。
====================================================================
Scripting Introduction
DWR根據(jù)dwr.xml生成和Java代碼類似的Javascript代碼。
相對(duì)而言Java同步調(diào)用,創(chuàng)建與Java代碼匹配的Ajax遠(yuǎn)程調(diào)用接口的最大挑戰(zhàn)來(lái)至與實(shí)現(xiàn)Ajax的異步調(diào)用特性。
DWR通過(guò)引入回調(diào)函數(shù)來(lái)解決這個(gè)問(wèn)題,當(dāng)結(jié)果被返回時(shí),DWR會(huì)調(diào)用這個(gè)函數(shù)。
有兩種推薦的方式來(lái)使用DWR實(shí)現(xiàn)遠(yuǎn)程方法調(diào)用??梢酝ㄟ^(guò)把回調(diào)函數(shù)放在參數(shù)列表里,也可以把回調(diào)函數(shù)放到元數(shù)據(jù)對(duì)象里。
當(dāng)然也可以把回調(diào)函數(shù)做為第一個(gè)參數(shù),但是不建議使用這種方法。因?yàn)檫@種方法在處理自動(dòng)處理http對(duì)象時(shí)(查看"Alternative Method")上會(huì)有問(wèn)題。這個(gè)方法主要是為向下兼容而存在的。
簡(jiǎn)單的回調(diào)函數(shù)
假設(shè)你有一個(gè)這樣的Java方法:
public class Remote { public String getData(int index) { ... }}
我們可以在Javascript中這樣使用:
<script type="text/javascript" src="[WEBAPP]/dwr/interface/Remote.js"> </script><script type="text/javascript" src="[WEBAPP]/dwr/engine.js"> </script>...function handleGetData(str) { alert(str);}Remote.getData(42, handleGetData);
42是Java方法getData()的一個(gè)參數(shù)。
此外你也可以使用這種減縮格式:
Remote.getData(42, function(str) { alert(str); });
調(diào)用元數(shù)據(jù)對(duì)象(Meta-Data)
另外一種語(yǔ)法時(shí)使用"調(diào)用元數(shù)據(jù)對(duì)象"來(lái)指定回調(diào)函數(shù)和其他的選項(xiàng)。上面的例子可以寫成這樣:
Remote.getData(42, { callback:function(str) { alert(str); }});
這種方法有很多優(yōu)點(diǎn):易于閱讀,更重要的指定額外的調(diào)用選項(xiàng)。
超時(shí)和錯(cuò)誤處理
在回調(diào)函數(shù)的元數(shù)據(jù)中你可以指定超時(shí)和錯(cuò)誤的處理方式。例如:
Remote.getData(42, { callback:function(str) { alert(str); }, timeout:5000, errorHandler:function(message) { alert("Oops: " + message); }});
查找回調(diào)函數(shù)
有些情況下我們很難區(qū)分各種回調(diào)選項(xiàng)(記住,Javascript是不支持函數(shù)重載的)。例如:
Remote.method({ timeout:3 }, { errorHandler:somefunc });
這兩個(gè)參數(shù)之一是bean的參數(shù),另一個(gè)是元數(shù)據(jù)對(duì)象,但是我們不能清楚的告訴DWR哪個(gè)是哪個(gè)。為了可以跨瀏覽器,我們假定null == undefined。 所以當(dāng)前的情況,規(guī)則是:
- 如果第一個(gè)或最后一個(gè)是一個(gè)函數(shù),那么它就是回調(diào)函數(shù),沒(méi)有元數(shù)據(jù)對(duì)象,并且其他參數(shù)都是Java的方法參數(shù)。
- 另外,如果最后一個(gè)參數(shù)是一個(gè)對(duì)象,這個(gè)對(duì)象中有一個(gè)callback成員,并且它是個(gè)函數(shù),那么這個(gè)對(duì)象就是元數(shù)據(jù)對(duì)象,其他的都是Java方法參數(shù)。
- 另外,如果第一個(gè)參數(shù)是 null ,我們就假設(shè)沒(méi)有回調(diào)函數(shù),并且其他的都是Java方法參數(shù)。盡管如此,我們會(huì)檢查最后一個(gè)參數(shù)是不是null,如果是就發(fā)出警告。
- 最后如果最后一個(gè)參數(shù)是null,那么就沒(méi)有callback函數(shù)。
- 另外,發(fā)出錯(cuò)誤信號(hào)是個(gè)糟糕的請(qǐng)求格式。
創(chuàng)造一個(gè)與Java對(duì)象匹配的Javascript對(duì)象
假設(shè)你有這樣的Java方法:
public class Remote { public void setPerson(Person p) { this.person = p; }}
Person對(duì)象的結(jié)構(gòu)是這樣的:
public Person { private String name; private int age; private Date[] appointments; // getters and setters ...}
那么你可以在Javascript中這樣寫:
var p = { name:"Fred Bloggs", age:42, appointments:[ new Date(), new Date("1 Jan 2008") ]};Remote.setPerson(p);
在Javascript沒(méi)有出現(xiàn)的字段,在Java中就不會(huì)被設(shè)置。
因?yàn)閟etter都是返回'void',我們就不需要使用callback函數(shù)了。如果你想要一個(gè)返回void的服務(wù)端方法的完整版,你也可以加上callback函數(shù)。很明顯DWR不會(huì)向它傳遞任何參數(shù)。