DWR使用總結

 這兩天學了下DWR，現在總結一下。
DWR是方便使用AJAX連接JS和JAVA的的一個框架,把服務器端 Java 對象的方法公開給 JavaScript 代碼。
如果是用dwr2.0的jar包，還需要同時導入log4j.jar和commons-loggin.jar,勿忘!!
web.xml和dwr.xml放在WEB-INF下!
-----------------------------
配置web.xml:WEB工程啓動的時候會在這個裏面找到具體所用到的類的路徑，由此進行加載

<servlet>
    <servlet-name> dwr-invoke </servlet-name>
    <servlet-class> uk.ltd.getahead.dwr.DWRServlet </servlet>
    <init-param> //這個是調試用，如果正式發佈請該爲false，不過聽說2.0就默認爲true了
       <param-name> debug </param-value>
       <param-value> true </param-value>
    </init-param>
    <init-param> //這個是DWR2.0必須的,不然會報java.lang.IllegalArgumentException
       <param-name> classes </param-value>
       <param-value> java.lang.Object </param-value>
</servlet>

<servlet-mapping>
    <servlet-name> dwr-invoke </servlet-name>
    <url-pattern> /dwr/* </url-pattern>
</servlet-mapping>

-----------------------------
配置dwr.xml: dwr.xml的作用是讓你告訴DWR哪些class中的哪些方法你需要暴露給前臺使用，當DWR啓動時候根據dwr.xml這個文件把java類中的方法轉成js中可用的類中方法，使前臺可以使用。

注:以下是不全按dwr2.0寫的，如果用的是DWR2.0，那java裏暴露類(藍字顯示)不能寫在<create>屬性裏，應刪除後寫在<include method="" />前，<param name="class" value="***java裏暴露的class,必須寫完整路徑***" />。

<dwr>
    <allow>
       <create creator="new" javascript="***js調用的class***" class="***java裏暴露的class,必須寫完整路徑***">
           <include method="***java暴露類裏要公開的方法，如果不寫默認全部公開***" />
       </create>
    </allow>
</dwr>

-----------------------------
在html或js頁面中加入

<script src="<%=basePath %>dwr/interface/java裏暴露的class"></script>  //切記不能<script *** />這樣寫
<script src="<%=basePath %>dwr/engine.js"></script>   //Dwr的腳本驅動Js,以上兩個必寫
<script src="<%=basePath %>dwr/util.js"></script>   //這是個工具包，可以不調用
<script type="text/javascript">
    function doMethod()
    {
        //調用方法:若公開的類是AAA,公開的AAA裏的方法是bbb([參數]);
        AAA.bbb([參數],callBack);//回調函數callBack()
    }

    function callBack(data)//data是後臺返回的值，名字自取，也可省略，因爲JS允許
    {
       處理方法……;//如果callBack()沒有寫明返回值，可以通過argments[0]拿到
    }
</script>

其實我們調用AAA.bbb([參數],callBack);就是做了以下這一步：
(下面紅字是包裝好的，不在前臺，所以即使你沒有創建html或者jsp來調用，也可以通過localhost:8080/工程名/dwr 來看到你暴露的java類進行測試)

    function AAA() { };
    AAA.bbb = function([參數], callback) 
    { 
        DWREngine._execute('/dwr/dwr', 'AAA', 'bbb', [參數], callback); 
    }

通過在dwr.xml暴露的方法得到js裏的方法，當我們調用AAA.bbb時候再通過/dwr/dwr轉到DWRServlet中去用JAVA裏的AAA.bbb方法，然後返回值到callback中(中間經過dwr.xml的convert)


----------------------------
上面對dwr的工作大致分析了下，現在對於參數類型的不同，對dwr.xml也要進行修正。

DWR自動地在Java和JavaScript表示之間調整簡單數據類型,這些類型包括Java原生類型和它們各自的封裝類表示，還有String、Date、數組和集合類型。但如果參數類型非簡單數據類型，則要通過轉換。

調用返回JavaBean的java方法

在dwr.xml的<allow>標籤中加入

<convert converter="bean" match="***一般來說是javabean***">  //int,String,list等不需要顯式的轉換就可以被js拿到
     <param name="include" value="***javabean中的屬性，用','隔開***" />  //這句可以不寫
</convert>

<creator>標籤負責公開用於Web遠程的類和類的方法，<convertor>標籤則負責這些方法的參數和返回類型。convert元素的作用是告訴DWR在服務器端Java 對象表示和序列化的JavaScript之間如何轉換數據類型。

這樣在js端回調函數直接拿到的data就是一個javabean,可以直接通過data.xxx拿到bean的屬性xxx。

調用有JavaBean參數的java方法

dwr.xml配置同上。

在JS端，把要傳入的參數寫成javabean方式，例：要傳入一個名爲student的javabean,參數有name,password,則
var stu = {name:"zhangsan",password:"zspassword"}; //這是json的表示方法
AAA.bbb(stu,callBack);

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

dwr.xml配置同上。如果Collection裏的數據是簡單數據類型，則可不需要寫<convert>

在JS端，以List，裏面數據是bean爲例，data是一個List型，只要用for循環就可以依次拿到數據。

遍歷方法1:
for(var i=0;i<data.length;i++)  
    /*對於java方法的返回值爲List(Set)的情況，DWR將其轉                                 化爲Object數組，傳遞個javascript*/
{
    alert(data[i].name+":"+data[i].password);
}

遍歷方法2:
for(var property in data) //property爲序號,從0開始
{
    var bean = data[property];
    alert(bean.name+":"+bean.password);
}

相比返回爲javabean多了一個遍歷而已。

如果java方法的返回值爲Map,則如下

for(var property in data) //property爲key值
    /*對於 java方法的返回值爲Map的情況，DWR將其轉化爲一個Object，
     其中Object的屬性爲原Map的key值，屬性值爲原Map相應的 value值*/
{
  var bean = data[property];
  alert(bean.username);
  alert(bean.password);
}

如果知道key值，則可直接用:data.key拿到value

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

在dwr.xml的<dwr>標籤內加入:<signatures>標籤。

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

例參數是javabean的List,則只要在參數爲javabean的例子裏構造時候加上[]即可，如下：

var stu = [{name:"zhangsan",password:"zspassword"},{name:"lisi",password:"lspassword"}];
//把List當作數組來處理
AAA.bbb(stu,callBack);

並且在dwr.xml中增加如下的配置段(剛纔試驗了下，不加也可以)

<signatures>
 <![CDATA[
  import java.util.List;
  import com.dwr.AAA;     //AAA的包路徑要寫完整
  import com.dwr.TestBean;  //javabean
  AAA.bbb(List<TestBean>); 
 ]]>
</signatures>

例參數是javabean的Map,key是String,value是javabean,如下:

var stu =

{
    "key1":{name:"zhangsan",password:"zspassword"},
    "key2":{name:"lisi",password:"lspassword"}
};

AAA.bbb(stu,callBack);

並且在dwr.xml中增加如下的配置段(剛纔試驗了下，不加也可以)

<signatures>
 <![CDATA[
  import java.util.List;
  import com.dwr.AAA;     //AAA的包路徑要寫完整
  import com.dwr.TestBean;  //javabean
  AAA.bbb(Map<String,TestBean>); 
 ]]>
</signatures>

文章來源於：http://www.cnblogs.com/a7345678/archive/2008/10/23/1317982.html