Subversion-Projekte lars-tiefland.php_share

<?php

/**

 * Base class that represents a row from the 'movie_i18n' table.

 *

 *

 *

 * This class was autogenerated by Propel 1.4.2 on:

 *

 * Fri Aug  5 09:39:38 2011

 *

 * @package    lib.model.om

 */

abstract class BaseMovieI18n extends BaseObject  implements Persistent {

	/**

	 * The Peer class.

	 * Instance provides a convenient way of calling static methods on a class

	 * that calling code may not be able to identify.

	 * @var        MovieI18nPeer

	 */

	protected static $peer;

	/**

	 * The value for the id field.

	 * @var        int

	 */

	protected $id;

	/**

	 * The value for the culture field.

	 * @var        string

	 */

	protected $culture;

	/**

	 * The value for the title field.

	 * @var        string

	 */

	protected $title;

	/**

	 * @var        Movie

	 */

	protected $aMovie;

	/**

	 * Flag to prevent endless save loop, if this object is referenced

	 * by another object which falls in this transaction.

	 * @var        boolean

	 */

	protected $alreadyInSave = false;

	/**

	 * Flag to prevent endless validation loop, if this object is referenced

	 * by another object which falls in this transaction.

	 * @var        boolean

	 */

	protected $alreadyInValidation = false;

	// symfony behavior

	const PEER = 'MovieI18nPeer';

	/**

	 * Get the [id] column value.

	 *

	 * @return     int

	 */

	public function getId()

	{

		return $this->id;

	}

	/**

	 * Get the [culture] column value.

	 *

	 * @return     string

	 */

	public function getCulture()

	{

		return $this->culture;

	}

	/**

	 * Get the [title] column value.

	 *

	 * @return     string

	 */

	public function getTitle()

	{

		return $this->title;

	}

	/**

	 * Set the value of [id] column.

	 *

	 * @param      int $v new value

	 * @return     MovieI18n The current object (for fluent API support)

	 */

	public function setId($v)

	{

		if ($v !== null) {

			$v = (int) $v;

		}

		if ($this->id !== $v) {

			$this->id = $v;

			$this->modifiedColumns[] = MovieI18nPeer::ID;

		}

		if ($this->aMovie !== null && $this->aMovie->getId() !== $v) {

			$this->aMovie = null;

		}

		return $this;

	} // setId()

	/**

	 * Set the value of [culture] column.

	 *

	 * @param      string $v new value

	 * @return     MovieI18n The current object (for fluent API support)

	 */

	public function setCulture($v)

	{

		if ($v !== null) {

			$v = (string) $v;

		}

		if ($this->culture !== $v) {

			$this->culture = $v;

			$this->modifiedColumns[] = MovieI18nPeer::CULTURE;

		}

		return $this;

	} // setCulture()

	/**

	 * Set the value of [title] column.

	 *

	 * @param      string $v new value

	 * @return     MovieI18n The current object (for fluent API support)

	 */

	public function setTitle($v)

	{

		if ($v !== null) {

			$v = (string) $v;

		}

		if ($this->title !== $v) {

			$this->title = $v;

			$this->modifiedColumns[] = MovieI18nPeer::TITLE;

		}

		return $this;

	} // setTitle()

	/**

	 * Indicates whether the columns in this object are only set to default values.

	 *

	 * This method can be used in conjunction with isModified() to indicate whether an object is both

	 * modified _and_ has some values set which are non-default.

	 *

	 * @return     boolean Whether the columns in this object are only been set with default values.

	 */

	public function hasOnlyDefaultValues()

	{

		// otherwise, everything was equal, so return TRUE

		return true;

	} // hasOnlyDefaultValues()

	/**

	 * Hydrates (populates) the object variables with values from the database resultset.

	 *

	 * An offset (0-based "start column") is specified so that objects can be hydrated

	 * with a subset of the columns in the resultset rows.  This is needed, for example,

	 * for results of JOIN queries where the resultset row includes columns from two or

	 * more tables.

	 *

	 * @param      array $row The row returned by PDOStatement->fetch(PDO::FETCH_NUM)

	 * @param      int $startcol 0-based offset column which indicates which restultset column to start with.

	 * @param      boolean $rehydrate Whether this object is being re-hydrated from the database.

	 * @return     int next starting column

	 * @throws     PropelException  - Any caught Exception will be rewrapped as a PropelException.

	 */

