DIV CSS 佈局教程網

Ajax 同步驗證單號是否重複:實作與更推薦的非同步寫法
編輯:AJAX基礎知識     

新增資料前先確認單號沒被用過,是很常見的防呆需求。以下示範以同步 Ajax 在送出前攔一次的做法,並說明為什麼實務上更應該改成非同步。

同步版本

// 保存前執行的方法:ajax 同步呼叫後台驗證包裹單號是否存在
function doBeforeSave(){
    var packageCode = document.getElementById("packageCode").value;
    var temp = false;

    if (packageCode != "") {
        $.ajax({
            url: "${ctx}/finance/packageManagement!parcelsWhetherExists.do",
            type: 'post',
            async: false,                       // 同步:確保回值可用
            data: { packageCode: packageCode },
            success: function(result) {
                temp = eval(result.result);     // 將回傳字串轉為布林
            }
        });
    }

    if (!temp) {
        alert("包裹單號已存在!");
        toft.resetForm("addDataForm");          // 清空表單
        toft.id("packageCode").focus();
    }
    return temp;
}

這段程式碼的幾個問題

  • async: false 會凍結頁面:請求等待期間整個瀏覽器無法回應,網路稍慢使用者就會以為程式當機。現代瀏覽器對同步 XHR 已發出移除警告。
  • 用 eval() 解析回傳值不安全也不必要:若回應是 JSON,用 JSON.parse();更好的做法是直接要求後端回傳 JSON,並在 ajax 中指定 dataType: 'json',讓 jQuery 自動解析成真正的布林值,連轉型都省了。
  • 拿 DOM 元素的值有兼容性風險:document.getElementById("packageCode").Value 中 Value 大寫在標準 DOM 下是 undefined,應寫 .value。
  • 提示方式粗糙:alert 加清空整個表單,使用者得重填所有欄位。改成在欄位旁顯示錯誤訊息並聚焦該欄位,體驗好得多。
  • 後端仍須有唯一性約束:前端檢查只是防呆,真正防止重複的必須是資料庫的唯一索引,否則兩個並行請求仍可能同時通過檢查。

改寫:非同步版本

function doBeforeSave(callback){
    var packageCode = $.trim($("#packageCode").val());

    if (packageCode === "") {
        showFieldError("請輸入包裹單號");
        return;
    }

    $.ajax({
        url: "${ctx}/finance/packageManagement!parcelsWhetherExists.do",
        type: 'post',
        dataType: 'json',                 // 由 jQuery 負責解析
        data: { packageCode: packageCode },
        success: function(res){
            if (res.exists) {
                showFieldError("包裹單號已存在");
                $("#packageCode").focus();
                return;                   // 中止後續送出
            }
            clearFieldError();
            callback();                   // 驗證通過才繼續
        },
        error: function(){
            showFieldError("驗證失敗,請稍後再試");
        }
    });
}

// 呼叫方式:把「真正要做的事」當作回呼傳進去
$("#saveBtn").on("click", function(){
    doBeforeSave(function(){
        $("#addDataForm").submit();
    });
});

改用 Promise 語法會更直觀:

function checkPackageCode(code){
    return $.ajax({
        url: "${ctx}/finance/packageManagement!parcelsWhetherExists.do",
        type: 'post',
        dataType: 'json',
        data: { packageCode: code }
    });
}

$("#saveBtn").on("click", function(){
    var code = $.trim($("#packageCode").val());
    if (!code) { showFieldError("請輸入包裹單號"); return; }

    checkPackageCode(code)
        .done(function(res){
            if (!res.exists) { $("#addDataForm").submit(); }
        })
        .fail(function(){ showFieldError("驗證失敗,請稍後再試"); });
});

幾點補充

  • 若單號欄位需要「邊打邊提示」,可加上 debounce(例如 400ms)再發請求,並取消前一次未完成的請求,避免回應亂序。
  • 後端介面建議回傳結構化結果,例如 { exists: true, message: "單號已被使用" },比回傳裸字串再由前端 eval 可靠得多。
  • 表單送出後若後端仍判定重複(例如並發情境),應回傳明確的錯誤碼,由前端顯示訊息並保留使用者已填內容。

希望本文所述對你基於 Ajax 的開發有所幫助。

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