近期的專案一直用 jQuery validation 搭配 Bootstrap 與 jQuery Form 做表單驗證,整體效果不錯。但 remote 驗證的緩存問題讓我頭痛了很久,一度想放棄這個外掛。
現有「學校、年級、班級」三層架構,規則是:同一所學校下不能有相同的年級,同一年級下不能有相同的班級。
以「同一學校下不能有相同年級」為例,用 remote 方式驗證:
"gradeId" : {
required : true,
min : 0,
remote: {
url: "gradeManager-checkGrade.action",
type: "post",
dataType: "json",
data: {
'gradeId' : function() {
return $("#gradeId").val();
},
'schoolId' : function() {
return $("#schoolId").val();
}
}
}
}
對應的 HTML:
<div class="control-group">
<label class="control-label" for="schoolId">學校</label>
<div class="controls">
<s:select name="schoolId" list="schools" listKey="schoolId"
listValue="schoolName" headerKey="-1" headerValue="請選擇學校"></s:select>
</div>
</div>
<div class="control-group">
<label class="control-label" for="gradeId">年級</label>
<div class="controls">
<s:select name="gradeId" list="grades" listKey="gradeId"
listValue="gradeName" headerKey="-1" headerValue="請選擇年級"></s:select>
</div>
</div>
假設有「測試學校 1」與「測試學校 2」,其中測試學校 1 底下有「小學一年級」與「小學二年級」。
第一次操作時結果正確:選擇測試學校 1 再選小學一年級,remote 驗證如預期報出「該年級已經存在」。

但接著把學校改成測試學校 2,由於緩存問題,validation 不會重新送出 remote 請求,而是直接沿用上一次的結果,於是出現莫名其妙的錯誤:

更嚴重的是這個順序:先選測試學校 2 與小學一年級,驗證通過;此時改選測試學校 1,remote 依然回報通過——「同一學校下不能有相同年級」這條規則就等於失效了。
cache: false:實測沒有解決問題。.valid() 主動觸發驗證:因為緩存仍在,remote 沒有重新請求。翻閱 validation 的原始碼,發現裡面有個 previousValue 變數,一旦它有值就會直接回傳前一次的驗證結果:

既然問題出在這個殘留狀態,把它清掉就是了:
$("#schoolId").change(function(){
$("#gradeId").removeData("previousValue");
});
問題成功解決。
這個緩存其實是有意的優化:remote 驗證會打伺服器,若每次 keyup 都請求,壓力太大。所以外掛會記住「同一組輸入值」的驗證結果,輸入沒變就不重送。
但這個設計有一個前提假設:驗證結果只取決於該欄位自己的值。當 remote 的 data 中參考了其他欄位(如本例的 schoolId),這個假設就破了——其他欄位變了,自己的值沒變,緩存便回傳過期的結論。
除了逐一清除 previousValue,也可以更明確地在相依欄位變動時,同時重設目標欄位的驗證狀態:
$("#schoolId").change(function(){
var $grade = $("#gradeId");
$grade.removeData("previousValue"); // 清掉舊的 remote 結果
$grade.closest("form").validate().element($grade); // 重新驗證
});
如果相依關係較複雜,也可以考慮在 remote 的 data 中把 schoolId 編進請求的 cache key 概念裡——也就是讓伺服器端一次檢查完整組合,前端則在任一相依欄位變動時統一觸發重驗。重點是:只要 remote 的參數依賴其他欄位,就必須處理緩存失效,這是使用這個外掛時值得牢記的一條規則。