	public function hydrate($row, $startcol = 0, $rehydrate = false)

	{

		try {

			$this->id = ($row[$startcol + 0] !== null) ? (int) $row[$startcol + 0] : null;

			$this->culture = ($row[$startcol + 1] !== null) ? (string) $row[$startcol + 1] : null;

			$this->title = ($row[$startcol + 2] !== null) ? (string) $row[$startcol + 2] : null;

			$this->resetModified();

			$this->setNew(false);

			if ($rehydrate) {

				$this->ensureConsistency();

			}

			// FIXME - using NUM_COLUMNS may be clearer.

			return $startcol + 3; // 3 = MovieI18nPeer::NUM_COLUMNS - MovieI18nPeer::NUM_LAZY_LOAD_COLUMNS).

		} catch (Exception $e) {

			throw new PropelException("Error populating MovieI18n object", $e);

		}

	}

	/**

	 * Checks and repairs the internal consistency of the object.

	 *

	 * This method is executed after an already-instantiated object is re-hydrated

	 * from the database.  It exists to check any foreign keys to make sure that

	 * the objects related to the current object are correct based on foreign key.

	 *

	 * You can override this method in the stub class, but you should always invoke

	 * the base method from the overridden method (i.e. parent::ensureConsistency()),

	 * in case your model changes.

	 *

	 * @throws     PropelException

	 */

	public function ensureConsistency()

	{

		if ($this->aMovie !== null && $this->id !== $this->aMovie->getId()) {

			$this->aMovie = null;

		}

	} // ensureConsistency

	/**

	 * Reloads this object from datastore based on primary key and (optionally) resets all associated objects.

	 *

	 * This will only work if the object has been saved and has a valid primary key set.

	 *

	 * @param      boolean $deep (optional) Whether to also de-associated any related objects.

	 * @param      PropelPDO $con (optional) The PropelPDO connection to use.

	 * @return     void

	 * @throws     PropelException - if this object is deleted, unsaved or doesn't have pk match in db

	 */

	public function reload($deep = false, PropelPDO $con = null)

	{

		if ($this->isDeleted()) {

			throw new PropelException("Cannot reload a deleted object.");

		}

		if ($this->isNew()) {

			throw new PropelException("Cannot reload an unsaved object.");

		}

		if ($con === null) {

			$con = Propel::getConnection(MovieI18nPeer::DATABASE_NAME, Propel::CONNECTION_READ);

		}

		// We don't need to alter the object instance pool; we're just modifying this instance

		// already in the pool.

		$stmt = MovieI18nPeer::doSelectStmt($this->buildPkeyCriteria(), $con);

		$row = $stmt->fetch(PDO::FETCH_NUM);

		$stmt->closeCursor();

		if (!$row) {

			throw new PropelException('Cannot find matching row in the database to reload object values.');

		}

		$this->hydrate($row, 0, true); // rehydrate

		if ($deep) {  // also de-associate any related objects?

			$this->aMovie = null;

		} // if (deep)

	}

	/**

	 * Removes this object from datastore and sets delete attribute.

	 *

	 * @param      PropelPDO $con

	 * @return     void

	 * @throws     PropelException

	 * @see        BaseObject::setDeleted()

	 * @see        BaseObject::isDeleted()

	 */

	public function delete(PropelPDO $con = null)

	{

		if ($this->isDeleted()) {

			throw new PropelException("This object has already been deleted.");

		}

		if ($con === null) {

			$con = Propel::getConnection(MovieI18nPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);

		}

		$con->beginTransaction();

		try {

			$ret = $this->preDelete($con);

			// symfony_behaviors behavior

			foreach (sfMixer::getCallables('BaseMovieI18n:delete:pre') as $callable)

			{

			  if (call_user_func($callable, $this, $con))

			  {

			    $con->commit();

			    return;

			  }

			}

			if ($ret) {

				MovieI18nPeer::doDelete($this, $con);

				$this->postDelete($con);

				// symfony_behaviors behavior

				foreach (sfMixer::getCallables('BaseMovieI18n:delete:post') as $callable)

				{

				  call_user_func($callable, $this, $con);

				}

				$this->setDeleted(true);

				$con->commit();

			} else {

				$con->commit();

			}

		} catch (PropelException $e) {

			$con->rollBack();

			throw $e;

		}

	}

