後台系統裡,無論是頁面標識、分類標識還是下載資源標識,幾乎都離不開「唯一性校驗」這件事。與其每個表單各寫一套判斷邏輯,不如抽出一份通用方法:前端負責即時提示,後端負責真正比對資料庫。下面這套實作以 jQuery 搭配 Struts,把「失去焦點就檢查」與「按下送出再檢查」兩種時機整合在同一個 callback 函式中,任何表單只要換掉控件 ID 就能直接複用。
先在頁面中載入 jQuery 本體,再載入稍後要寫的公用腳本。這裡使用 Struts 的 <s:url> 標籤來拼接路徑,避免硬寫網址造成部署後失效。
<script language="javascript1.2" src="<s:url value="/js/jquery.js" includeParams="false"/>"></script>
<script language="javascript1.2" src="<s:url value="/js/dictionary.js" includeParams="false"/>"></script>
核心概念是:把需要校驗的輸入框 ID 與送出按鈕 ID 綁定到同一個 callback,讓「離開輸入框」和「點擊送出」共用同一套判斷流程。校驗分三層——非空檢查、格式檢查(只允許英數與底線)、最後才是向後端發出非同步請求確認是否重複。
/**
* 作者:ZhuangZi
* 類名:公用方法初始化
* 功能:公用方法初始化
* 版本:1.0
* 日期:2013-03-22
*/
$(function(){
/* 1. 失去焦點時驗證 */
// #code 為欲驗證唯一標識的控件 ID,且該控件後方必須有元素用來承載錯誤訊息
$("#code").blur(callback);
/* 2. 送出表單時驗證 */
// #submit 為表單送出按鈕的 ID
$("#submit").click(callback);
});
/**
* 作者:ZhuangZi
* 類名:驗證唯一標識公用方法
* 詳細:唯一標識 ID 與送出按鈕 ID 需與下方保持一致
* 版本:1.0
* 日期:2013-03-22
*/
function callback() {
var slef = $("#code");
var code = slef.val();
var submit = $("#submit");
var flag = $("#flag").val();
if (null == code || "" == code) {
slef.next().html("下載包標識不能為空!");
submit.attr("disabled", true);
return;
} else {
if (!code.match("^\\w+$")) {
slef.next().html("標識由數字、字母或下劃線組成!");
return;
}
slef.next().html("*");
}
$.ajax({
type: 'post',
url: '../dictionary/checkCodeOnly.do',
data: 'bean.code=' + code + '&bean.flag=' + flag,
dataType: 'json',
success: function(json){
if (json > 0) {
slef.next().html("此標識已存在!");
submit.attr("disabled", true);
return;
} else {
slef.next().html("");
if (code != null && code != "") {
submit.attr("disabled", false);
} else {
submit.attr("disabled", true);
return;
}
}
},
error: function(){
alert('驗證資訊出錯');
}
});
}
有兩個細節值得留意。第一,錯誤訊息是寫進 slef.next(),也就是輸入框的「下一個兄弟元素」,所以版面配置上務必在輸入框後面預留一個 <font> 或 <span> 當提示位。第二,送出按鈕的 disabled 狀態會依驗證結果即時切換,使用者不必等到按下送出才發現填錯。
頁面端只需要三個角色:一個隱藏欄位 flag 用來告訴後端「現在要驗哪一類標識」、一個輸入框 code,以及緊跟在後的提示元素。
<s:hidden id="flag" value="3"/> <!-- flag 代表標識的類型 -->
<tr>
<td width="40%" height="33" class="addtabletd1">下載標識:</td>
<td width="60%" height="33" class="addtabletd2">
<div align="left">
<s:textfield id="code" name="yhaoPortalsDownBean.downFlag"
cssClass="textfrom" cssStyle="width:150px;" maxlength="200"/>
<font id="codeInfo" color="red">*</font>
</div>
</td>
</tr>
Action 只負責把 Service 層的查詢結果序列化成 JSON 字串寫回 response。設定 Content-Type 與 UTF-8 編碼是必要動作,否則前端拿到的會是亂碼或直接解析失敗。
/**
* @author ZhuangZi
* @class com.hzdracom.action.YhaoPortalsDictionaryAction
* @method checkCodeOnly
* @Directions 驗證唯一標識公用方法
* @date 2013-3-21
*/
public void checkCodeOnly(){
String json = "";
try{
json = String.valueOf(yhaoDictionaryService.checkCodeOnly(bean));
json = JSON.toJSONString(json);
System.out.println("json==" + json);
HttpServletResponse response = ServletActionContext.getResponse();
response.setContentType("text/html");
response.setCharacterEncoding("utf-8");
PrintWriter out = response.getWriter();
out.println(json);
out.flush();
out.close();
} catch(Exception e){
e.printStackTrace();
}
}
這是全案最關鍵的一環。透過 flag 決定要查哪張表、哪個欄位,再用 count(1) 回傳命中筆數——大於 0 就代表標識已被佔用。使用參數陣列而非字串拼接,能有效避開 SQL 注入風險。
public int checkCodeOnly(DictionaryBean bean) throws DataAccessException, Exception {
Object[] sqlParams = new Object[4];
int index = 0;
String sql = "";
/* 驗證頁面標識是否唯一 */
if (bean.getFlag().equals("1")) {
sql = "select count(1) from YHAO_PORTALS_PAGE where PAGE_FLAG = ? ";
sqlParams[index++] = bean.getCode();
}
/* 驗證類型標識是否唯一 */
if (bean.getFlag().equals("2")) {
sql = "select count(1) from YHAO_PORTALS_DOWNTYPE where DOWNTYPE_FLAG = ? ";
sqlParams[index++] = bean.getCode();
}
/* 驗證下載標識是否唯一 */
if (bean.getFlag().equals("3")) {
sql = "select count(1) from YHAO_PORTALS_DOWN where DOWN_FLAG = ? ";
sqlParams[index++] = bean.getCode();
}
/* 驗證塊標識是否唯一 */
if (bean.getFlag().equals("4")) {
sql = "select count(1) from YHAO_PORTALS_KUAI where KUAI_FLAG = ? ";
sqlParams[index++] = bean.getCode();
}
Object[] sqlParamsEnd = new Object[index];
System.arraycopy(sqlParams, 0, sqlParamsEnd, 0, index);
return this.queryForInt(sql, sqlParamsEnd);
}
整份設計的精神在於「一個 callback,多處共用」。要複用時,替換的只有三個地方:輸入框 ID、送出按鈕 ID,以及 flag 的值;DAO 那邊再補上一段對應的 if 分支即可。若未來標識類型持續增加,建議把「flag 對應的表名與欄位」抽成設定檔或列舉,避免 if _chain 越長越難維護。