DIV CSS 佈局教程網

jQuery + Struts 打造可重複使用的唯一標識校驗方案
編輯:JQuery特效代碼     

後台系統裡,無論是頁面標識、分類標識還是下載資源標識,幾乎都離不開「唯一性校驗」這件事。與其每個表單各寫一套判斷邏輯,不如抽出一份通用方法:前端負責即時提示,後端負責真正比對資料庫。下面這套實作以 jQuery 搭配 Struts,把「失去焦點就檢查」與「按下送出再檢查」兩種時機整合在同一個 callback 函式中,任何表單只要換掉控件 ID 就能直接複用。

步驟一:引入所需的 JS 檔案

先在頁面中載入 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>

步驟二:撰寫公用腳本 dictionary.js

核心概念是:把需要校驗的輸入框 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 中的回應方法

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();
  }
}

步驟五:DAO 層的查詢邏輯

這是全案最關鍵的一環。透過 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 越長越難維護。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved