Ajax是時下比較流行的一種web界面設計新思路,其核心思想是從瀏覽器獲取XMLHttp對象與服務器端進行交互. DWR（Direct Web Remoting）就是實現(xiàn)了這種Ajax技術的一種web框架. 最近做的項目中我也將它用上了,感覺很是方便,比如動態(tài)生成javascript代碼,隱藏的http協(xié)議,java代碼和javascript交互的是javascript的對象(或字符串). 下面是我整理的文檔.
DWR主要由兩部門組成。javascript與web服務器通信并更新web頁；運行在web服務器的Servlet處理請求并把響應發(fā)回瀏覽器。
1 . 配置web.xml
<servlet>
<servlet-name>dwr-invoker</servlet-name>
<servlet-class>uk.ltd.getahead.dwr.DWRServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>dwr-invoker</servlet-name>
<url-pattern>/dwr/*</url-pattern>
</servlet-mapping>
2 當我們想看dwr自動生成的測試頁時,可在java代碼
servlet中加
<init-param>
<param-name>debug</param-name>
<param-value>true</param-value>
</init-param>
這個參數(shù)DWR默認是false.如果選擇true.我們可以通過url http://localhost:port/app/dwr ,你就可以看到你部署的每個DWR class。并且可以測試java代碼的每個方法是否運行正常。為了安全考慮，在正式環(huán)境下你一定把這個參數(shù)設為false.
3 log信息配置
我喜歡用log4j輸出日志,那么在log4j.properties下加，log4j.logger.uk.ltd.getahead.dwr = debug。這樣可以看DWR的調試日志。
4 配置dwr.xml (和web.xml同目錄)
<create creator="new" javascript="JDate">
<param name="class" value="java.util.Date"/>
</create>
這里的多數(shù)元素都是可選的 - 你真正必須知道的是指定一個creator和一個javascript名字。
creator屬性 是必須的 - 它用來指定使用那種創(chuàng)造器。
默認情況下DWR1.1有8種創(chuàng)造器。它們是：
- new: 用Java的new關鍵字創(chuàng)造對象。
- none: 它不創(chuàng)建對象，看下面的原因。 (v1.1+)
- scripted: 通過BSF使用腳本語言創(chuàng)建對象，例如BeanShell或Groovy。
- spring: 通過Spring框架訪問Bean。
- jsf: 使用JSF的Bean。 (v1.1+)
- struts: 使用Struts的FormBean。 (v1.1+)
- pageflow: 訪問Beehive或Weblogic的PageFlow。 (v1.1+)
javascript屬性 用于指定瀏覽器中這個被創(chuàng)造出來的對象的名字。你不能使用Javascript的關鍵字。
scope屬性 非常類似servlet規(guī)范中的scope。 它允許你指定這個bean在什么生命范圍。選項有"application", "session", "request" 和"page"。這些值對于Servlet和JSP開發(fā)者來說應該相當熟悉了。
scope屬性是可選的。默認是"page"。如果要使用"session"需要cookies。當前的DWR不支持ULR重寫。
param元素 被用來指定創(chuàng)造器的其他參數(shù)，每種構造器各有不同。例如，"new"創(chuàng)造器需要知道要創(chuàng)建的對象類型是什么。每一個創(chuàng)造器的參數(shù)在各自的文檔中能找到。請查看上面的鏈接。
include和exclude元素 允許創(chuàng)造器來限制類中方法的訪問。一個創(chuàng)造器必須指定include列表或exclude列表之一。如果是include列表則暗示默認的訪問策略是"拒絕"；如果是exclude列表則暗示默認的訪問策略是"允許"。
5 dwr.jar下載后放lib下
源碼淺析
dwr的設計很象webwork2的設計,隱藏http協(xié)議,擴展性，兼容性及強。
通過研究uk.ltd.getahead.dwr.DWRServlet這個servlet來研究下dwr到底是如何工作的。
<servlet>
<servlet-name>dwr-invoker</servlet-name>
<servlet-class>uk.ltd.getahead.dwr.DWRServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>dwr-invoker</servlet-name>
<url-pattern>/dwr/*</url-pattern>
</servlet-mapping>
這樣/dwr/*下的所有的請求都是由這個servlet來處理,到底生理了什么呢,我們還是以例子來說明吧.
1 web服務器啟動，DWRServlet init()方法調用，init主要做了以下工作。
設置日志級別、實例化DWR用到的單例類（這些類在jvm中只有一個實例對象）、讀去配置文件（包括dwr.jar包中的dwr.xml,WEB-INF/dwr.xml. config*.xml）。
2 請求處理
DWRServlet.doGet, doPost方法都調用processor.handle(req, resp)方法處理。Processor對象在init()方法中已經初始化了。
代碼
public void handle(HttpServletRequest req, HttpServletResponse resp)
throws IOException
{
String pathinfo = req.getPathInfo();
if(pathinfo == null || pathinfo.length() == 0 || pathinfo.equals("/"))
{
resp.sendRedirect(req.getContextPath() + req.getServletPath() + '/' + "index.html");
} else
if(pathinfo != null && pathinfo.equalsIgnoreCase("/index.html"))
{
doIndex(req, resp);
} else
if(pathinfo != null && pathinfo.startsWith("/test/"))
{
doTest(req, resp);
} else
if(pathinfo != null && pathinfo.equalsIgnoreCase("/engine.js"))
{
doFile(resp, "engine.js", "text/javascript");
} else
if(pathinfo != null && pathinfo.equalsIgnoreCase("/util.js"))
{
doFile(resp, "util.js", "text/javascript");
} else
if(pathinfo != null && pathinfo.equalsIgnoreCase("/deprecated.js"))
{
doFile(resp, "deprecated.js", "text/javascript");
} else
if(pathinfo != null && pathinfo.startsWith("/interface/"))
{
doInterface(req, resp);
} else
if(pathinfo != null && pathinfo.startsWith("/exec"))
{
doExec(req, resp);
} else
{
log.warn("Page not found. In debug/test mode try viewing /[WEB-APP]/dwr/");
resp.sendError(404);
}
}
dwr/*處理的請求也就這幾種。
（1）dwr/index.html，dwr/test/這種只能在debug模式下使用，調試用。
dwr/engine.js，dwr/util.js，dwr/deprecated.js當這個請求到達，從dwr.jar包中讀取文件流，響應回去。（重復請求有緩存）
（2）當dwr/interface/這種請求到來，（例如我們在index.html中的 <script type='text/javascript' src='dwr/interface/JDate.js'></script>）DWR做一件偉大的事。把我們在WEB-INF/dwr.xml中的
<create creator="new" javascript="JDate">
<param name="class" value="java.util.Date"/>
</create>
java.util.Date轉化為javascript函數(shù)。
http://localhost:port/simpledwr/dwr/interface/JDate.js看看吧。
細節(jié)也比較簡單，通過java反射，把方法都寫成javascript特定的方法。（我覺得這些轉換可以放到緩存里，下次調用沒必要再生成一遍，不知道作者為什么沒這樣做）。
（3）dwr/exec
javascript調用方法時發(fā)送這種請求，可能是XMLHttpRequest或IFrame發(fā)送。
當然，javascript調用的方法簽名與java代碼一致，包括參數(shù)，還有javascript的回調方法也傳到了服務器端，在服務器端很容易實現(xiàn)。回調方法的java的執(zhí)行結果 返回類似 <script>callMethod(結果)<script>的javascript字符串,在瀏覽器執(zhí)行。哈，一切就這么簡單，巧妙。
我這里還有DWR中文文檔. http://www.tkk7.com/Files/LiuTing/DWR中文文檔.rar