	/**

	 * Persists this object to the database.

	 *

	 * If the object is new, it inserts it; otherwise an update is performed.

	 * All modified related objects will also be persisted in the doSave()

	 * method.  This method wraps all precipitate database operations in a

	 * single transaction.

	 *

	 * @param      PropelPDO $con

	 * @return     int The number of rows affected by this insert/update and any referring fk objects' save() operations.

	 * @throws     PropelException

	 * @see        doSave()

	 */

	public function save(PropelPDO $con = null)

	{

		if ($this->isDeleted()) {

			throw new PropelException("You cannot save an object that has been deleted.");

		}

		if ($con === null) {

			$con = Propel::getConnection(MovieI18nPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);

		}

		$con->beginTransaction();

		$isInsert = $this->isNew();

		try {

			$ret = $this->preSave($con);

			// symfony_behaviors behavior

			foreach (sfMixer::getCallables('BaseMovieI18n:save:pre') as $callable)

			{

			  if (is_integer($affectedRows = call_user_func($callable, $this, $con)))

			  {

			    $con->commit();

			    return $affectedRows;

			  }

			}

			if ($isInsert) {

				$ret = $ret && $this->preInsert($con);

			} else {

				$ret = $ret && $this->preUpdate($con);

			}

			if ($ret) {

				$affectedRows = $this->doSave($con);

				if ($isInsert) {

					$this->postInsert($con);

				} else {

					$this->postUpdate($con);

				}

				$this->postSave($con);

				// symfony_behaviors behavior

				foreach (sfMixer::getCallables('BaseMovieI18n:save:post') as $callable)

				{

				  call_user_func($callable, $this, $con, $affectedRows);

				}

				MovieI18nPeer::addInstanceToPool($this);

			} else {

				$affectedRows = 0;

			}

			$con->commit();

			return $affectedRows;

		} catch (PropelException $e) {

			$con->rollBack();

			throw $e;

		}

	}

	/**

	 * Performs the work of inserting or updating the row in the database.

	 *

	 * If the object is new, it inserts it; otherwise an update is performed.

	 * All related objects are also updated in this method.

	 *

	 * @param      PropelPDO $con

	 * @return     int The number of rows affected by this insert/update and any referring fk objects' save() operations.

	 * @throws     PropelException

	 * @see        save()

	 */

	protected function doSave(PropelPDO $con)

	{

		$affectedRows = 0; // initialize var to track total num of affected rows

		if (!$this->alreadyInSave) {

			$this->alreadyInSave = true;

			// We call the save method on the following object(s) if they

			// were passed to this object by their coresponding set

			// method.  This object relates to these object(s) by a

			// foreign key reference.

			if ($this->aMovie !== null) {

				if ($this->aMovie->isModified() || ($this->aMovie->getCulture() && $this->aMovie->getCurrentMovieI18n()->isModified()) || $this->aMovie->isNew()) {

					$affectedRows += $this->aMovie->save($con);

				}

				$this->setMovie($this->aMovie);

			}

			// If this object has been modified, then save it to the database.

			if ($this->isModified()) {

				if ($this->isNew()) {

					$pk = MovieI18nPeer::doInsert($this, $con);

					$affectedRows += 1; // we are assuming that there is only 1 row per doInsert() which

										 // should always be true here (even though technically

										 // BasePeer::doInsert() can insert multiple rows).

					$this->setNew(false);

				} else {

					$affectedRows += MovieI18nPeer::doUpdate($this, $con);

				}

				$this->resetModified(); // [HL] After being saved an object is no longer 'modified'

			}

			$this->alreadyInSave = false;

		}

		return $affectedRows;

	} // doSave()

