sintonia/library/propel/generator/lib/builder/om/ObjectBuilder.php

<?php

/**
 * This file is part of the Propel package.
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 *
 * @license    MIT License
 */

require_once 'builder/om/OMBuilder.php';

/**
 * Base class for Peer-building classes.
 *
 * This class is designed so that it can be extended by a PHP4PeerBuilder in addition
 * to the "standard" PHP5PeerBuilder and PHP5ComplexOMPeerBuilder.  Hence, this class
 * should not have any actual template code in it -- simply basic logic & utility
 * methods.
 *
 * @author     Hans Lellelid <hans@xmpl.org>
 * @package    propel.generator.builder.om
 */
abstract class ObjectBuilder extends OMBuilder
{

	/**
	 * Constructs a new PeerBuilder subclass.
	 */
	public function __construct(Table $table) {
		parent::__construct($table);
	}

	/**
	 * This method adds the contents of the generated class to the script.
	 *
	 * This method is abstract and should be overridden by the subclasses.
	 *
	 * Hint: Override this method in your subclass if you want to reorganize or
	 * drastically change the contents of the generated peer class.
	 *
	 * @param      string &$script The script will be modified in this method.
	 */
	abstract protected function addClassBody(&$script);

	/**
	 * Adds the getter methods for the column values.
	 * This is here because it is probably generic enough to apply to templates being generated
	 * in different langauges (e.g. PHP4 and PHP5).
	 * @param      string &$script The script will be modified in this method.
	 */
	protected function addColumnAccessorMethods(&$script)
	{
		$table = $this->getTable();

		foreach ($table->getColumns() as $col) {

			// if they're not using the DateTime class than we will generate "compatibility" accessor method
			if ($col->getType() === PropelTypes::DATE || $col->getType() === PropelTypes::TIME || $col->getType() === PropelTypes::TIMESTAMP) {
				$this->addTemporalAccessor($script, $col);
			} else {
				$this->addDefaultAccessor($script, $col);
			}

			if ($col->isLazyLoad()) {
				$this->addLazyLoader($script, $col);
			}
		}
	}

	/**
	 * Adds the mutator (setter) methods for setting column values.
	 * This is here because it is probably generic enough to apply to templates being generated
	 * in different langauges (e.g. PHP4 and PHP5).
	 * @param      string &$script The script will be modified in this method.
	 */
	protected function addColumnMutatorMethods(&$script)
	{
		foreach ($this->getTable()->getColumns() as $col) {

			if ($col->isLobType()) {
				$this->addLobMutator($script, $col);
			} elseif ($col->getType() === PropelTypes::DATE || $col->getType() === PropelTypes::TIME || $col->getType() === PropelTypes::TIMESTAMP) {
				$this->addTemporalMutator($script, $col);
			} else {
				$this->addDefaultMutator($script, $col);
			}
		}
	}


	/**
	 * Gets the baseClass path if specified for table/db.
	 * If not, will return 'propel.om.BaseObject'
	 * @return     string
	 */
	protected function getBaseClass() {
		$class = $this->getTable()->getBaseClass();
		if ($class === null) {
			$class = "propel.om.BaseObject";
		}
		return $class;
	}

	/**
	 * Gets the interface path if specified for current table.
	 * If not, will return 'propel.om.Persistent'.
	 * @return     string
	 */
	protected function getInterface() {
		$interface = $this->getTable()->getInterface();
		if ($interface === null && !$this->getTable()->isReadOnly()) {
			$interface = "propel.om.Persistent";
		}
		return $interface;
	}

	/**
	 * Whether to add the generic mutator methods (setByName(), setByPosition(), fromArray()).
	 * This is based on the build property propel.addGenericMutators, and also whether the
	 * table is read-only or an alias.
	 */
	protected function isAddGenericMutators()
	{
		$table = $this->getTable();
		return (!$table->isAlias() && $this->getBuildProperty('addGenericMutators') && !$table->isReadOnly());
	}

	/**
	 * Whether to add the generic accessor methods (getByName(), getByPosition(), toArray()).
	 * This is based on the build property propel.addGenericAccessors, and also whether the
	 * table is an alias.
	 */
	protected function isAddGenericAccessors()
	{
		$table = $this->getTable();
		return (!$table->isAlias() && $this->getBuildProperty('addGenericAccessors'));
	}

	/**
	 * Whether to add the validate() method.
	 * This is based on the build property propel.addValidateMethod
	 */
	protected function isAddValidateMethod()
	{
		return $this->getBuildProperty('addValidateMethod');
	}
	
	protected function hasDefaultValues()
	{
		foreach ($this->getTable()->getColumns() as $col) {
			if($col->getDefaultValue() !== null) return true;
		}
		return false;
	}

	/**
	 * Checks whether any registered behavior on that table has a modifier for a hook
	 * @param string $hookName The name of the hook as called from one of this class methods, e.g. "preSave"
	 * @return boolean
	 */
	public function hasBehaviorModifier($hookName, $modifier = null)
	{
	 	return parent::hasBehaviorModifier($hookName, 'ObjectBuilderModifier');
	}

	/**
	 * Checks whether any registered behavior on that table has a modifier for a hook
	 * @param string $hookName The name of the hook as called from one of this class methods, e.g. "preSave"
	 * @param string &$script The script will be modified in this method.
	 */
	public function applyBehaviorModifier($hookName, &$script, $tab = "		")
	{
		return $this->applyBehaviorModifierBase($hookName, 'ObjectBuilderModifier', $script, $tab);
	}

	/**
	 * Checks whether any registered behavior content creator on that table exists a contentName
	 * @param string $contentName The name of the content as called from one of this class methods, e.g. "parentClassname"
	 */
	public function getBehaviorContent($contentName)
	{
		return $this->getBehaviorContentBase($contentName, 'ObjectBuilderModifier');
	}

}