* @link http://www.pradosoft.com/
* @copyright Copyright © 2005 PradoSoft
* @license http://www.pradosoft.com/license/
* @version $Revision: $ $Date: $
* @package System.Web.UI.WebControls
*/
/**
* Using TBaseValidator class
*/
Prado::using('System.Web.UI.WebControls.TBaseValidator');
/**
* TRangeValidator class
*
* TRangeValidator tests whether an input value is within a specified range.
*
* TRangeValidator uses three key properties to perform its validation.
* The {@link setMinValue MinValue} and {@link setMaxValue MaxValue}
* properties specify the minimum and maximum values of the valid range.
* The {@link setDataType DataType} property is used to specify the
* data type of the value and the minimum and maximum range values.
* These values are converted to this data type before the validation
* operation is performed. The following value types are supported:
* - Integer A 32-bit signed integer data type.
* - Float A double-precision floating point number data type.
* - Date A date data type. The date format can be specified by
* setting {@link setDateFormat DateFormat} property, which must be recognizable
* by {@link TSimpleDateFormatter}. If the property is not set,
* the GNU date syntax is assumed.
* - String A string data type.
* - StringLength check for string length.
*
* The TRangeValidator allows a special DataType "StringLength" that
* can be used to verify minimum and maximum string length. The
* {@link setCharset Charset} property can be used to force a particular
* charset for comparison. Otherwise, the application charset is used and is
* defaulted as UTF-8.
*
* @author Qiang Xue
* @version $Revision: $ $Date: $
* @package System.Web.UI.WebControls
* @since 3.0
*/
class TRangeValidator extends TBaseValidator
{
/**
* Gets the name of the javascript class responsible for performing validation for this control.
* This method overrides the parent implementation.
* @return string the javascript class name
*/
protected function getClientClassName()
{
return 'Prado.WebUI.TRangeValidator';
}
/**
* @return string the minimum value of the validation range.
*/
public function getMinValue()
{
return $this->getViewState('MinValue','');
}
/**
* Sets the minimum value of the validation range.
* @param string the minimum value
*/
public function setMinValue($value)
{
$this->setViewState('MinValue',$value,'');
}
/**
* @return string the maximum value of the validation range.
*/
public function getMaxValue()
{
return $this->getViewState('MaxValue','');
}
/**
* Sets the maximum value of the validation range.
* @param string the maximum value
*/
public function setMaxValue($value)
{
$this->setViewState('MaxValue',$value,'');
}
/**
* @return TRangeValidationDataType the data type that the values being compared are
* converted to before the comparison is made. Defaults to TRangeValidationDataType::String.
*/
public function getDataType()
{
return $this->getViewState('DataType',TRangeValidationDataType::String);
}
/**
* Sets the data type that the values being compared are converted to before the comparison is made.
* @param TRangeValidationDataType the data type
*/
public function setDataType($value)
{
$this->setViewState('DataType',TPropertyValue::ensureEnum($value,'TRangeValidationDataType'),TRangeValidationDataType::String);
}
/**
* Sets the date format for a date validation
* @param string the date format value
*/
public function setDateFormat($value)
{
$this->setViewState('DateFormat', $value, '');
}
/**
* @return string the date validation date format if any
*/
public function getDateFormat()
{
return $this->getViewState('DateFormat', '');
}
/**
* @param string charset for string length comparison.
*/
public function setCharset($value)
{
$this->setViewState('Charset', $value, '');
}
/**
* @return string charset for string length comparison.
*/
public function getCharset()
{
return $this->getViewState('Charset', '');
}
/**
* This method overrides the parent's implementation.
* The validation succeeds if the input data is within the range.
* The validation always succeeds if the input data is empty.
* @return boolean whether the validation succeeds
*/
protected function evaluateIsValid()
{
$value=$this->getValidationValue($this->getValidationTarget());
if($value==='')
return true;
switch($this->getDataType())
{
case TRangeValidationDataType::Integer:
return $this->isValidInteger($value);
case TRangeValidationDataType::Float:
return $this->isValidFloat($value);
case TRangeValidationDataType::Date:
return $this->isValidDate($value);
case TRangeValidationDataType::StringLength:
return $this->isValidStringLength($value);
default:
return $this->isValidString($value);
}
}
/**
* Determine if the value is within the integer range.
* @param string value to validate true
* @return boolean true if within integer range.
*/
protected function isValidInteger($value)
{
$minValue=$this->getMinValue();
$maxValue=$this->getMaxValue();
$value=intval($value);
$valid=true;
if($minValue!=='')
$valid=$valid && ($value>=intval($minValue));
if($maxValue!=='')
$valid=$valid && ($value<=intval($maxValue));
return $valid;
}
/**
* Determine if the value is within the specified float range.
* @param string value to validate
* @return boolean true if within range.
*/
protected function isValidFloat($value)
{
$minValue=$this->getMinValue();
$maxValue=$this->getMaxValue();
$value=floatval($value);
$valid=true;
if($minValue!=='')
$valid=$valid && ($value>=floatval($minValue));
if($maxValue!=='')
$valid=$valid && ($value<=floatval($maxValue));
return $valid;
}
/**
* Determine if the date is within the specified range.
* Uses pradoParseDate and strtotime to get the date from string.
* @param string date as string to validate
* @return boolean true if within range.
*/
protected function isValidDate($value)
{
$minValue=$this->getMinValue();
$maxValue=$this->getMaxValue();
$valid=true;
$dateFormat = $this->getDateFormat();
if($dateFormat!=='')
{
$formatter=Prado::createComponent('System.Util.TSimpleDateFormatter', $dateFormat);
$value = $formatter->parse($value, $dateFormat);
if($minValue!=='')
$valid=$valid && ($value>=$formatter->parse($minValue));
if($maxValue!=='')
$valid=$valid && ($value<=$formatter->parse($maxValue));
return $valid;
}
else
{
$value=strtotime($value);
if($minValue!=='')
$valid=$valid && ($value>=strtotime($minValue));
if($maxValue!=='')
$valid=$valid && ($value<=strtotime($maxValue));
return $valid;
}
}
/**
* Compare the string with a minimum and a maxiumum value.
* Uses strcmp for comparision.
* @param string value to compare with.
* @return boolean true if the string is within range.
*/
protected function isValidString($value)
{
$minValue=$this->getMinValue();
$maxValue=$this->getMaxValue();
$valid=true;
if($minValue!=='')
$valid=$valid && (strcmp($value,$minValue)>=0);
if($maxValue!=='')
$valid=$valid && (strcmp($value,$maxValue)<=0);
return $valid;
}
/**
* @param string string for comparision
* @return boolean true if min and max string length are satisfied.
*/
protected function isValidStringLength($value)
{
$minValue=$this->getMinValue();
$maxValue=$this->getMaxValue();
$valid=true;
$charset = $this->getCharset();
if($charset==='')
{
$app= $this->getApplication()->getGlobalization();
$charset = $app ? $app->getCharset() : null;
if(!$charset)
$charset = 'UTF-8';
}
$length = iconv_strlen($value, $charset);
if($minValue!=='')
$valid = $valid && $length >= intval($minValue);
if($maxValue!=='')
$valid = $valid && $length <= intval($maxValue);
return $valid;
}
/**
* Returns an array of javascript validator options.
* @return array javascript validator options.
*/
protected function getClientScriptOptions()
{
$options=parent::getClientScriptOptions();
$options['MinValue']=$this->getMinValue();
$options['MaxValue']=$this->getMaxValue();
$options['DataType']=$this->getDataType();
if(($dateFormat=$this->getDateFormat())!=='')
$options['DateFormat']=$dateFormat;
return $options;
}
}
/**
* TRangeValidationDataType class.
* TRangeValidationDataType defines the enumerable type for the possible data types that
* a range validator can validate upon.
*
* The following enumerable values are defined:
* - Integer
* - Float
* - Date
* - String
* - StringLength
*
* @author Qiang Xue
* @version $Revision: $ $Date: $
* @package System.Web.UI.WebControls
* @since 3.0.4
*/
class TRangeValidationDataType extends TValidationDataType
{
const StringLength='StringLength';
}
?>