作者:zhipingch(原創)
去年初,我正好負責一個醫藥資訊系統的設計開發。架構設計時採用了 Struts + JDBC,持久層部分則自定義以 adapter 模式封裝了 HashMap 動態 VO 來實作。後來 Ajax 熱潮興起,而系統裡正好有很多地方需要與伺服器端互動資料——例如採購銷售系統中「訂單頭/訂單明細」這類主從表結構的維護。
更新/儲存:前台封裝所需的 XML,透過 Ajax 提交 → Action 解析 XML → 改造原有的持久層,使其支援 XML 持久化。
查詢:持久層依實際需要回傳 XML(Document 物件)→ Action 處理 → 前台以自製 JS 庫解析 XML,並局部刷新頁面。
跨瀏覽器的 Ajax 實作已經有許多成熟方案,這裡只介紹最簡單的一種:以同步模式把 XML 字串提交給 Action(*.do)。
/**
* 將資料同步傳遞給後台請求 url
*
* @param urlStr 例如 '/web/module/xxx.do?p1=YY&p2=RR'
* @param xmlStr xml 格式的字串
* <data><xpath><![CDATA[數據信息]]></xpath></data>
* @return 回傳 xmlhttp 的響應內容
*
* @author zhipingch
* @date 2005-03-17
*/
function sendData(urlStr, xmlStr) {
var xmlhttp = new ActiveXObject("Microsoft.XMLHTTP");
xmlhttp.open("POST", urlStr, false);
xmlhttp.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
if (xmlStr) {
xmlhttp.send(xmlStr);
} else {
xmlhttp.send();
}
return xmlhttp.responseXml;
}
這裡用 open(..., false) 走同步模式,好處是呼叫端可以直接拿到回傳值,程式讀起來像一般函式呼叫;代價則是送出期間瀏覽器會被凍結。在資料量小、互動單純的內部系統情境下,這個取捨是可以接受的;若要在對外系統使用,仍建議改回非同步並搭配回呼。
我們擴充了 Struts 的 Action,讓它能直接把 XML 字串轉成 Document 物件(使用 dom4j),並完善了轉發方式。
先看 DispatchAction 的標準用法:
<action path="/admin/user" name="userForm" scope="request"
parameter="method" validate="false">
<forward name="list" path="/admin/userList.jsp"/>
</action>
其中 parameter="method" 指定了用來挑選回應方法的 URL 參數名。於是 /admin/user.do?method=list 會呼叫 UserAction 的 public ActionForward list(...);而 unspecified(...) 則可指定不帶 method 參數時的預設方法。
但這裡有個不太順的地方:你必須在 URL 後多傳一個 method=list,同時 action 節點配置裡的 parameter="method" 又沒被充分利用,反而顯得有點累贅。
因此我們直接在 BaseDispatchAction 中加入了 XML 字串解析,並充分利用 action 節點配置裡的 parameter 屬性,讓轉發時 Action 能直接派送(dispatch)到子類別的對應方法。這樣做的好處是:
method 參數,網址更乾淨。struts-config.xml 的設定決定,而非由客戶端傳入——這同時也收斂了可被外部操控的參數面。Document,不必重複寫轉換程式碼。這樣一來,設定檔成了單一真相來源,Action 的分派邏輯與 XML 解析邏輯各自獨立,整體結構清爽不少。
<![CDATA[...]]> 包住內容能避開轉義問題,但內容中若出現 ]]> 仍會提早結束區段。更穩健的做法是在伺服器端輸出前統一轉義。整體回顧,這個案子最值得留下的經驗是:Ajax 帶來的價值不只是「畫面不閃」,而是讓你能為「一次互動」選擇最合適的資料格式與分派方式。當資料結構本身是巢狀的,XML 加上一個會解析它的基底 Action,就能把前後台的契約講得很清楚。