	/**

	 * Array of ValidationFailed objects.

	 * @var        array ValidationFailed[]

	 */

	protected $validationFailures = array();

	/**

	 * Gets any ValidationFailed objects that resulted from last call to validate().

	 *

	 *

	 * @return     array ValidationFailed[]

	 * @see        validate()

	 */

	public function getValidationFailures()

	{

		return $this->validationFailures;

	}

	/**

	 * Validates the objects modified field values and all objects related to this table.

	 *

	 * If $columns is either a column name or an array of column names

	 * only those columns are validated.

	 *

	 * @param      mixed $columns Column name or an array of column names.

	 * @return     boolean Whether all columns pass validation.

	 * @see        doValidate()

	 * @see        getValidationFailures()

	 */

	public function validate($columns = null)

	{

		$res = $this->doValidate($columns);

		if ($res === true) {

			$this->validationFailures = array();

			return true;

		} else {

			$this->validationFailures = $res;

			return false;

		}

	}

	/**

	 * This function performs the validation work for complex object models.

	 *

	 * In addition to checking the current object, all related objects will

	 * also be validated.  If all pass then <code>true</code> is returned; otherwise

	 * an aggreagated array of ValidationFailed objects will be returned.

	 *

	 * @param      array $columns Array of column names to validate.

	 * @return     mixed <code>true</code> if all validations pass; array of <code>ValidationFailed</code> objets otherwise.

	 */

	protected function doValidate($columns = null)

	{

		if (!$this->alreadyInValidation) {

			$this->alreadyInValidation = true;

			$retval = null;

			$failureMap = array();

			// We call the validate method on the following object(s) if they

			// were passed to this object by their coresponding set

			// method.  This object relates to these object(s) by a

			// foreign key reference.

			if ($this->aMovie !== null) {

				if (!$this->aMovie->validate($columns)) {

					$failureMap = array_merge($failureMap, $this->aMovie->getValidationFailures());

				}

			}

			if (($retval = MovieI18nPeer::doValidate($this, $columns)) !== true) {

				$failureMap = array_merge($failureMap, $retval);

			}

			$this->alreadyInValidation = false;

		}

		return (!empty($failureMap) ? $failureMap : true);

	}

	/**

	 * Retrieves a field from the object by name passed in as a string.

	 *

	 * @param      string $name name

	 * @param      string $type The type of fieldname the $name is of:

	 *                     one of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME

	 *                     BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM

	 * @return     mixed Value of field.

	 */

	public function getByName($name, $type = BasePeer::TYPE_PHPNAME)

	{

		$pos = MovieI18nPeer::translateFieldName($name, $type, BasePeer::TYPE_NUM);

		$field = $this->getByPosition($pos);

		return $field;

	}

	/**

	 * Retrieves a field from the object by Position as specified in the xml schema.

	 * Zero-based.

	 *

	 * @param      int $pos position in xml schema

	 * @return     mixed Value of field at $pos

	 */

	public function getByPosition($pos)

	{

		switch($pos) {

			case 0:

				return $this->getId();

				break;

			case 1:

				return $this->getCulture();

				break;

			case 2:

				return $this->getTitle();

				break;

			default:

				return null;

				break;

		} // switch()

	}

	/**

	 * Exports the object as an array.

	 *

	 * You can specify the key type of the array by passing one of the class

	 * type constants.

	 *

	 * @param      string $keyType (optional) One of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME

	 *                        BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM. Defaults to BasePeer::TYPE_PHPNAME.

	 * @param      boolean $includeLazyLoadColumns (optional) Whether to include lazy loaded columns.  Defaults to TRUE.

	 * @return     an associative array containing the field names (as keys) and field values

	 */

	public function toArray($keyType = BasePeer::TYPE_PHPNAME, $includeLazyLoadColumns = true)

	{

		$keys = MovieI18nPeer::getFieldNames($keyType);

		$result = array(

			$keys[0] => $this->getId(),

			$keys[1] => $this->getCulture(),

			$keys[2] => $this->getTitle(),

		);

		return $result;

	}

