DIV CSS 佈局教程網

JavaScript 策略模式實踐:打造可擴展的表單校驗器
編輯:關於JavaScript     

策略模式的定義只有一句話:定義一系列算法,把它們各自封裝起來,並使它們可以互相替換,讓算法的變化獨立於使用算法的客戶。這句話聽著抽象,落到表單校驗場景上卻格外貼切。

從一個再熟悉不過的表單說起

先寫一個簡單的註冊表單:

 <!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<style>
.form{ width: 400px; height: 200px; margin: 0px auto; }
.form-item-label{ width: 100px; text-align: right; float: left; }
.form-item-input{ float: left; }
.form-item{ width: 100% ; height: 50px; line-height: 50px; }
</style>
</head>
<body>
<div class='form'>
<div class="form-item">
  <div class='form-item-label'><span>用戶名:</span></div>
  <div class='form-item-input'><input id='userName' name='用戶名' type="text"></div>
</div>
<div class="form-item">
  <div class='form-item-label'><span>密碼:</span></div>
  <div class='form-item-input'><input id='password' name='密碼' type="text"></div>
</div>
<div class="form-item">
  <div class='form-item-label'><span>確認密碼:</span></div>
  <div class='form-item-input'><input id='repassword' name='密碼確認' type="text"></div>
</div>
<div class="form-item">
  <div class='form-item-label'><span>郵箱:</span></div>
  <div class='form-item-input'><input id='mail' name='郵箱' type="text"></div>
</div>
</div>
<br>
<button id='submit'>提交</button>
<script type='text/javascript' src="../reference/jquery-1.11.3.min.js"></script>
</body>
</html>

常見但糟糕的寫法

頁面上編輯完信息提交時,幾乎都要做校驗。多數項目裡,這些校驗要麼直接堆在提交函數裡,要麼集中寫進一個 check 函數:

 $(document).ready(function(){
  $('#submit').bind('click', doSubmit);
});

function doSubmit(){
  var eleUserName = document.getElementById('userName');
  if (eleUserName.value === '') {
    alert('用戶名不能為空');
    return;
  }
  if (eleUserName.length < 6) {
    alert('用戶名長度不能少於6個字符');
    return;
  }
  if (eleUserName.length > 20) {
    alert('用戶名長度不能多於20個字符');
    return;
  }
}

功能上它確實能跑,但問題有三:

複用變成了複製。換個頁面要用,只能整段拷貝。哪怕稍微整理封裝一下,重複仍然大量存在。

難以擴展,違背開閉原則。要新增一條校驗規則,就必須回去改提交函數,函數越改越臃腫。

回歸成本極高。動過提交函數,就得把相關測試全部重跑一遍,因為你永遠不知道哪一處會被誤改。

改造思路:四步走

1、把每一條校驗邏輯視為一個「校驗策略」,封裝成獨立函數,參數保持統一;
2、定義一個校驗器,可以批量導入策略,也可以單獨添加;
3、校驗器對外提供校驗方法,內部調度具體策略;
4、在業務處調用校驗器。

步驟一:把 if 抽成策略

把每個 if 看作一條業務規則,將所有規則收攏到一個策略對象中:

 var validationStrategies = {
  isNoEmpty: function(element, errMsg, value) {
    if (value === '') {
      return this.buildInvalidObj(element, errMsg, value);
    }
  },
  minLength: function(element, errMsg, value, length) {
    if (value.length < length) {
      return this.buildInvalidObj(element, errMsg, value);
    }
  },
  maxLength: function(element, errMsg, value, length) {
    if (value.length > length) {
      return this.buildInvalidObj(element, errMsg, value);
    }
  },
  isMail: function(element, errMsg, value) {
    var reg = /^(\w-*\.*)+@(\w-?)+(\.\w{2,})+$/;
    if (!reg.test(value)) {
      return this.buildInvalidObj(element, errMsg, value);
    }
  }
};

約定很簡單:前 3 個參數固定且必填,分別是被校驗的 DOM 元素、錯誤消息、被校驗的值;第 4 個參數起由各策略自行決定,可以有任意多個。buildInvalidObj 只是把前三個參數打包成一個錯誤對象返回,校驗不通過時就返回它。

依據依賴倒置原則,高層模塊不應直接依賴低層模塊,所以不能讓調用方直接上手策略對象,需要一層封裝與抽象。

步驟二:定義校驗器

 // 輸入校驗器
function InputValidators(){
  this.validators = [];
  this.strategies = {};
}

// 從策略對象批量導入
// strategies: 包含各種策略函數的對象
InputValidators.prototype.importStrategies = function(strategies) {
  for (var strategyName in strategies) {
    this.addValidationStrategy(strategyName, strategies[strategyName]);
  }
};

