package com.easyjf.web.validate;

/**
 * EasyJWeb中驗證器的基類，實現了Validaotr接口。<br>
 * 提供了addError供子類調用，從而使驗證結果的添加非常容易。
 * 用戶自定義的驗證器類均可直接繼承該類實現。
 * @author 大峽
 * 
 */
public abstract class AbstractValidator implements Validator {
	/**
	 * 往驗證結果信中添加驗證錯誤
	 * @param obj 驗證的目標對象
	 * @param value 要驗證的值
	 * @param errors 驗證錯誤提示結果集
	 */
	public void addError(TargetObject obj, Object value, Errors errors) {
		addError(obj, value, errors, null);
	}

	/**
	 * 往驗證結果集中添加一條自定義的驗證錯誤信息，針對類似StringRequired中的min_msg等特殊的驗證提示信息使用。
	 * @param obj 驗證目錄對象
	 * @param value 驗證的值
	 * @param errors 驗證錯誤結果集
	 * @param customMessage 自定義的驗證出錯提示信息
	 */
	public void addError(TargetObject obj, Object value, Errors errors,
			String customMessage) {
		ValidateResult result = errors.getErrorObject(obj.getFieldName());
		if (result == null) {
			result = new ValidateResult(obj, value);
			errors.addError(result);
		}
		result.addErrorValidator(this);		
		if (customMessage != null)
			result.addCustomMessage(this, customMessage);
	}
}