	/**

	 * Sets a field from the object by name passed in as a string.

	 *

	 * @param      string $name peer name

	 * @param      mixed $value field value

	 * @param      string $type The type of fieldname the $name is of:

	 *                     one of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME

	 *                     BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM

	 * @return     void

	 */

	public function setByName($name, $value, $type = BasePeer::TYPE_PHPNAME)

	{

		$pos = MovieI18nPeer::translateFieldName($name, $type, BasePeer::TYPE_NUM);

		return $this->setByPosition($pos, $value);

	}

	/**

	 * Sets a field from the object by Position as specified in the xml schema.

	 * Zero-based.

	 *

	 * @param      int $pos position in xml schema

	 * @param      mixed $value field value

	 * @return     void

	 */

	public function setByPosition($pos, $value)

	{

		switch($pos) {

			case 0:

				$this->setId($value);

				break;

			case 1:

				$this->setCulture($value);

				break;

			case 2:

				$this->setTitle($value);

				break;

		} // switch()

	}

	/**

	 * Populates the object using an array.

	 *

	 * This is particularly useful when populating an object from one of the

	 * request arrays (e.g. $_POST).  This method goes through the column

	 * names, checking to see whether a matching key exists in populated

	 * array. If so the setByName() method is called for that column.

	 *

	 * You can specify the key type of the array by additionally passing one

	 * of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME,

	 * BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM.

	 * The default key type is the column's phpname (e.g. 'AuthorId')

	 *

	 * @param      array  $arr     An array to populate the object from.

	 * @param      string $keyType The type of keys the array uses.

	 * @return     void

	 */

	public function fromArray($arr, $keyType = BasePeer::TYPE_PHPNAME)

	{

		$keys = MovieI18nPeer::getFieldNames($keyType);

		if (array_key_exists($keys[0], $arr)) $this->setId($arr[$keys[0]]);

		if (array_key_exists($keys[1], $arr)) $this->setCulture($arr[$keys[1]]);

		if (array_key_exists($keys[2], $arr)) $this->setTitle($arr[$keys[2]]);

	}

	/**

	 * Build a Criteria object containing the values of all modified columns in this object.

	 *

	 * @return     Criteria The Criteria object containing all modified values.

	 */

	public function buildCriteria()

	{

		$criteria = new Criteria(MovieI18nPeer::DATABASE_NAME);

		if ($this->isColumnModified(MovieI18nPeer::ID)) $criteria->add(MovieI18nPeer::ID, $this->id);

		if ($this->isColumnModified(MovieI18nPeer::CULTURE)) $criteria->add(MovieI18nPeer::CULTURE, $this->culture);

		if ($this->isColumnModified(MovieI18nPeer::TITLE)) $criteria->add(MovieI18nPeer::TITLE, $this->title);

		return $criteria;

	}

	/**

	 * Builds a Criteria object containing the primary key for this object.

	 *

	 * Unlike buildCriteria() this method includes the primary key values regardless

	 * of whether or not they have been modified.

	 *

	 * @return     Criteria The Criteria object containing value(s) for primary key(s).

	 */

	public function buildPkeyCriteria()

	{

		$criteria = new Criteria(MovieI18nPeer::DATABASE_NAME);

		$criteria->add(MovieI18nPeer::ID, $this->id);

		$criteria->add(MovieI18nPeer::CULTURE, $this->culture);

		return $criteria;

	}

	/**

	 * Returns the composite primary key for this object.

	 * The array elements will be in same order as specified in XML.

	 * @return     array

	 */

	public function getPrimaryKey()

	{

		$pks = array();

		$pks[0] = $this->getId();

		$pks[1] = $this->getCulture();

		return $pks;

	}

	/**

	 * Set the [composite] primary key.

	 *

	 * @param      array $keys The elements of the composite key (order must match the order in XML file).

	 * @return     void

	 */

	public function setPrimaryKey($keys)

	{

		$this->setId($keys[0]);

		$this->setCulture($keys[1]);

	}

