從DWR官網下載最新版本的jar包,地址:http://directwebremoting.org/dwr/downloads/index.html
將jar包放入WEB-INF的lib文件夾下。同時,dwr依賴於commons-logging.jar這個包,所以必須將這個jar包也放入到WEB-INF的lib文件夾相愛。
首先是配置dwr的環境:
1. web.xml文件:
1
2
3
4
5
6
7
8
9
10
11
12
13
|
< servlet > < servlet-name >dwr-invoker</ servlet-name > < servlet-class >uk.ltd.getahead.dwr.DWRServlet</ servlet-class > < init-param > < param-name >debug</ param-name > < param-value >true</ param-value > </ init-param > </ servlet > < servlet-mapping > < servlet-name >dwr-invoker</ servlet-name > < url-pattern >/dwr/*</ url-pattern > </ servlet-mapping > |
2. 從官網的jar.war文件中利用winRAR等軟件提取出dwr.xml文件,並將其放入到WEB-INF文件夾下。
dwr.xml是dwr的核心配置文件,主要的標籤有:<converter>、<convert>、<create>這三個標籤。
<converter>標籤是dwr中內置的轉換器。我們也可以使用自己寫的轉換器,不過dwr提供的轉換器已經足夠了,所以這個標籤,一般不會自己去寫。
<convert>標籤是將converter中定義的轉換器映射到的具體類型,如:
1
2
3
4
|
< converter
id = "date" class = "org.directwebremoting.convert.DateConverter" /> <!--
註冊了 date 轉換器 --> <!--
注意:converter標籤必須放到<init>標籤內,而convert是放在<allow>標籤內,這裏只是示例,並不是完整的dwr.xml --> < convert
converter = "date" match = "java.util.Date" /> <!--
將註冊的 date 轉換器應用到 java.util.Date 類型 --> |
<create>標籤是dwr中重要的標籤,用來描述 java(服務器端) 與 javascript (客戶端)的交互方式。其基本格式如下:
1
2
3
4
5
6
7
8
9
|
< allow > < create
creator = "..."
javascript = "..."
scope = "..." > < param
name = "..."
value = "..." /> < auth
method = "..."
role = "..." /> < exclude
method = "..." /> < include
method = "..." /> </ create > ... </ allow > |
其中,creator和javascript是必須屬性,其他可以忽略。creator包含有以下幾個值:
new:Java用“new”關鍵字創造對象
none:它不創建對象 (v1.1+)
scripted:通過BSF使用腳本語言創建對象,例如BeanShell或Groovy
spring:通過Spring框架訪問Bean
struts:使用Struts的FormBean (v1.1+)
jsf:使用JSF的Bean (v1.1+)
pageflow:訪問Weblogic或Beehive的PageFlow (v1.1+)
ejb3:使用EJB3 session bean (v2.0+)
關於這幾個屬性如何使用,這裏就不在詳細闡述了。我只列出一個與spring整合的例子:
1
2
3
4
5
6
7
8
9
10
|
< create
creator = "spring"
javascript = "backUpDocumentService" > < param
name = "beanName"
value = "testDWR1"
/> < include
method = "modifyBackUpFiles" ></ include > < include
method = "isSafeCodeRight" ></ include > </ create > <!--
加include可以具體指定java類中關的方法,不加則默認類中全部爲public的方法 --> < create
creator = "spring"
javascript = "testDWR2" > < param
name = "beanName"
value = "testDWR2"
/> </ create > |
spring配置文件
1
2
|
< bean
id = "testDWR1"
class = "com.test.testDWR1" ></ bean > < bean
id = "testDWR2"
class = "com.test.testDWR2" ></ bean > |
3. 頁面配置
在jsp頁面添加三個 js 文件,分別是
1
2
3
|
< script
type = 'text/javascript'
src = 'js/util.js' ></ script > < script
type = 'text/javascript'
src = 'js/engine.js' ></ script > < script
type = 'text/javascript'
src = 'dwr/interface/testDWR1.js' > |
其中engine.js必須要,如果需要用到dwr提供的一些方便的工具要引用util.js ,然後是dwr自動生成的js文件,名字必須和dwr.xml中create標籤的javascript屬性值一樣,且是dwr/interface開頭的目錄
4. 接下來就可以分別寫javascript和java代碼了。
javascript代碼:
1
2
3
4
5
6
|
function
testFun() { var
name = "aaaaa" ; testDWR1.testFun(name,
returnFun); //調用java方法,第二個參數是回調函數 } function
returnFun(data) { //data對應着java方法的返回值 alert(data); } |
java代碼:
1
2
3
4
5
6
7
8
|
package
com.test; public
class
testDWR1 { public
String test(String str) { str
+= "bbb" ; return
str; } } |
5. 其他
dwr可以設置是否採用異步方式訪問java代碼,其代碼爲:
1
|
dwr.engine.setAsync( false ); //false爲同步,true(默認)爲異步 |
以及dwr對於異常的處理,這裏我只列出個簡單的全局性異常捕獲,具體到針對某個方法的異常捕獲,大家可以自己上網找找。
1
2
3
4
5
|
dwr.engine.setErrorHandler(errh); function
errh(errorString, exception) { errorFlag
= true ; alert( "操作失敗!" ); } |
dwr同樣支持參數爲對象的方法,這需要在dwr.xml中配置下<convert>標籤:
1
|
< convert
converter = "bean"
match = "com.example.Person" /> |
那麼關於dwr我也只介紹到這裏了,這基本就是dwr的基本內容了,可以滿足普通的項目需求了。
想進一步對於dwr的深入可以查詢下相關文章或查看api,這裏我就不再說的那麼詳細了。