< ?php
/**
 * Define accessor and mutator functions for objects using object overloading
 * with magic __get and __set functions as documented at the PHP Documentation page below.
 * 
 * Your objects should derive from this class before using this syntax.
 * Default php convention for accessor and mutator syntax follows the java guidelines 
 * for getPropertyName and setPropertyName, because this matches our naming convention
 * your functions should be formatted like this.
 * 
 * <code>
 * 	< ?php
 * 		class MyFunkyObject extends AccessorMutator
 * 		{
 * 			protected $mMyNonExistentProperty;
 * 			protected $mUseCounter = 0;
 * 
 * 			public function getMyNonExistentProperty() { return $this->mMyNonExistentProperty; }
 * 			public function setMyNonExistentProperty($aValue)
 * 			{
 * 				$this->mMyNonExistentProperty = $aValue;
 * 				$this->mUseCounter++;
 * 			}
 * 		}
 * 
 * 		$myFunkyObject = new MyFunkyObject();
 * 		$myFunkyObject->myNonExistentProperty = "Neu am Kino";
 * 		echo $myFunkyObject->myNonExistentProperty;
 * 	?>
 * 
 * 
 * @author Martijn de Boer / http://cc.sexybiggetje.nl
 * @see http://www.php.net/manual/en/book.overload.php
 * @license http://creativecommons.org/licenses/by-sa/3.0/
 */
 
class AccessorMutator
{
	/**
	 * Make the accessor function available using object overloading in a java style
	 * accessor function following the camelcasing guideline from our styleguide.
	 * 
	 * @param string $aPropertyName
	 * @return object
	 */
	public function __get($aPropertyName)
	{
		$theFunctionName = "get" . ucFirst($aPropertyName);
		if (method_exists($this, $theFunctionName))
			return $this->{$theFunctionName}();
 
		throw(new Exception("No accessor method defined for '" . $aPropertyName . "', did you forget to define " . $theFunctionName . "?"));
	}
 
	/**
	 * Make the mutator function available using object overloading in a java style
	 * mutator function following the camelcasing guideline from our styleguide.
	 * 
	 * @param string $aPropertyName
	 * @param string $aPropertyValue
	 * @return null
	 */
	public function __set($aPropertyName, $aPropertyValue)
	{
		$theFunctionName = "set" . ucfirst($aPropertyName);
		if (method_exists($this, $theFunctionName))
			return $this->{$theFunctionName}($aPropertyValue);
 
		throw(new Exception("No mutator method defined for '" . $aPropertyName . "', did you forget to define " . $theFunctionName . "(\$aValue)?"));
	}
 
}
?>