	/**

	 * Sets contents of passed object to values from current object.

	 *

	 * If desired, this method can also make copies of all associated (fkey referrers)

	 * objects.

	 *

	 * @param      object $copyObj An object of MovieI18n (or compatible) type.

	 * @param      boolean $deepCopy Whether to also copy all rows that refer (by fkey) to the current row.

	 * @throws     PropelException

	 */

	public function copyInto($copyObj, $deepCopy = false)

	{

		$copyObj->setId($this->id);

		$copyObj->setCulture($this->culture);

		$copyObj->setTitle($this->title);

		$copyObj->setNew(true);

	}

	/**

	 * Makes a copy of this object that will be inserted as a new row in table when saved.

	 * It creates a new object filling in the simple attributes, but skipping any primary

	 * keys that are defined for the table.

	 *

	 * If desired, this method can also make copies of all associated (fkey referrers)

	 * objects.

	 *

	 * @param      boolean $deepCopy Whether to also copy all rows that refer (by fkey) to the current row.

	 * @return     MovieI18n Clone of current object.

	 * @throws     PropelException

	 */

	public function copy($deepCopy = false)

	{

		// we use get_class(), because this might be a subclass

		$clazz = get_class($this);

		$copyObj = new $clazz();

		$this->copyInto($copyObj, $deepCopy);

		return $copyObj;

	}

	/**

	 * Returns a peer instance associated with this om.

	 *

	 * Since Peer classes are not to have any instance attributes, this method returns the

	 * same instance for all member of this class. The method could therefore

	 * be static, but this would prevent one from overriding the behavior.

	 *

	 * @return     MovieI18nPeer

	 */

	public function getPeer()

	{

		if (self::$peer === null) {

			self::$peer = new MovieI18nPeer();

		}

		return self::$peer;

	}

	/**

	 * Declares an association between this object and a Movie object.

	 *

	 * @param      Movie $v

	 * @return     MovieI18n The current object (for fluent API support)

	 * @throws     PropelException

	 */

	public function setMovie(Movie $v = null)

	{

		if ($v === null) {

			$this->setId(NULL);

		} else {

			$this->setId($v->getId());

		}

		$this->aMovie = $v;

		// Add binding for other direction of this n:n relationship.

		// If this object has already been added to the Movie object, it will not be re-added.

		if ($v !== null) {

			$v->addMovieI18n($this);

		}

		return $this;

	}

	/**

	 * Get the associated Movie object

	 *

	 * @param      PropelPDO Optional Connection object.

	 * @return     Movie The associated Movie object.

	 * @throws     PropelException

	 */

	public function getMovie(PropelPDO $con = null)

	{

		if ($this->aMovie === null && ($this->id !== null)) {

			$this->aMovie = MoviePeer::retrieveByPk($this->id);

			/* The following can be used additionally to

			   guarantee the related object contains a reference

			   to this object.  This level of coupling may, however, be

			   undesirable since it could result in an only partially populated collection

			   in the referenced object.

			   $this->aMovie->addMovieI18ns($this);

			 */

		}

		return $this->aMovie;

	}

	/**

	 * Resets all collections of referencing foreign keys.

	 *

	 * This method is a user-space workaround for PHP's inability to garbage collect objects

	 * with circular references.  This is currently necessary when using Propel in certain

	 * daemon or large-volumne/high-memory operations.

	 *

	 * @param      boolean $deep Whether to also clear the references on all associated objects.

	 */

	public function clearAllReferences($deep = false)

	{

		if ($deep) {

		} // if ($deep)

			$this->aMovie = null;

	}

	// symfony_behaviors behavior

	/**

	 * Calls methods defined via {@link sfMixer}.

	 */

	public function __call($method, $arguments)

	{

	  if (!$callable = sfMixer::getCallable('BaseMovieI18n:'.$method))

	  {

	    throw new sfException(sprintf('Call to undefined method BaseMovieI18n::%s', $method));

	  }

	  array_unshift($arguments, $this);

	  return call_user_func_array($callable, $arguments);

	}

	/**

	 * Return the string representation of this object

	 *

	 * @return string The value of the 'title' column

	 */

  public function __toString()

  {

    return (string) $this->getTitle();

  }

} // BaseMovieI18n