介紹
它包含兩個主要的部分:允許JavaScript從WEB服務器上一個遵循了AJAX原則的Servlet中獲取數(shù)據(jù).另外一方面一個JavaScript庫可以幫助網(wǎng)站開發(fā)人員輕松地利用獲取的數(shù)據(jù)來動態(tài)改變網(wǎng)頁的內(nèi)容.
DWR采取了一個類似AJAX的新方法來動態(tài)生成基于JAVA類的JavaScript代碼.這樣WEB開發(fā)人員就可以在JavaScript里使用Java代碼就像它們是瀏覽器的本地代碼(客戶端代碼)一樣;但是Java代碼運行在WEB服務器端而且可以自由訪問WEB 服務器的資源.出于安全的理由,WEB開發(fā)者必須適當?shù)嘏渲媚男㎎ava類可以安全的被外部使用. 這個從JAVA到JavaScript的遠程功能方法給DWR的用戶帶來非常像傳統(tǒng)的RPC機制,就像RMI或者SOAP一樣,而且擁有運行在WEB上但是不需要瀏覽器插件的好處. DWR不認為瀏覽器/WEB服務器協(xié)議是重要的,而更樂于保證編程界面的簡單自然.對此最大的挑戰(zhàn)就是把AJAX的異步特性和正常JAVA方法調(diào)用的同步特性相結合.在異步模式下,結果數(shù)據(jù)在開始調(diào)用之后的一段時間之后才可以被異步訪問獲取到.DWR允許WEB開發(fā)人員傳遞一個回調(diào)函數(shù),來異步處理Java函數(shù)調(diào)用過程. 另處 .dwr還是文件的一種格式： 比如以Dreamweaver軟件里有查找和替換，經(jīng)常用的查找和替換內(nèi)容可以保存，保存的文件就是以 .dwr結尾的文件。這種文件用記事本打開后可以看到它的內(nèi)容。 使用方法 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應當調(diào)用類的默認構造函數(shù)來獲得實例，其他的還有spring方式，通過與IOC容器Spring進行集成來獲得實例等等。javascript=" testClass "屬性指定javascript代碼訪問對象時使用的名稱。 標簽指定要公開給javascript的java類名。 include>標簽指定要公開給javascript的方法。不指定的話就公開所有方法。 exclude>標簽指定要防止被訪問的方法。 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ù)配置文件自動生成的，engine.js和util.js是dwr自帶的腳本文件。 其次，編寫調(diào)用java方法的javascript函數(shù) Function callTestMethod1(){ testClass.testMethod1(); } 2、調(diào)用有簡單返回值的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){ //其中data接收方法的返回值 //可以在這里對返回值進行處理和顯示等等 alert("the return value is " + data); } 其中callBackFortestMethod2是接收返回值的回調(diào)函數(shù) 3、調(diào)用有簡單參數(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(){ //定義要傳到java方法中的參數(shù) var data; //構造參數(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>標簽負責公開用于Web遠程的類和類的方法，convertor>標簽則負責這些方法的參數(shù)和返回類型。convert元素的作用是告訴DWR在服務器端Java 對象表示和序列化的JavaScript之間如何轉(zhuǎn)換數(shù)據(jù)類型。DWR自動地在Java和JavaScript表示之間調(diào)整簡單數(shù)據(jù)類型。這些類型包括Java原生類型和它們各自的封裝類表示，還有String、Date、數(shù)組和集合類型。DWR也能把JavaBean轉(zhuǎn)換成JavaScript 表示，但是出于安全性的原因，要求顯式的配置，convertor>標簽就是完成此功能的。converter="bean"屬性指定轉(zhuǎn)換的方式采用JavaBean命名規(guī)范，match=""com.dwr.TestBean"屬性指定要轉(zhuǎn)換的javabean名稱，標簽指定要轉(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){ //其中data接收方法的返回值 //對于JavaBean返回值，有兩種方式處理 //不知道屬性名稱時，使用如下方法 for(var property in data){ alert("property:"+property); alert(property+":"+data[property]); } //知道屬性名稱時，使用如下方法 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(){ //定義要傳到java方法中的參數(shù) var data; //構造參數(shù)，data實際上是一個object data = { username:"user", password:"password" } testClass.testMethod5(data); } 6、調(diào)用返回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、數(shù)組和集合類型，則不需要convert>標簽。 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){ //其中data接收方法的返回值 //對于JavaBean返回值，有兩種方式處理 //不知道屬性名稱時，使用如下方法 for(var i=0;idata.length;i++){ for(var property in data[i]){ alert("property:"+property); alert(property+":"+data[i][property]); } } //知道屬性名稱時，使用如下方法 for(var i=0;idata.length;i++){ alert(data[i].username); alert(data[i].password); } } 7、調(diào)用有List、Set或者Map參數(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(ListTestBean>); ]]> /signatures> /dwr> signatures>標簽是用來聲明java方法中List、Set或者Map參數(shù)所包含的確切類，以便java代碼作出判斷。 7.2、javascript中調(diào)用(以返回List為例，List的元素為TestBean) 首先，引入javascript腳本 其次，編寫調(diào)用java方法的javascript函數(shù) Function callTestMethod7(){ //定義要傳到java方法中的參數(shù) var data; //構造參數(shù)，data實際上是一個object數(shù)組，即數(shù)組的每個元素均為object data = [ { username:"user1", password:"password2" }, { username:"user2", password:" password2" } ]; testClass.testMethod7(data); } 注意： 1、對于第6種情況，如果java方法的返回值為Map，則在接收該返回值的javascript回調(diào)函數(shù)中如下處理： function callBackFortestMethod(data){ //其中data接收方法的返回值 for(var property in data){ var bean = data[property]; alert(bean.username); alert(bean.password); } } 2、對于第7種情況，如果java的方法的參數(shù)為Map（假設其key為String，value為TestBean），則在調(diào)用該方法的javascript函數(shù)中用如下方法構造要傳遞的參數(shù)： function callTestMethod (){ //定義要傳到java方法中的參數(shù) var data; //構造參數(shù)，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(MapString,TestBean>); ]]> /signatures> 3、由以上可以發(fā)現(xiàn)，對于java方法的返回值為List(Set)的情況，DWR將其轉(zhuǎn)化為Object數(shù)組，傳遞個javascript；對于java方法的返回值為Map的情況，DWR將其轉(zhuǎn)化為一個Object，其中Object的屬性為原Map的key值，屬性值為原Map相應的value值。 4、如果java方法的參數(shù)為List(Set)和Map的情況，javascript中也要根據(jù)3種所說，構造相應的javascript數(shù)據(jù)來傳遞到java中 特別說明： 創(chuàng)建時要先實例化：var obj = new Object(); obj = {key:"value"}; 也可以obj.key = "value"; 如果沒有初始化，則會轉(zhuǎn)換出錯。 安裝配置 1. 安裝 DWR JAR 包 下載 dwr.jar 文件，然后將它放在 web 程序的 WEB-INF/lib 目錄下面，很可能在這個目錄下已經(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> 接下來創(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 遠程使用的類。在上面的例子中我們在遠程創(chuàng)建了2個類，并且給出了在 Javascript 中的類名。 上面使用的 new creator 使用了所有的 JavaBeans 必須含有的公有（public）無參（no-args）的構造函數(shù)。值得一提的是， DWR 還有一些限制： 避免使用 JavaScript 保留字；以保留字命名的方法將自動被排除。大多數(shù) JavaScript 的保留字同時也是 Java 的保留字，因此無論如何你也不能使用一個名為 “try()” 的方法。但是最常用的一個詞 “delete()”，在 JavaScript 中有特殊的含義而在 Java 中沒有。 重載方法（Overloaded methods）將會在調(diào)用的時候陷入未知的狀況，因此應該避免重載方法。 3. 訪問下面的地址 http://localhost:8080/[YOUR-WEBAPP]/dwr/ 你應該會看到一個頁面，上面顯示了剛才你在第二步所創(chuàng)建的類。進入一個鏈接之后你會看到所有等待調(diào)用方法的列表。這些動態(tài)產(chǎn)生的例子你也能通過 DWR 來實現(xiàn)。 親自嘗試和體會下吧。 怎樣應用到你的 Web 程序中？ 在側邊欄有很多例子演示了怎樣改變網(wǎng)頁中的文本、更新列表、操作表單和動態(tài)修改表格。每一個例子都有詳細的說明。 另外一個開始方法就是從頁面中查看源代碼，這些頁面你剛剛瀏覽過： 進入 http://localhost:8080/[YOUR-WEBAPP]/dwr/ 然后點擊你創(chuàng)建的類； 查看源代碼然后定位到你所感興趣的方法的代碼行； 將這些文本粘貼到你 Web 程序的一個 HTML 或 JSP頁面中； 包含下面的 javascrip 文件： script src=’/[YOUR-WEBAPP]/dwr/interface/[YOUR-SCRIPT].js’>/script> script src=’/[YOUR-WEBAPP]/dwr/engine.js’>/script> 你可以根據(jù)實際情況修改 /[YOUR-WEBAPP]/ 部分。
加入技術交流群
評論