pradosoft / prado

framework/pradolite.php

Doc Comments +655 added lines

@@ -78,6 +78,10 @@ 
 		}
 		exit(1);
 	}
+
+	/**
+	 * @param TApplication $application
+	 */
 	public static function setApplication($application)
 	{
 		if(self::$_application!==null && !defined('PRADO_TEST_RUN'))
@@ -371,14 +375,26 @@ 
 interface IModule
 {
 	public function init($config);
+
+	/**
+	 * @return string
+	 */
 	public function getID();
 	public function setID($id);
 }
 interface IService
 {
 	public function init($config);
+
+	/**
+	 * @return string
+	 */
 	public function getID();
 	public function setID($id);
+
+	/**
+	 * @return boolean
+	 */
 	public function getEnabled();
 	public function setEnabled($value);
 	public function run();
@@ -390,14 +406,37 @@ 
 }
 interface IUser
 {
+	/**
+	 * @return string
+	 */
 	public function getName();
 	public function setName($value);
+
+	/**
+	 * @return boolean
+	 */
 	public function getIsGuest();
+
+	/**
+	 * @param boolean $value
+	 */
 	public function setIsGuest($value);
 	public function getRoles();
 	public function setRoles($value);
+
+	/**
+	 * @return boolean
+	 */
 	public function isInRole($role);
+
+	/**
+	 * @return string
+	 */
 	public function saveToString();
+
+	/**
+	 * @return TUser
+	 */
 	public function loadFromString($string);
 }
 interface IStatePersister
@@ -409,6 +448,12 @@ 
 {
 	public function get($id);
 	public function set($id,$value,$expire=0,$dependency=null);
+
+	/**
+	 * @param string $id
+	 *
+	 * @return boolean
+	 */
 	public function add($id,$value,$expire=0,$dependency=null);
 	public function delete($id);
 	public function flush();
@@ -427,12 +472,22 @@ 
 }
 interface IStyleable
 {
+	/**
+	 * @return boolean
+	 */
 	public function getHasStyle();
+
+	/**
+	 * @return TStyle
+	 */
 	public function getStyle();
 	public function clearStyle();
 }
 interface IActiveControl
 {
+	/**
+	 * @return TBaseActiveControl
+	 */
 	public function getActiveControl();
 }
 interface ICallbackEventHandler
@@ -442,6 +497,10 @@ 
 interface IDataRenderer
 {
 	public function getData();
+
+	/**
+	 * @param TActiveRecord $value
+	 */
 	public function setData($value);
 }
 class TApplicationComponent extends TComponent
@@ -470,6 +529,10 @@ 
 	{
 		return Prado::getApplication()->getUser();
 	}
+
+	/**
+	 * @param string $assetPath
+	 */
 	public function publishAsset($assetPath,$className=null)
 	{
 		if($className===null)
@@ -478,6 +541,10 @@ 
 		$fullPath=dirname($class->getFileName()).DIRECTORY_SEPARATOR.$assetPath;
 		return $this->publishFilePath($fullPath);
 	}
+
+	/**
+	 * @param string $fullPath
+	 */
 	public function publishFilePath($fullPath, $checkTimestamp=false)
 	{
 		return Prado::getApplication()->getAssetManager()->publishFilePath($fullPath, $checkTimestamp);
@@ -509,6 +576,10 @@ 
 	{
 		return $this->_id;
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setID($value)
 	{
 		$this->_id=$value;
@@ -548,6 +619,10 @@ 
 		else
 			throw new TConfigurationException('errorhandler_errortemplatepath_invalid',$value);
 	}
+
+	/**
+	 * @param null|TApplication $sender
+	 */
 	public function handleError($sender,$param)
 	{
 		static $handling=false;
@@ -570,6 +645,10 @@ 
 				$this->handleExternalError(500,$param);
 		}
 	}
+
+	/**
+	 * @return string
+	 */
 	protected static function hideSecurityRelated($value, $exception=null)
 	{
 		$aRpl = array();
@@ -589,6 +668,10 @@ 
 		$aRpl = array_reverse($aRpl, true);
 		return str_replace(array_keys($aRpl), $aRpl, $value);
 	}
+
+	/**
+	 * @param integer $statusCode
+	 */
 	protected function handleExternalError($statusCode,$exception)
 	{
 		if(!($exception instanceof THttpException))
@@ -722,6 +805,10 @@ 
 			return null;
 		return $result;
 	}
+
+	/**
+	 * @param string $pattern
+	 */
 	private function getPropertyAccessTrace($trace,$pattern)
 	{
 		$result=null;
@@ -751,6 +838,10 @@ 
 		}
 		return $source;
 	}
+
+	/**
+	 * @param string $message
+	 */
 	private function addLink($message)
 	{
 		$baseUrl='http://pradosoft.github.io/docs/manual/class-';
@@ -772,6 +863,10 @@ 
 	{
 		return $this->_r;
 	}
+
+	/**
+	 * @param boolean $value
+	 */
 	protected function setReadOnly($value)
 	{
 		$this->_r=TPropertyValue::ensureBoolean($value);
@@ -1018,9 +1113,27 @@ 
 	{
 		throw new TNotSupportedException('cache_flush_unsupported');
 	}
+
+	/**
+	 * @param string $key
+	 */
 	abstract protected function getValue($key);
+
+	/**
+	 * @param string $key
+	 * @param integer $expire
+	 */
 	abstract protected function setValue($key,$value,$expire);
+
+	/**
+	 * @param string $key
+	 * @param integer $expire
+	 */
 	abstract protected function addValue($key,$value,$expire);
+
+	/**
+	 * @param string $key
+	 */
 	abstract protected function deleteValue($key);
 	public function offsetExists($id)
 	{
@@ -1109,14 +1222,26 @@ 
 	{
 		return $this->generateTimestamps($this->_directory)!=$this->_timestamps;
 	}
+
+	/**
+	 * @param string $fileName
+	 */
 	protected function validateFile($fileName)
 	{
 		return true;
 	}
+
+	/**
+	 * @param string $directory
+	 */
 	protected function validateDirectory($directory)
 	{
 		return true;
 	}
+
+	/**
+	 * @param string $directory
+	 */
 	protected function generateTimestamps($directory,$level=0)
 	{
 		if(($dir=opendir($directory))===false)
@@ -1207,6 +1332,10 @@ 
 		$this->_str='';
 		return $str;
 	}
+
+	/**
+	 * @param string $str
+	 */
 	public function write($str)
 	{
 		$this->_str.=$str;
@@ -1254,6 +1383,10 @@ 
 	{
 		return $this->_dp;
 	}
+
+	/**
+	 * @param integer $value
+	 */
 	protected function setDefaultPriority($value)
 	{
 		$this->_dp=(string)round(TPropertyValue::ensureFloat($value),$this->_p);
@@ -1262,6 +1395,10 @@ 
 	{
 		return $this->_p;
 	}
+
+	/**
+	 * @param integer $value
+	 */
 	protected function setPrecision($value)
 	{
 		$this->_p=TPropertyValue::ensureInteger($value);
@@ -1500,6 +1637,10 @@ 
 		$this->sortPriorities();
 		return $this->_d;
 	}
+
+	/**
+	 * @param integer $priority
+	 */
 	public function toArrayBelowPriority($priority,$inclusive=false)
 	{
 		$this->sortPriorities();
@@ -1512,6 +1653,10 @@ 
 		}
 		return $items;
 	}
+
+	/**
+	 * @param integer $priority
+	 */
 	public function toArrayAbovePriority($priority,$inclusive=true)
 	{
 		$this->sortPriorities();
@@ -1609,6 +1754,10 @@ 
 	{
 		return $this->_r;
 	}
+
+	/**
+	 * @param boolean $value
+	 */
 	protected function setReadOnly($value)
 	{
 		$this->_r=TPropertyValue::ensureBoolean($value);
@@ -1681,6 +1830,10 @@ 
 		else if($data!==null)
 			throw new TInvalidDataTypeException('map_data_not_iterable');
 	}
+
+	/**
+	 * @param TMap $data
+	 */
 	public function mergeWith($data)
 	{
 		if(is_array($data) || $data instanceof Traversable)
@@ -1732,6 +1885,10 @@ 
 	{
 		return $this->_r;
 	}
+
+	/**
+	 * @param boolean $value
+	 */
 	protected function setReadOnly($value)
 	{
 		$this->_r=TPropertyValue::ensureBoolean($value);
@@ -1740,6 +1897,10 @@ 
 	{
 		return $this->_dp;
 	}
+
+	/**
+	 * @param integer $value
+	 */
 	protected function setDefaultPriority($value)
 	{
 		$this->_dp = (string)round(TPropertyValue::ensureFloat($value), $this->_p);
@@ -1748,6 +1909,10 @@ 
 	{
 		return $this->_p;
 	}
+
+	/**
+	 * @param integer $value
+	 */
 	protected function setPrecision($value)
 	{
 		$this->_p=TPropertyValue::ensureInteger($value);
@@ -2133,6 +2298,10 @@ 
 	{
 		return $this->_parent;
 	}
+
+	/**
+	 * @param TXmlElement|null $parent
+	 */
 	public function setParent($parent)
 	{
 		$this->_parent=$parent;
@@ -2194,6 +2363,10 @@ 
 		}
 		return null;
 	}
+
+	/**
+	 * @param string $tagName
+	 */
 	public function getElementsByTagName($tagName)
 	{
 		$list=new TList;
@@ -2263,6 +2436,10 @@ 
 	{
 		return $this->_version;
 	}
+
+	/**
+	 * @param string $version
+	 */
 	public function setVersion($version)
 	{
 		$this->_version=$version;
@@ -2271,6 +2448,10 @@ 
 	{
 		return $this->_encoding;
 	}
+
+	/**
+	 * @param string $encoding
+	 */
 	public function setEncoding($encoding)
 	{
 		$this->_encoding=$encoding;
@@ -2499,10 +2680,18 @@ 
 		}
 		return 0;
 	}
+
+	/**
+	 * @param IUser $user
+	 */
 	private function isUserMatched($user)
 	{
 		return ($this->_everyone || ($this->_guest && $user->getIsGuest()) || ($this->_authenticated && !$user->getIsGuest()) || in_array(strtolower($user->getName()),$this->_users));
 	}
+
+	/**
+	 * @param IUser $user
+	 */
 	private function isRoleMatched($user)
 	{
 		foreach($this->_roles as $role)
@@ -2519,6 +2708,11 @@ 
 }
 class TAuthorizationRuleCollection extends TList
 {
+	/**
+	 * @param IUser $user
+	 * @param string $verb
+	 * @param string $ip
+	 */
 	public function isUserAllowed($user,$verb,$ip)
 	{
 		if($user instanceof IUser)
@@ -2626,6 +2820,10 @@ 
 	{
 		$this->_cryptAlgorithm = $value;
 	}
+
+	/**
+	 * @param string $data
+	 */
 	public function encrypt($data)
 	{
 		$module=$this->openCryptModule();
@@ -2638,6 +2836,10 @@ 
 		mcrypt_module_close($module);
 		return $encrypted;
 	}
+
+	/**
+	 * @param string $data
+	 */
 	public function decrypt($data)
 	{
 		$module=$this->openCryptModule();
@@ -2699,6 +2901,11 @@ 
 	{
 		return $this->_mbstring ? mb_strlen($string,'8bit') : strlen($string);
 	}
+
+	/**
+	 * @param integer $start
+	 * @param integer $length
+	 */
 	private function substr($string,$start,$length)
 	{
 		return $this->_mbstring ? mb_substr($string,$start,$length,'8bit') : substr($string,$start,$length);
@@ -2858,6 +3065,10 @@ 
 		self::checkJsonError();
 		return $s;
 	}
+
+	/**
+	 * @param string $sourceEncoding
+	 */
 	private static function convertToUtf8(&$value, $sourceEncoding) {
 		if(is_string($value))
 			$value=iconv($sourceEncoding, 'UTF-8', $value);
@@ -2867,6 +3078,10 @@ 
 				self::convertToUtf8($element, $sourceEncoding);
 		}
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public static function jsonDecode($value, $assoc = false, $depth = 512)
 	{
 		$s= @json_decode($value, $assoc, $depth);
@@ -2901,6 +3116,10 @@ 
 		}
 		throw new Exception("JSON error ($err): $msg");
 	}
+
+	/**
+	 * @param string $code
+	 */
 	public static function JSMin($code)
 	{
 		Prado::using('System.Web.Javascripts.JSMin');
@@ -3088,6 +3307,10 @@ 
 	{
 		return $this->getID();
 	}
+
+	/**
+	 * @param TUrlManager $manager
+	 */
 	protected function cacheUrlManager($manager)
 	{
 		if($this->getEnableCache())
@@ -3337,6 +3560,10 @@ 
 	{
 		return $_ENV;
 	}
+
+	/**
+	 * @param string $serviceID
+	 */
 	public function constructUrl($serviceID,$serviceParam,$getItems=null,$encodeAmpersand=true,$encodeGetItems=true)
 	{
 		if ($this->_cookieOnly===null)
@@ -3457,6 +3684,10 @@ 
 class THttpCookieCollection extends TList
 {
 	private $_o;
+
+	/**
+	 * @param THttpResponse $owner
+	 */
 	public function __construct($owner=null)
 	{
 		$this->_o=$owner;
@@ -3520,6 +3751,10 @@ 
 	{
 		return $this->_expire;
 	}
+
+	/**
+	 * @param integer $value
+	 */
 	public function setExpire($value)
 	{
 		$this->_expire=TPropertyValue::ensureInteger($value);
@@ -3586,6 +3821,10 @@ 
 	private $_query;
 	private $_fragment;
 	private $_uri;
+
+	/**
+	 * @param string $uri
+	 */
 	public function __construct($uri)
 	{
 		if(($ret=@parse_url($uri))!==false)
@@ -3651,6 +3890,10 @@ 
 class THttpResponseAdapter extends TApplicationComponent
 {
 	private $_response;
+
+	/**
+	 * @param THttpResponse $response
+	 */
 	public function __construct($response)
 	{
 		$this->_response=$response;
@@ -3746,6 +3989,10 @@ 
 	{
 		return $this->_charset;
 	}
+
+	/**
+	 * @param string $charset
+	 */
 	public function setCharset($charset)
 	{
 		$this->_charset = (strToLower($charset) === 'false') ? false : (string)$charset;
@@ -3969,6 +4216,10 @@ 
 			return array_change_key_case($result, $case);
 		return $result;
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function appendHeader($value, $replace=true)
 	{
 		header($value, $replace);
@@ -3977,6 +4228,10 @@ 
 	{
 		error_log($message,$messageType,$destination,$extraHeaders);
 	}
+
+	/**
+	 * @param THttpCookie $cookie
+	 */
 	public function addCookie($cookie)
 	{
 		$request=$this->getRequest();
@@ -4034,6 +4289,10 @@ 
 		else
 			return $this->createNewHtmlWriter($type, $this);
 	}
+
+	/**
+	 * @param THttpResponse $writer
+	 */
 	public function createNewHtmlWriter($type, $writer)
 	{
 		return Prado::createComponent($type, $writer);
@@ -4143,6 +4402,10 @@ 
 	{
 		return $this->_customStorage;
 	}
+
+	/**
+	 * @param boolean $value
+	 */
 	public function setUseCustomStorage($value)
 	{
 		$this->_customStorage=TPropertyValue::ensureBoolean($value);
@@ -4285,10 +4548,18 @@ 
 	{
 		return array_keys($_SESSION);
 	}
+
+	/**
+	 * @param string $key
+	 */
 	public function itemAt($key)
 	{
 		return isset($_SESSION[$key]) ? $_SESSION[$key] : null;
 	}
+
+	/**
+	 * @param string $key
+	 */
 	public function add($key,$value)
 	{
 		$_SESSION[$key]=$value;
@@ -4395,6 +4666,10 @@ 
 	{
 		return $this->_caseSensitive;
 	}
+
+	/**
+	 * @param boolean $value
+	 */
 	public function setCaseSensitive($value)
 	{
 		$this->_caseSensitive=TPropertyValue::ensureBoolean($value);
@@ -4407,6 +4682,10 @@ 
 	{
 		parent::add($this->_caseSensitive?$key:strtolower($key),$value);
 	}
+
+	/**
+	 * @param string $key
+	 */
 	public function remove($key)
 	{
 		return parent::remove($this->_caseSensitive?$key:strtolower($key));
@@ -4557,6 +4836,10 @@ 
 		}
 		return $this->_page;
 	}
+
+	/**
+	 * @param TPage $page
+	 */
 	public function setPage($page)
 	{
 		$this->_page=$page;
@@ -4700,6 +4983,10 @@ 
 		else
 			return $this->getViewState('Visible',true);
 	}
+
+	/**
+	 * @param boolean $value
+	 */
 	public function setVisible($value)
 	{
 		$this->setViewState('Visible',TPropertyValue::ensureBoolean($value),true);
@@ -4738,6 +5025,10 @@ 
 			return $attributes;
 		}
 	}
+
+	/**
+	 * @param string $name
+	 */
 	public function hasAttribute($name)
 	{
 		if($attributes=$this->getViewState('Attributes',null))
@@ -4745,6 +5036,10 @@ 
 		else
 			return false;
 	}
+
+	/**
+	 * @param string $name
+	 */
 	public function getAttribute($name)
 	{
 		if($attributes=$this->getViewState('Attributes',null))
@@ -4752,6 +5047,10 @@ 
 		else
 			return null;
 	}
+
+	/**
+	 * @param string $name
+	 */
 	public function setAttribute($name,$value)
 	{
 		$this->getAttributes()->add($name,$value);
@@ -4775,6 +5074,10 @@ 
 		else
 			return !($this->_flags & self::IS_DISABLE_VIEWSTATE);
 	}
+
+	/**
+	 * @param boolean $value
+	 */
 	public function setEnableViewState($value)
 	{
 		if(TPropertyValue::ensureBoolean($value))
@@ -4782,10 +5085,20 @@ 
 		else
 			$this->_flags |= self::IS_DISABLE_VIEWSTATE;
 	}
+
+	/**
+	 * @param string $key
+	 * @param integer $defaultValue
+	 */
 	protected function getControlState($key,$defaultValue=null)
 	{
 		return isset($this->_rf[self::RF_CONTROLSTATE][$key])?$this->_rf[self::RF_CONTROLSTATE][$key]:$defaultValue;
 	}
+
+	/**
+	 * @param string $key
+	 * @param integer $defaultValue
+	 */
 	protected function setControlState($key,$value,$defaultValue=null)
 	{
 		if($value===$defaultValue)
@@ -4797,6 +5110,10 @@ 
 	{
 		unset($this->_rf[self::RF_CONTROLSTATE][$key]);
 	}
+
+	/**
+	 * @param boolean $enabled
+	 */
 	public function trackViewState($enabled)
 	{
 		$this->_trackViewState=TPropertyValue::ensureBoolean($enabled);
@@ -4814,6 +5131,10 @@ 
 		else
 			return $defaultValue;
 	}
+
+	/**
+	 * @param string $key
+	 */
 	public function setViewState($key,$value,$defaultValue=null)
 	{
 		if($this->_trackViewState)
@@ -4833,6 +5154,10 @@ 
 				$this->_tempState[$key]=$value;
 		}
 	}
+
+	/**
+	 * @param string $key
+	 */
 	public function clearViewState($key)
 	{
 		unset($this->_viewState[$key]);
@@ -4889,6 +5214,10 @@ 
 	{
 		return ($this->_flags & self::IS_CHILD_CREATED)!==0;
 	}
+
+	/**
+	 * @param boolean $value
+	 */
 	final protected function setChildControlsCreated($value)
 	{
 		if($value)
@@ -4948,6 +5277,10 @@ 
 				return null;
 		}
 	}
+
+	/**
+	 * @param string $type
+	 */
 	public function findControlsByType($type,$strict=true)
 	{
 		$controls=array();
@@ -4985,6 +5318,10 @@ 
 		unset($this->_rf[self::RF_NAMED_CONTROLS_ID]);
 		$this->clearNameTable();
 	}
+
+	/**
+	 * @param TCheckBox $object
+	 */
 	public function registerObject($name,$object)
 	{
 		if(isset($this->_rf[self::RF_NAMED_OBJECTS][$name]))
@@ -5019,6 +5356,10 @@ 
 	{
 		return $this->getControlStage() >= self::CS_PRERENDERED;
 	}
+
+	/**
+	 * @param string $name
+	 */
 	public function getRegisteredObject($name)
 	{
 		return isset($this->_rf[self::RF_NAMED_OBJECTS][$name])?$this->_rf[self::RF_NAMED_OBJECTS][$name]:null;
@@ -5042,6 +5383,10 @@ 
 			$control=$control->_parent;
 		return $control===$ancestor;
 	}
+
+	/**
+	 * @param TControl $control
+	 */
 	public function addedControl($control)
 	{
 		if($control->_parent)
@@ -5080,6 +5425,10 @@ 
 			}
 		}
 	}
+
+	/**
+	 * @param TControl $control
+	 */
 	public function removedControl($control)
 	{
 		if($this->_namingContainer)
@@ -5225,6 +5574,10 @@ 
 		$rootControl=(($page=$this->getPage())===null)?$this:$page;
 		$rootControl->broadcastEventInternal($name,$sender,new TBroadcastEventParameter($name,$param));
 	}
+
+	/**
+	 * @param TBroadcastEventParameter $param
+	 */
 	private function broadcastEventInternal($name,$sender,$param)
 	{
 		if($this->hasEvent($name))
@@ -5370,6 +5723,10 @@ 
 		else if($this->_flags & self::IS_STYLESHEET_APPLIED)
 			throw new TInvalidOperationException('control_stylesheet_applied',get_class($this));
 	}
+
+	/**
+	 * @param boolean $recursive
+	 */
 	private function clearCachedUniqueID($recursive)
 	{
 		if($recursive && $this->_uid!==null && isset($this->_rf[self::RF_CONTROLS]))
@@ -5393,6 +5750,10 @@ 
 	{
 		unset($this->_rf[self::RF_NAMED_CONTROLS]);
 	}
+
+	/**
+	 * @param TControl $container
+	 */
 	private function fillNameTable($container,$controls)
 	{
 		foreach($controls as $control)
@@ -5465,11 +5826,18 @@ 
 }
 interface IPostBackEventHandler
 {
+	/**
+	 * @return void
+	 */
 	public function raisePostBackEvent($param);
 }
 interface IPostBackDataHandler
 {
 	public function loadPostData($key,$values);
+
+	/**
+	 * @return void
+	 */
 	public function raisePostDataChangedEvent();
 	public function getDataChanged();
 }
@@ -5477,8 +5845,16 @@ 
 {
 	public function validate();
 	public function getIsValid();
+
+	/**
+	 * @return void
+	 */
 	public function setIsValid($value);
 	public function getErrorMessage();
+
+	/**
+	 * @return void
+	 */
 	public function setErrorMessage($value);
 }
 interface IValidatable
@@ -5493,26 +5869,66 @@ 
 }
 interface ITheme
 {
+	/**
+	 * @return boolean
+	 */
 	public function applySkin($control);
 }
 interface ITemplate
 {
+	/**
+	 * @return void
+	 */
 	public function instantiateIn($parent);
 }
 interface IButtonControl
 {
 	public function getText();
+
+	/**
+	 * @param string $value
+	 *
+	 * @return void
+	 */
 	public function setText($value);
 	public function getCausesValidation();
+
+	/**
+	 * @return void
+	 */
 	public function setCausesValidation($value);
 	public function getCommandName();
+
+	/**
+	 * @return void
+	 */
 	public function setCommandName($value);
 	public function getCommandParameter();
+
+	/**
+	 * @return void
+	 */
 	public function setCommandParameter($value);
 	public function getValidationGroup();
+
+	/**
+	 * @return void
+	 */
 	public function setValidationGroup($value);
+
+	/**
+	 * @return void
+	 */
 	public function onClick($param);
+
+	/**
+	 * @return void
+	 */
 	public function onCommand($param);
+
+	/**
+	 * @return void
+	 */
 	public function setIsDefaultButton($value);
 	public function getIsDefaultButton();
 }
@@ -5970,6 +6386,10 @@ 
 	{
 		return $this->_customStyle===null?'':$this->_customStyle;
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setCustomStyle($value)
 	{
 		$this->_customStyle=$value;
@@ -5978,6 +6398,11 @@ 
 	{
 		return isset($this->_fields[$name])?$this->_fields[$name]:'';
 	}
+
+	/**
+	 * @param string $name
+	 * @param string $value
+	 */
 	public function setStyleField($name,$value)
 	{
 		$this->_fields[$name]=$value;
@@ -6473,6 +6898,10 @@ 
 {
 	private $_ensureid=false;
 	protected $_decorator;
+
+	/**
+	 * @param boolean $value
+	 */
 	public function setEnsureId($value)
 	{
 		$this->_ensureid |= TPropertyValue::ensureBoolean($value);
@@ -6562,6 +6991,10 @@ 
 		else
 			return '';
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setForeColor($value)
 	{
 		$this->getStyle()->setForeColor($value);
@@ -6592,6 +7025,10 @@ 
 		else
 			return '';
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setHeight($value)
 	{
 		$this->getStyle()->setHeight($value);
@@ -6653,6 +7090,10 @@ 
 		else
 			return '';
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setWidth($value)
 	{
 		$this->getStyle()->setWidth($value);
@@ -6780,6 +7221,10 @@ 
 			$tpl->instantiateIn($this);
 		}
 	}
+
+	/**
+	 * @param string $id
+	 */
 	public function registerContent($id,TContent $object)
 	{
 		if(isset($this->_contents[$id]))
@@ -6787,6 +7232,10 @@ 
 		else
 			$this->_contents[$id]=$object;
 	}
+
+	/**
+	 * @param string $id
+	 */
 	public function registerContentPlaceHolder($id,TContentPlaceHolder $object)
 	{
 		if(isset($this->_placeholders[$id]))
@@ -6983,6 +7432,10 @@ 
 	{
 		return $this->getViewState('Enctype','');
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setEnctype($value)
 	{
 		$this->setViewState('Enctype',$value,'');
@@ -7102,6 +7555,10 @@ 
 		$scripts = array_unique($scripts);
 		return $scripts;
 	}
+
+	/**
+	 * @param string $base
+	 */
 	protected function getPackagePathUrl($base)
 	{
 		$assets = Prado::getApplication()->getAssetManager();
@@ -7251,6 +7708,11 @@ 
 		$params=func_get_args();
 		$this->_page->registerCachingAction('Page.ClientScript','registerEndScript',$params);
 	}
+
+	/**
+	 * @param string $name
+	 * @param string $value
+	 */
 	public function registerHiddenField($name,$value)
 	{
 		$this->_hiddenFields[$name]=$value;
@@ -7388,6 +7850,10 @@ 
 			$this->renderAllPendingScriptFiles($writer);
 		}
 	}
+
+	/**
+	 * @param boolean $initial
+	 */
 	protected function renderHiddenFieldsInt($writer, $initial)
  	{
 		if ($initial) $this->_renderedHiddenFields = array();
@@ -7423,12 +7889,20 @@ 
 abstract class TClientSideOptions extends TComponent
 {
 	private $_options;
+
+	/**
+	 * @param string $name
+	 */
 	protected function setFunction($name, $code)
 	{
 		if(!TJavaScript::isJsLiteral($code))
 			$code = TJavaScript::quoteJsLiteral($this->ensureFunction($code));
 		$this->setOption($name, $code);
 	}
+
+	/**
+	 * @param string $name
+	 */
 	protected function getOption($name)
 	{
 		if ($this->_options)
@@ -7551,6 +8025,10 @@ 
 		$this->renderControl($writer);
 		$this->unloadRecursive();
 	}
+
+	/**
+	 * @param string $enc
+	 */
 	protected static function decodeUTF8($data, $enc)
 	{
 		if(is_array($data))
@@ -7633,6 +8111,10 @@ 
 		else
 			throw new TInvalidOperationException('page_form_duplicated');
 	}
+
+	/**
+	 * @param string $validationGroup
+	 */
 	public function getValidators($validationGroup=null)
 	{
 		if(!$this->_validators)
@@ -7703,6 +8185,10 @@ 
 	{
 		$this->_styleSheet=empty($value)?null:$value;
 	}
+
+	/**
+	 * @param TControl $control
+	 */
 	public function applyControlSkin($control)
 	{
 		if(($theme=$this->getTheme())!==null)
@@ -7850,6 +8336,10 @@ 
 	{
 		$this->_postBackEventParameter=$value;
 	}
+
+	/**
+	 * @param boolean $beforeLoad
+	 */
 	protected function processPostData($postData,$beforeLoad)
 	{
 		$this->_isLoadingPostData=true;
@@ -7938,6 +8428,10 @@ 
 			$this->getClientScript()->registerFocusControl($lastFocus);
 		$this->_inFormRender=false;
 	}
+
+	/**
+	 * @param TControl $value
+	 */
 	public function setFocus($value)
 	{
 		$this->_focus=$value;
@@ -7983,6 +8477,10 @@ 
 	{
 		return $this->_clientState;
 	}
+
+	/**
+	 * @param string $state
+	 */
 	public function setClientState($state)
 	{
 		$this->_clientState=$state;
@@ -8042,6 +8540,11 @@ 
 	{
 		$this->_pagePath=$value;
 	}
+
+	/**
+	 * @param string $context
+	 * @param string $funcName
+	 */
 	public function registerCachingAction($context,$funcName,$funcParams)
 	{
 		if($this->_cachingStack)
@@ -8064,13 +8567,27 @@ 
 }
 interface IPageStatePersister
 {
+	/**
+	 * @return TPage
+	 */
 	public function getPage();
+
+	/**
+	 * @return void
+	 */
 	public function setPage(TPage $page);
+
+	/**
+	 * @return void
+	 */
 	public function save($state);
 	public function load();
 }
 class TPageStateFormatter
 {
+	/**
+	 * @param TPage $page
+	 */
 	public static function serialize($page,$data)
 	{
 		$sm=$page->getApplication()->getSecurityManager();
@@ -8084,6 +8601,10 @@ 
 			$str=$sm->encrypt($str);
 		return base64_encode($str);
 	}
+
+	/**
+	 * @param TPage $page
+	 */
 	public static function unserialize($page,$data)
 	{
 		$str=base64_decode($data);
@@ -8277,6 +8798,10 @@ 
 	{
 		$this->_cacheModuleID=$value;
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setCacheKeyPrefix($value)
 	{
 		$this->_keyPrefix=$value;
@@ -8327,10 +8852,18 @@ 
 	{
 		$this->_cachePostBack=TPropertyValue::ensureBoolean($value);
 	}
+
+	/**
+	 * @param TOutputCacheCheckDependencyEventParameter $param
+	 */
 	public function onCheckDependency($param)
 	{
 		$this->raiseEvent('OnCheckDependency',$this,$param);
 	}
+
+	/**
+	 * @param TOutputCacheCalculateKeyEventParameter $param
+	 */
 	public function onCalculateKey($param)
 	{
 		$this->raiseEvent('OnCalculateKey',$this,$param);
@@ -8422,6 +8955,10 @@ 
 		$tplFile=dirname($class->getFileName()).DIRECTORY_SEPARATOR.$className.self::TEMPLATE_FILE_EXT;
 		return $this->getTemplateByFileName($tplFile);
 	}
+
+	/**
+	 * @param string $fileName
+	 */
 	public function getTemplateByFileName($fileName)
 	{
 		if(($fileName=$this->getLocalizedTemplate($fileName))!==null)
@@ -8461,6 +8998,10 @@ 
 		else
 			return null;
 	}
+
+	/**
+	 * @return string
+	 */
 	protected function getLocalizedTemplate($filename)
 	{
 		if(($app=$this->getApplication()->getGlobalization(false))===null)
@@ -8626,12 +9167,20 @@ 
 				$parentControl->addParsedObject($control);
 		}
 	}
+
+	/**
+	 * @param TControl $control
+	 */
 	protected function configureControl($control,$name,$value)
 	{
 		if(strncasecmp($name,'on',2)===0)					$this->configureEvent($control,$name,$value,$control);
 		else if(($pos=strrpos($name,'.'))===false)				$this->configureProperty($control,$name,$value);
 		else				$this->configureSubProperty($control,$name,$value);
 	}
+
+	/**
+	 * @param TComponent $component
+	 */
 	protected function configureComponent($component,$name,$value)
 	{
 		if(strpos($name,'.')===false)				$this->configureProperty($component,$name,$value);
@@ -8941,6 +9490,11 @@ 
 		$tpl=$objects;
 		return $objects;
 	}
+
+	/**
+	 * @param string $str
+	 * @param string $offset
+	 */
 	protected function parseAttributes($str,$offset)
 	{
 		if($str==='')
@@ -8972,11 +9526,19 @@ 
 		}
 		return $attributes;
 	}
+
+	/**
+	 * @param string $content
+	 */
 	protected function parseTemplateProperty($content,$offset)
 	{
 		$line=$this->_startingLine+count(explode("\n",substr($this->_content,0,$offset)))-1;
 		return array(self::CONFIG_TEMPLATE,new TTemplate($content,$this->_contextPath,$this->_tplFile,$line,false));
 	}
+
+	/**
+	 * @param string $value
+	 */
 	protected function parseAttribute($value)
 	{
 		if(($n=preg_match_all('/<%[#=].*?%>/msS',$value,$matches,PREG_OFFSET_CAPTURE))>0)
@@ -9099,6 +9661,11 @@ 
 	{
 		return $this->_includedFiles;
 	}
+
+	/**
+	 * @param Exception $e
+	 * @param integer $line
+	 */
 	protected function handleException($e,$line,$input=null)
 	{
 		$srcFile=$this->_tplFile;
@@ -9155,6 +9722,10 @@ 
 		}
 		return $input;
 	}
+
+	/**
+	 * @param string $method
+	 */
 	protected function isClassBehaviorMethod(ReflectionClass $class,$method)
 	{
 	  $component=new ReflectionClass('TComponent');
@@ -9237,6 +9808,10 @@ 
 				throw new TInvalidDataValueException('thememanager_basepath_invalid',$value);
 		}
 	}
+
+	/**
+	 * @return string
+	 */
 	public function getBaseUrl()
 	{
 		if($this->_baseUrl===null)
@@ -9635,6 +10210,10 @@ 
 	{
 		return $this->_defaultPage;
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setDefaultPage($value)
 	{
 		if($this->_initialized)
@@ -9723,6 +10302,10 @@ 
 			$page->setSubProperty($name,$value);
 		$page->run($this->getResponse()->createHtmlWriter());
 	}
+
+	/**
+	 * @param string $pagePath
+	 */
 	public function constructUrl($pagePath,$getParams=null,$encodeAmpersand=true,$encodeGetItems=true)
 	{
 		return $this->getRequest()->constructUrl($this->getID(),$pagePath,$getParams,$encodeAmpersand,$encodeGetItems);
@@ -9794,11 +10377,20 @@ 
 				throw new TConfigurationException('pageserviceconf_file_invalid',$fname);
 		}
 	}
+
+	/**
+	 * @param string $configPath
+	 */
 	public function loadFromPhp($config,$configPath,$configPagePath)
 	{
 		$this->loadApplicationConfigurationFromPhp($config,$configPath);
 		$this->loadPageConfigurationFromPhp($config,$configPath,$configPagePath);
 	}
+
+	/**
+	 * @param TXmlDocument $dom
+	 * @param string $configPath
+	 */
 	public function loadFromXml($dom,$configPath,$configPagePath)
 	{
 		$this->loadApplicationConfigurationFromXml($dom,$configPath);
@@ -10055,6 +10647,10 @@ 
 		else
 			return $this->_basePath.DIRECTORY_SEPARATOR.$this->hash($path);
 	}
+
+	/**
+	 * @param string $path
+	 */
 	public function getPublishedUrl($path)
 	{
 		$path=realpath($path);
@@ -10063,10 +10659,19 @@ 
 		else
 			return $this->_baseUrl.'/'.$this->hash($path);
 	}
+
+	/**
+	 * @param string $dir
+	 */
 	protected function hash($dir)
 	{
 		return sprintf('%x',crc32($dir.Prado::getVersion()));
 	}
+
+	/**
+	 * @param string $src
+	 * @param string $dst
+	 */
 	protected function copyFile($src,$dst)
 	{
 		if(!is_dir($dst))
@@ -10080,6 +10685,11 @@ 
 			@copy($src,$dstFile);
 		}
 	}
+
+	/**
+	 * @param string $src
+	 * @param string $dst
+	 */
 	public function copyDirectory($src,$dst)
 	{
 		if(!is_dir($dst))
@@ -10109,6 +10719,11 @@ 
 			throw new TInvalidDataValueException('assetmanager_source_directory_invalid', $src);
 		}
 	}
+
+	/**
+	 * @param string $tarfile
+	 * @param string $md5sum
+	 */
 	public function publishTarFile($tarfile, $md5sum, $checkTimestamp=false)
 	{
 		if(isset($this->_published[$md5sum]))
@@ -10131,6 +10746,10 @@ 
 			return $this->_published[$md5sum]=$this->_baseUrl.'/'.$dir;
 		}
 	}
+
+	/**
+	 * @param string $destination
+	 */
 	protected function deployTarFile($path,$destination)
 	{
 		if(($fullpath=realpath($path))===false || !is_file($fullpath))
@@ -10352,6 +10971,10 @@ 
 		$this->_services=array($this->getPageServiceID()=>array('TPageService',array(),null));
 		Prado::setPathOfAlias('Application',$this->_basePath);
 	}
+
+	/**
+	 * @param string $basePath
+	 */
 	protected function resolvePaths($basePath)
 	{
 				if(empty($basePath) || ($basePath=realpath($basePath))===false)
@@ -10417,10 +11040,18 @@ 
 	{
 		return $this->_requestCompleted;
 	}
+
+	/**
+	 * @param integer $defaultValue
+	 */
 	public function getGlobalState($key,$defaultValue=null)
 	{
 		return isset($this->_globals[$key])?$this->_globals[$key]:$defaultValue;
 	}
+
+	/**
+	 * @param string $key
+	 */
 	public function setGlobalState($key,$value,$defaultValue=null,$forceSave=false)
 	{
 		$this->_stateChanged=true;
@@ -10480,6 +11111,10 @@ 
 	{
 		return $this->_basePath;
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setBasePath($value)
 	{
 		$this->_basePath=$value;
@@ -10488,6 +11123,10 @@ 
 	{
 		return $this->_configFile;
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setConfigurationFile($value)
 	{
 		$this->_configFile=$value;
@@ -10496,6 +11135,10 @@ 
 	{
 		return $this->_configType;
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setConfigurationType($value)
 	{
 		$this->_configType = $value;
@@ -10535,6 +11178,10 @@ 
 	{
 		return $this->_runtimePath;
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setRuntimePath($value)
 	{
 		$this->_runtimePath=$value;
@@ -10546,6 +11193,10 @@ 
 	{
 		return $this->_service;
 	}
+
+	/**
+	 * @param IService $value
+	 */
 	public function setService($value)
 	{
 		$this->_service=$value;
@@ -10826,6 +11477,10 @@ 
 		else
 			throw new THttpException(500,'application_service_unknown',$serviceID);
 	}
+
+	/**
+	 * @param Exception $param
+	 */
 	public function onError($param)
 	{
 		Prado::log($param->getMessage(),TLogger::ERROR,'System.TApplication');