本文闡述如何運用開源專案 DWR(Direct Web Remoting)與 Ajax(非同步 JavaScript 和 XML)來提升 Web 應用的可用性,並一步步展示 DWR 如何讓 Ajax 應用既簡單又快捷。
Ajax 描述了一種開發技術,混合使用 HTML(或 XHTML)與 CSS 來表達資訊、以 DOM 與 JavaScript 動態顯示並互動,並透過 XMLHttpRequest 物件與 Web 伺服器非同步交換與處理資料。
網路上雖然有許多在 HTML 檔內使用 XMLHttpRequest 與伺服器互動的範例,但手工撰寫與維護這些程式碼時,開發者必須面對許多潛在問題,特別是跨瀏覽器的 DOM 相容性,往往得耗費大量時間在 JavaScript 的編碼與除錯上。
DWR 是在 Apache 授權下的開源方案,提供一套 JavaScript 功能集,把從 HTML 頁面呼叫應用伺服器上 Java 物件方法的過程簡化,能處理不同型別的參數,同時保持 HTML 程式碼的可讀性。它不是對某個設計的強制插入,也不要求物件採用繼承結構,能與 Servlet 框架良好搭配。對缺乏 DHTML 經驗的開發者,DWR 也提供了組表、填充下拉選單、改變 HTML 元素內容等常用任務的 JavaScript 庫。
本文的示例應用模擬一個多倫多的公寓租賃搜尋引擎。使用者可先選擇一組搜尋條件。Ajax 在此有兩種應用:
· 即時通告符合條件的搜尋結果數量,當使用者變動臥室、浴室數量或價格範圍時即時更新,若無結果或結果過多就不必點搜尋鈕;
· 按下「顯示結果」鈕時,由 Ajax 執行資料庫查詢並取回結果,整個頁面不需重新載入。
資料庫採用 HSQL,這是一種佔用資源極小的 Java SQL 引擎,可隨 Web 應用一起打包而無需安裝設定。應用包含兩個主要類別:Apartment(帶有屬性與 getter/setter 的簡單 Java 類別)與 ApartmentDAO(負責查詢資料庫並依使用者條件回傳結果的資料存取類別)。
設定 DWR 很簡單:把 DWR 的 jar 檔複製到 WEB-INF/lib,在 web.xml 增加 servlet 宣告,並建立 DWR 設定檔:
<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>
把 debug 設為 true 可進入除錯模式,此時可從 /WEBAPP/dwr 這個網址看到所有可存取的 Java 物件及其公用方法,方便直接在頁面上測試。
接著用 dwr.xml 設定檔告訴 DWR 哪些物件可接收請求。DWR 預設基於安全考量不會轉換普通 bean,因此要用 <convert> 標記把 Apartment 轉為 JavaScript 可用的形式,並用 <create> 與 <include> 標記開放特定方法:
<dwr>
<allow>
<convert converter="bean" match="dwr.sample.Apartment"/>
<create creator="new" Javascript="ApartmentDAO" class="dwr.sample.ApartmentDAO">
<include method="findApartments"/>
<include method="countApartments"/>
</create>
</allow>
</dwr>
設定完成後,DWR 會自動為你準備好可從頁面呼叫的 JavaScript 介面,不需自行撰寫。在 search.JSP 中只要加入三行:
<script src='dwr/interface/ApartmentDAO.JS'></script>
<script src='dwr/engine.JS'></script>
<script src='dwr/util.JS'></script>
當使用者變更搜尋條件時,呼叫 ApartmentDAO.countApartments(),第一個參數 loadTotal() 是接收伺服器回傳後要呼叫的 JavaScript 方法:
function updateTotal() {
$("resultTable").style.display = 'none';
var bedrooms = document.getElementById("bedrooms").value;
var bathrooms = document.getElementById("bathrooms").value;
var price = document.getElementById("price").value;
ApartmentDAO.countApartments(loadTotal, bedrooms, bathrooms, price);}
function loadTotal(data) {
document.getElementById("totalRecords").innerHtml = data;}
當使用者按下「顯示結果」鈕時,updateResults() 會清空結果表格、取出參數並呼叫 findApartments(),再由 fillTable() 把回傳的物件顯示到頁面上:
function updateResults() {
DWRUtil.removeAllRows("apartmentsbody");
var bedrooms = document.getElementById("bedrooms").value;
var bathrooms = document.getElementById("bathrooms").value;
var price = document.getElementById("price").value;
ApartmentDAO.findApartments(fillTable, bedrooms, bathrooms, price);
$("resultTable").style.display = '';}
function fillTable(apartment) {
DWRUtil.addRows("apartmentsbody", apartment, [ getId, getAddress, getBedrooms, getBathrooms, getPrice ]);}
為保持示例簡潔,ApartmentDAO 的 setter 方法(如 insert、update、delete)並未開放,但實務上 DWR 會把所有公用方法暴露給所有 HTML 頁面呼叫,直接暴露資料存取層並不明智。建議建立一個 Facade 集中所有 JavaScript 函式與底層業務元件之間的通訊,藉此限制過度暴露的功能,確保系統安全。