// 單獨添加一個策略
// name: 策略名稱  strategy: 策略函數
InputValidators.prototype.addValidationStrategy = function(name, strategy){
  this.strategies[name] = strategy;
};

步驟三:提供對外校驗方法

第一個參數 rule 是校驗規則表達式,例如 "minLength:6"。下面的實現會把它解析成對具體策略函數的調用,並壓入隊列等待統一執行;":6" 就是策略函數所需的定制參數。

 // 添加校驗方法
// rule: 校驗策略字符串
// element: 被校驗的dom元素
// errMsg: 校驗失敗時顯示的提示信息
// value: 被校驗的值
InputValidators.prototype.addValidator = function(rule, element, errMsg, value) {
  var that = this;
  var ruleElements = rule.split(":");
  this.validators.push(function() {
    var strategy = ruleElements.shift();
    var params = ruleElements;
    params.unshift(value);
    params.unshift(errMsg);
    params.unshift(element);
    return that.strategies[strategy].apply(that, params);
  });
};

// 開始校驗
InputValidators.prototype.check = function() {
  for (var i = 0, validator; validator = this.validators[i++];) {
    var result = validator();
    if (result) {
      return result;
    }
  }
};

// 校驗失敗時打包錯誤信息
InputValidators.prototype.buildInvalidObj = function(element, errMsg, value){
  return {
    'value': value,
    'element': element,
    'errMsg': errMsg
  };
};

步驟四:在業務處調用

先創建校驗器實例,導入策略,必要時即時追加自定義策略:

 var validators = new InputValidators();

validators.importStrategies(validationStrategies);

validators.addValidationStrategy('isEqual', function(element, errMsg, value1, value2) {
  if (value1 !== value2) {
    return this.buildInvalidObj(element, errMsg, value1);
  }
});

可見策略既可以是預先封裝好的通用規則,也可以按實際情況臨時補充。接著把「用哪條規則、校驗哪個元素、提示什麼文案、校驗什麼值」逐條註冊進去,避免了直接調用策略對象,耦合度顯著降低:

 var eleUserName = document.getElementById('userName');
validators.addValidator('isNoEmpty', eleUserName, '用戶名不能為空', eleUserName.value);
validators.addValidator('minLength:6', eleUserName, '用戶名的字符個數必須是6到20個', eleUserName.value);
validators.addValidator('maxLength:20', eleUserName, '用戶名的字符個數必須是6到20個', eleUserName.value);

var elePassword = document.getElementById('password');
validators.addValidator('isNoEmpty', elePassword, '密碼不能為空', elePassword.value);
validators.addValidator('minLength:6', elePassword, '密碼的字符個數必須是6到20個', elePassword.value);
validators.addValidator('maxLength:20', elePassword, '密碼的字符個數必須是6到20個', elePassword.value);

var eleRepassword = document.getElementById('repassword');
validators.addValidator('isNoEmpty', eleRepassword, '確認密碼不能為空', eleRepassword.value);
validators.addValidator('minLength:6', eleRepassword, '確認密碼的字符個數必須是6到20個', eleRepassword.value);
validators.addValidator('maxLength:20', eleRepassword, '確認密碼的字符個數必須是6到20個', eleRepassword.value);
validators.addValidator('isEqual:' + elePassword.value, eleRepassword, '兩次密碼不一致', eleRepassword.value);

var eleMail = document.getElementById('mail');
validators.addValidator('isNoEmpty', eleMail, '郵箱不能為空', eleMail.value);
validators.addValidator('isMail', eleMail, '郵箱不是一個有效的格式', eleMail.value);

最後觸發校驗,並對返回的錯誤對象做統一處理:

 var result = validators.check();
if (result) {
  alert(result.errMsg);
  result.element.focus();
  result.element.select();
  return false;
}

check 返回的是錯誤對象,因此可以在校驗之後集中處理 DOM 反饋:設置焦點、選中內容,或者給輸入框外層套一圈紅色邊框。這些反饋邏輯只寫一次,對所有字段通用。

完整可運行代碼

 <!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<style>
.form{ width: 400px; height: 200px; margin: 0px auto; }
.form-item-label{ width: 100px; text-align: right; float: left; }
.form-item-input{ float: left; }
.form-item{ width: 100% ; height: 50px; line-height: 50px; }
</style>
</head>
<body>
<div class='form'>
<div class="form-item">
  <div class='form-item-label'><span>用戶名:</span></div>
  <div class='form-item-input'><input id='userName' name='用戶名' type="text"></div>
</div>
<div class="form-item">
  <div class='form-item-label'><span>密碼:</span></div>
  <div class='form-item-input'><input id='password' name='密碼' type="text"></div>
</div>
<div class="form-item">
  <div class='form-item-label'><span>確認密碼:</span></div>
  <div class='form-item-input'><input id='repassword' name='密碼確認' type="text"></div>
