1. DWR入門
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>標簽中包括可以暴露給javascript訪問的東西。
<create>標簽中指定javascript中可以訪問的java類，并定義DWR應當如何獲得要進行遠程的類的實例。creator="new"屬性指定java類實例的生成方式，new意味著DWR應當調用類的默認構造函數來獲得實例，其他的還有spring方式，通過與IOC容器Spring進行集成來獲得實例等等。javascript=" testClass "屬性指定javascript代碼訪問對象時使用的名稱。
<param>標簽指定要公開給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" >
<param name="class" value="com.dwr.TestClass" />
<include method="testMethod2"/>
</create>
</allow>
</dwr>
2.2、javascript中調用
首先，引入javascript腳本
其次，編寫調用java方法的javascript函數和接收返回值的回調函數
Function callTestMethod2(){
testClass.testMethod2(callBackFortestMethod2);
}
Function callBackFortestMethod2(data){
//其中date接收方法的返回值
//可以在這里對返回值進行處理和顯示等等
alert("the return value is " + data);
}
其中callBackFortestMethod2是接收返回值的回調函數
--------------------------------------------------------------------------------------------------
3、調用有簡單參數的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中調用
首先，引入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" >
<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>標簽負責公開用于Web遠程的類和類的方法，<convertor>標簽則負責這些方法的參數和返回類型。convert元素的作用是告訴DWR在服務器端Java 對象表示和序列化的JavaScript之間如何轉換數據類型。DWR自動地在Java和JavaScript表示之間調整簡單數據類型。這些類型包括Java原生類型和它們各自的封裝類表示，還有String、Date、數組和集合類型。DWR也能把JavaBean轉換成JavaScript 表示，但是出于安全性的原因，要求顯式的配置，<convertor>標簽就是完成此功能的。converter="bean"屬性指定轉換的方式采用JavaBean命名規范，match=""com.dwr.TestBean"屬性指定要轉換的javabean名稱，<param>標簽指定要轉換的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" >
<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中調用
首先，引入javascript腳本
其次，編寫調用java方法的javascript函數
Function callTestMethod5(){
//定義要傳到java方法中的參數
var data;
//構造參數，date實際上是一個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" >
<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或者Map中的元素均為簡單類型（包括其封裝類）或String、Date、數組和集合類型，則不需要<convert>標簽。
6.2、javascript中調用(以返回List為例，List的元素為TestBean)
首先，引入javascript腳本
其次，編寫調用java方法的javascript函數和接收返回值的回調函數
Function callTestMethod6(){
testClass.testMethod6(callBackFortestMethod6);
}
Function callBackFortestMethod6(data){
//其中date接收方法的返回值
//對于JavaBean返回值，有兩種方式處理
//不知道屬性名稱時，使用如下方法
for(var i=0;i<data.length;i++){
for(var property in data){
alert("property:"+property);
alert(property+":"+data[property]);
}
}
//知道屬性名稱時，使用如下方法
for(var i=0;i<data.length;i++){
alert(data.username);
alert(data.password);
}
}
--------------------------------------------------------------------------------------------------
7、調用有List、Set或者Map參數的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>標簽是用來聲明java方法中List、Set或者Map參數所包含的確切類，以便java代碼作出判斷。
7.2、javascript中調用(以返回List為例，List的元素為TestBean)
首先，引入javascript腳本
其次，編寫調用java方法的javascript函數
Function callTestMethod7(){
//定義要傳到java方法中的參數
var data;
//構造參數，date實際上是一個object數組，即數組的每個元素均為object
data = [
{
username:"user1",
password:"password2"
},
{
username:"user2",
password:" password2"
}
];
testClass.testMethod7(data);
}
注意：
1、對于第6種情況，如果java方法的返回值為Map，則在接收該返回值的javascript回調函數中如下處理：
function callBackFortestMethod(data){
//其中date接收方法的返回值
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中。
--------------------------------------------------------------------------------------------------
Scripting Introduction
DWR根據dwr.xml生成和Java代碼類似的Javascript代碼。
相對而言Java同步調用，創建與Java代碼匹配的Ajax遠程調用接口的最大挑戰來至與實現Ajax的異步調用特性。
DWR通過引入回調函數來解決這個問題，當結果被返回時，DWR會調用這個函數。
有兩種推薦的方式來使用DWR實現遠程方法調用。可以通過把回調函數放在參數列表里，也可以把回調函數放到元數據對象里。
當然也可以把回調函數做為第一個參數，但是不建議使用這種方法。因為這種方法在處理自動處理http對象時(查看"Alternative Method")上會有問題。這個方法主要是為向下兼容而存在的。
簡單的回調函數
假設你有一個這樣的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()的一個參數。
此外你也可以使用這種減縮格式：
Remote.getData(42, function(str) {
alert(str);
});
調用元數據對象(Meta-Data)
另外一種語法時使用"調用元數據對象"來指定回調函數和其他的選項。上面的例子可以寫成這樣：
Remote.getData(42,
{ callback:function(str) {
alert(str);
}
});
這種方法有很多優點：易于閱讀，更重要的指定額外的調用選項。
超時和錯誤處理
在回調函數的元數據中你可以指定超時和錯誤的處理方式。例如：
Remote.getData(42,
{ callback:function(str) {
alert(str);
},
{ timeout:5000 },
errorHandler:function(message) {
alert("Oops: " + message);
}
});
查找回調函數
有些情況下我們很難區分各種回調選項(記住，Javascript是不支持函數重載的)。例如：
Remote.method(
{
timeout:3
},
{ errorHandler:somefunc
}
);
這兩個參數之一是bean的參數，另一個是元數據對象，但是我們不能清楚的告訴DWR哪個是哪個。為了可以跨瀏覽器，我們假定null == undefined。 所以當前的情況，規則是：
如果第一個或最后一個是一個函數，那么它就是回調函數，沒有元數據對象，并且其他參數都是Java的方法參數。
另外，如果最后一個參數是一個對象，這個對象中有一個callback成員，并且它是個函數，那么這個對象就是元數據對象，其他的都是Java方法參數。
另外，如果第一個參數是 null ，我們就假設沒有回調函數，并且其他的都是Java方法參數。盡管如此，我們會檢查最后一個參數是不是null，如果是就發出警告。
最后如果最后一個參數是null，那么就沒有callback函數。
另外，發出錯誤信號是個糟糕的請求格式。
創造一個與Java對象匹配的Javascript對象
假設你有這樣的Java方法：
public class Remote {
public void setPerson(Person p) {
this.person = p;
}
}
Person對象的結構是這樣的：
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沒有出現的字段，在Java中就不會被設置。
因為setter都是返回'void'，我們就不需要使用callback函數了。如果你想要一個返回void的服務端方法的完整版，你也可以加上callback函數。很明顯DWR不會向它傳遞任何參數