做過表單驗證的人都知道那種痛:填完一頁資料、送出、伺服器說「此帳號已存在」,然後整頁刷新、剛剛輸入的內容全部歸零。Ajax 的出現讓這類驗證可以在使用者輸入的當下完成,回饋即時、頁面不閃,體驗相當接近桌面程式。
本文以「新增使用者時即時檢查帳號是否可用」為例,示範如何把 Ajax 套進既有的 Struts 驗證流程。
Web 應用上的驗證大致分兩類:伺服器端方法與用戶端方法。Struts 驗證框架長期以來是 Java Web 環境的主流選擇,它能以設定檔描述伺服器端規則與錯誤訊息,也能產生用戶端的 JavaScript 驗證。Ajax 屬於 JavaScript 技術,可非同步呼叫伺服器並取得回應,正好補上「即時性」這一塊,讓整體流程更貼近桌面應用。
頁面載入 ywAJax.js,在帳號欄位旁預留一個用來顯示訊息的 div:
<script language="javascript" src="${ctx}/scripts/ywAjax.js"></script>
// 檢查使用者名稱是否已被註冊
function check(){
var userid = document.forms[0].userid.value;
var url = "oMActor.do?method=isUseridExit&userid=" + userid;
send_request(url, "load");
}
</script>
<div align="load" id="load" style="font-size:12px; color:#ff0000;"></div>
id 為 load 的 div 就是回應訊息的落點;把它的呼叫綁在帳號欄位的 onchange 或 onblur 上,即可在離開欄位時觸發檢查。
public class OMActorAction extends DispatchAction {
public ActionForward isUseridExit(ActionMapping mapping, ActionForm form,
HttpServletRequest request, HttpServletResponse response) throws Exception {
request.setCharacterEncoding("gb2312");
String username = request.getParameter("userid");
String msgStr = getActorService().isUserExit(username)
? "對不起,此使用者名稱已經存在,請更換後再註冊!"
: "使用者未被註冊,可以使用!";
response.setContentType("text/xml;charset=GB2312");
response.setHeader("Cache-Control", "no-cache");
PrintWriter out = response.getWriter();
out.println("<?xml version='1.0' encoding='GB2312' ?>");
out.println("<root><content>" + msgStr + "</content></root>");
out.close();
return null; // Ajax 請求不需 forward
}
}
重點是 return null:Ajax 請求期待的是一段資料,而不是新的 view。回應標頭記得設 no-cache,否則部分瀏覽器會快取驗證結果,讓使用者拿到過期訊息。
var http_request = false;
var divID = "";
function send_request(url, tag) {
divID = tag;
http_request = false;
if (window.XMLHttpRequest) { // Mozilla 系
http_request = new XMLHttpRequest();
if (http_request.overrideMimeType) {
http_request.overrideMimeType('text/xml');
}
} else if (window.ActiveXObject) { // IE
try {
http_request = new ActiveXObject("Msxml2.XMLHTTP");
} catch (e) {
try {
http_request = new ActiveXObject("Microsoft.XMLHTTP");
} catch (e) {}
}
}
if (!http_request) {
window.alert("無法建立 XMLHttpRequest 物件。");
return false;
}
http_request.open("GET", url, true);
http_request.onreadystatechange = processRequest;
http_request.send(null);
}
function processRequest() {
if (http_request.readyState != 4) return;
if (http_request.status == 200) {
document.getElementById(divID).innerHTML = http_request.responseText;
} else {
alert("您所請求的頁面有異常。");
}
}
把 div 的 id 當成參數傳入,讓同一支 send_request() 能服務多個欄位,這是很實用的小設計;日後若要擴充成共用的 Ajax 工具層,可以再往前一步把 XHR 建立封裝成獨立函式。
實務上還有三件事值得注意:使用者名稱必須先編碼再拼進 URL;驗證行程要避免每次按鍵都發一次請求,可加上 debounce;最後,Ajax 驗證只能當作即時提示,伺服器端在真正寫入資料前仍必須重跑一次完整驗證,因為用戶端的一切都可以被繞過。