</div>
<div class="form-item">
  <div class='form-item-label'><span>郵箱:</span></div>
  <div class='form-item-input'><input id='mail' name='郵箱' type="text"></div>
</div>
</div>
<br>
<button id='submit'>提交</button>
<script type='text/javascript' src="../reference/jquery-1.11.3.min.js"></script>
<script type='text/javascript'>
$(document).ready(function(){
  $('#submit').bind('click', doSubmit);
});

function doSubmit(){
  var validators = new InputValidators();
  validators.importStrategies(validationStrategies);
  validators.addValidationStrategy('isEqual', function(element, errMsg, value1, value2) {
    if (value1 !== value2) {
      return this.buildInvalidObj(element, errMsg, value1);
    }
  });

  var eleUserName = document.getElementById('userName');
  validators.addValidator('isNoEmpty', eleUserName, '用戶名不能為空', eleUserName.value);
  validators.addValidator('minLength:6', eleUserName, '用戶名的字符個數必須是6到20個', eleUserName.value);
  validators.addValidator('maxLength:20', eleUserName, '用戶名的字符個數必須是6到20個', eleUserName.value);

  var elePassword = document.getElementById('password');
  validators.addValidator('isNoEmpty', elePassword, '密碼不能為空', elePassword.value);
  validators.addValidator('minLength:6', elePassword, '密碼的字符個數必須是6到20個', elePassword.value);
  validators.addValidator('maxLength:20', elePassword, '密碼的字符個數必須是6到20個', elePassword.value);

  var eleRepassword = document.getElementById('repassword');
  validators.addValidator('isNoEmpty', eleRepassword, '確認密碼不能為空', eleRepassword.value);
  validators.addValidator('minLength:6', eleRepassword, '確認密碼的字符個數必須是6到20個', eleRepassword.value);
  validators.addValidator('maxLength:20', eleRepassword, '確認密碼的字符個數必須是6到20個', eleRepassword.value);
  validators.addValidator('isEqual:' + elePassword.value, eleRepassword, '兩次密碼不一致', eleRepassword.value);

  var eleMail = document.getElementById('mail');
  validators.addValidator('isNoEmpty', eleMail, '郵箱不能為空', eleMail.value);
  validators.addValidator('isMail', eleMail, '郵箱不是一個有效的格式', eleMail.value);

  var result = validators.check();
  if (result) {
    alert(result.errMsg);
    result.element.focus();
    result.element.select();
    return false;
  }
  alert('驗證通過');
}

// 輸入校驗器
function InputValidators(){
  this.validators = [];
  this.strategies = {};
}

InputValidators.prototype.addValidator = function(rule, element, errMsg, value) {
  var that = this;
  var ruleElements = rule.split(":");
  this.validators.push(function() {
    var strategy = ruleElements.shift();
    var params = ruleElements;
    params.unshift(value);
    params.unshift(errMsg);
    params.unshift(element);
    return that.strategies[strategy].apply(that, params);
  });
};

InputValidators.prototype.addValidationStrategy = function(name, strategy){
  this.strategies[name] = strategy;
};

InputValidators.prototype.importStrategies = function(strategies) {
  for (var strategyName in strategies) {
    this.addValidationStrategy(strategyName, strategies[strategyName]);
  }
};

InputValidators.prototype.buildInvalidObj = function(element, errMsg, value){
  return { 'value': value, 'element': element, 'errMsg': errMsg };
};

InputValidators.prototype.check = function() {
  for (var i = 0, validator; validator = this.validators[i++];) {
    var result = validator();
    if (result) {
      return result;
    }
  }
};

// 校驗策略對象
var validationStrategies = {
  isNoEmpty: function(element, errMsg, value) {
    if (value === '') {
      return this.buildInvalidObj(element, errMsg, value);
    }
  },
  minLength: function(element, errMsg, value, length) {
    if (value.length < length) {
      return this.buildInvalidObj(element, errMsg, value);
    }
  },
  maxLength: function(element, errMsg, value, length) {
    if (value.length > length) {
      return this.buildInvalidObj(element, errMsg, value);
    }
  },
  isMail: function(element, errMsg, value) {
    var reg = /^(\w-*\.*)+@(\w-?)+(\.\w{2,})+$/;
    if (!reg.test(value)) {
      return this.buildInvalidObj(element, errMsg, value);
    }
  }
};
</script>
</body>
</html>

改造帶來了什麼

用策略模式重構之後,校驗時我們只需關心兩件事:用哪一條規則,給什麼提示文案。實現細節被完全隱藏,調用變得清爽,後續擴展與組件化也有了穩固的落腳點——新增規則只是往策略對象裡多掛一個函數,一行都不用改動提交邏輯。

這正是策略模式的價值所在:它把「穩定不變的調度流程」與「頻繁變化的規則細節」切成了兩層,讓變化被限制在該變的地方。

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