Subversion-Projekte lars-tiefland.php_share

<?php

/**

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

 *

 *

 *

 * This class was autogenerated by Propel 1.4.2 on:

 *

 * Fri Aug  5 09:39:37 2011

 *

 * @package    lib.model.om

 */

abstract class BaseBook 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        BookPeer

	 */

	protected static $peer;

	/**

	 * The value for the id field.

	 * @var        int

	 */

	protected $id;

	/**

	 * The value for the name field.

	 * @var        string

	 */

	protected $name;

	/**

	 * @var        array Article[] Collection to store aggregation of Article objects.

	 */

	protected $collArticles;

	/**

	 * @var        Criteria The criteria used to select the current contents of collArticles.

	 */

	private $lastArticleCriteria = null;

	/**

	 * 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 = 'BookPeer';

	/**

	 * Get the [id] column value.

	 *

	 * @return     int

	 */

	public function getId()

	{

		return $this->id;

	}

	/**

	 * Get the [name] column value.

	 *

	 * @return     string

	 */

	public function getName()

	{

		return $this->name;

	}

	/**

	 * Set the value of [id] column.

	 *

	 * @param      int $v new value

	 * @return     Book 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[] = BookPeer::ID;

		}

		return $this;

	} // setId()

	/**

	 * Set the value of [name] column.

	 *

	 * @param      string $v new value

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

	 */

	public function setName($v)

	{

		if ($v !== null) {

			$v = (string) $v;

		}

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

			$this->name = $v;

			$this->modifiedColumns[] = BookPeer::NAME;

		}

		return $this;

	} // setName()

	/**

	 * 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->name = ($row[$startcol + 1] !== null) ? (string) $row[$startcol + 1] : null;

			$this->resetModified();

			$this->setNew(false);

			if ($rehydrate) {

				$this->ensureConsistency();

			}

			// FIXME - using NUM_COLUMNS may be clearer.

			return $startcol + 2; // 2 = BookPeer::NUM_COLUMNS - BookPeer::NUM_LAZY_LOAD_COLUMNS).

		} catch (Exception $e) {

			throw new PropelException("Error populating Book 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()

	{

	} // 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(BookPeer::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 = BookPeer::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->collArticles = null;

			$this->lastArticleCriteria = 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(BookPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);

		}

		$con->beginTransaction();

		try {

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

			// symfony_behaviors behavior

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

			{

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

			  {

			    $con->commit();

			    return;

			  }

			}

			if ($ret) {

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

				$this->postDelete($con);

				// symfony_behaviors behavior

				foreach (sfMixer::getCallables('BaseBook: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(BookPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);

		}

		$con->beginTransaction();

		$isInsert = $this->isNew();

		try {

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

			// symfony_behaviors behavior

			foreach (sfMixer::getCallables('BaseBook: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('BaseBook:save:post') as $callable)

				{

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

				}

				BookPeer::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;

			if ($this->isNew() ) {

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

			}

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

			if ($this->isModified()) {

				if ($this->isNew()) {

					$pk = BookPeer::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->setId($pk);  //[IMV] update autoincrement primary key

					$this->setNew(false);

				} else {

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

				}

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

			}

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

				foreach ($this->collArticles as $referrerFK) {

					if (!$referrerFK->isDeleted()) {

						$affectedRows += $referrerFK->save($con);

					}

				}

			}

			$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();

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

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

			}

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

					foreach ($this->collArticles as $referrerFK) {

						if (!$referrerFK->validate($columns)) {

							$failureMap = array_merge($failureMap, $referrerFK->getValidationFailures());

						}

					}

				}

			$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 = BookPeer::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->getName();

				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 = BookPeer::getFieldNames($keyType);

		$result = array(

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

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

		);

		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 = BookPeer::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->setName($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 = BookPeer::getFieldNames($keyType);

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

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

	}

	/**

	 * 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(BookPeer::DATABASE_NAME);

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

		if ($this->isColumnModified(BookPeer::NAME)) $criteria->add(BookPeer::NAME, $this->name);

		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(BookPeer::DATABASE_NAME);

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

		return $criteria;

	}

	/**

	 * Returns the primary key for this object (row).

	 * @return     int

	 */

	public function getPrimaryKey()

	{

		return $this->getId();

	}

	/**

	 * Generic method to set the primary key (id column).

	 *

	 * @param      int $key Primary key.

	 * @return     void

	 */

	public function setPrimaryKey($key)

	{

		$this->setId($key);

	}

	/**

	 * 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 Book (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->setName($this->name);

		if ($deepCopy) {

			// important: temporarily setNew(false) because this affects the behavior of

			// the getter/setter methods for fkey referrer objects.

			$copyObj->setNew(false);

			foreach ($this->getArticles() as $relObj) {

				if ($relObj !== $this) {  // ensure that we don't try to copy a reference to ourselves

					$copyObj->addArticle($relObj->copy($deepCopy));

				}

			}

		} // if ($deepCopy)

		$copyObj->setNew(true);

		$copyObj->setId(NULL); // this is a auto-increment column, so set to default value

	}

	/**

	 * 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     Book 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     BookPeer

	 */

	public function getPeer()

	{

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

			self::$peer = new BookPeer();

		}

		return self::$peer;

	}

	/**

	 * Clears out the collArticles collection (array).

	 *

	 * This does not modify the database; however, it will remove any associated objects, causing

	 * them to be refetched by subsequent calls to accessor method.

	 *

	 * @return     void

	 * @see        addArticles()

	 */

	public function clearArticles()

	{

		$this->collArticles = null; // important to set this to NULL since that means it is uninitialized

	}

	/**

	 * Initializes the collArticles collection (array).

	 *

	 * By default this just sets the collArticles collection to an empty array (like clearcollArticles());

	 * however, you may wish to override this method in your stub class to provide setting appropriate

	 * to your application -- for example, setting the initial array to the values stored in database.

	 *

	 * @return     void

	 */

	public function initArticles()

	{

		$this->collArticles = array();

	}

	/**

	 * Gets an array of Article objects which contain a foreign key that references this object.

	 *

	 * If this collection has already been initialized with an identical Criteria, it returns the collection.

	 * Otherwise if this Book has previously been saved, it will retrieve

	 * related Articles from storage. If this Book is new, it will return

	 * an empty collection or the current collection, the criteria is ignored on a new object.

	 *

	 * @param      PropelPDO $con

	 * @param      Criteria $criteria

	 * @return     array Article[]

	 * @throws     PropelException

	 */

	public function getArticles($criteria = null, PropelPDO $con = null)

	{

		if ($criteria === null) {

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

		}

		elseif ($criteria instanceof Criteria)

		{

			$criteria = clone $criteria;

		}

		if ($this->collArticles === null) {

			if ($this->isNew()) {

			   $this->collArticles = array();

			} else {

				$criteria->add(ArticlePeer::BOOK_ID, $this->id);

				ArticlePeer::addSelectColumns($criteria);

				$this->collArticles = ArticlePeer::doSelect($criteria, $con);

			}

		} else {

			// criteria has no effect for a new object

			if (!$this->isNew()) {

				// the following code is to determine if a new query is

				// called for.  If the criteria is the same as the last

				// one, just return the collection.

				$criteria->add(ArticlePeer::BOOK_ID, $this->id);

				ArticlePeer::addSelectColumns($criteria);

				if (!isset($this->lastArticleCriteria) || !$this->lastArticleCriteria->equals($criteria)) {

					$this->collArticles = ArticlePeer::doSelect($criteria, $con);

				}

			}

		}

		$this->lastArticleCriteria = $criteria;

		return $this->collArticles;

	}

	/**

	 * Returns the number of related Article objects.

	 *

	 * @param      Criteria $criteria

	 * @param      boolean $distinct

	 * @param      PropelPDO $con

	 * @return     int Count of related Article objects.

	 * @throws     PropelException

	 */

	public function countArticles(Criteria $criteria = null, $distinct = false, PropelPDO $con = null)

	{

		if ($criteria === null) {

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

		} else {

			$criteria = clone $criteria;

		}

		if ($distinct) {

			$criteria->setDistinct();

		}

		$count = null;

		if ($this->collArticles === null) {

			if ($this->isNew()) {

				$count = 0;

			} else {

				$criteria->add(ArticlePeer::BOOK_ID, $this->id);

				$count = ArticlePeer::doCount($criteria, false, $con);

			}

		} else {

			// criteria has no effect for a new object

			if (!$this->isNew()) {

				// the following code is to determine if a new query is

				// called for.  If the criteria is the same as the last

				// one, just return count of the collection.

				$criteria->add(ArticlePeer::BOOK_ID, $this->id);

				if (!isset($this->lastArticleCriteria) || !$this->lastArticleCriteria->equals($criteria)) {

					$count = ArticlePeer::doCount($criteria, false, $con);

				} else {

					$count = count($this->collArticles);

				}

			} else {

				$count = count($this->collArticles);

			}

		}

		return $count;

	}

	/**

	 * Method called to associate a Article object to this object

	 * through the Article foreign key attribute.

	 *

	 * @param      Article $l Article

	 * @return     void

	 * @throws     PropelException

	 */

	public function addArticle(Article $l)

	{

		if ($this->collArticles === null) {

			$this->initArticles();

		}

		if (!in_array($l, $this->collArticles, true)) { // only add it if the **same** object is not already associated

			array_push($this->collArticles, $l);

			$l->setBook($this);

		}

	}

	/**

	 * If this collection has already been initialized with

	 * an identical criteria, it returns the collection.

	 * Otherwise if this Book is new, it will return

	 * an empty collection; or if this Book has previously

	 * been saved, it will retrieve related Articles from storage.

	 *

	 * This method is protected by default in order to keep the public

	 * api reasonable.  You can provide public methods for those you

	 * actually need in Book.

	 */

	public function getArticlesJoinCategory($criteria = null, $con = null, $join_behavior = Criteria::LEFT_JOIN)

	{

		if ($criteria === null) {

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

		}

		elseif ($criteria instanceof Criteria)

		{

			$criteria = clone $criteria;

		}

		if ($this->collArticles === null) {

			if ($this->isNew()) {

				$this->collArticles = array();

			} else {

				$criteria->add(ArticlePeer::BOOK_ID, $this->id);

				$this->collArticles = ArticlePeer::doSelectJoinCategory($criteria, $con, $join_behavior);

			}

		} else {

			// the following code is to determine if a new query is

			// called for.  If the criteria is the same as the last

			// one, just return the collection.

			$criteria->add(ArticlePeer::BOOK_ID, $this->id);

			if (!isset($this->lastArticleCriteria) || !$this->lastArticleCriteria->equals($criteria)) {

				$this->collArticles = ArticlePeer::doSelectJoinCategory($criteria, $con, $join_behavior);

			}

		}

		$this->lastArticleCriteria = $criteria;

		return $this->collArticles;

	}

	/**

	 * 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 ($this->collArticles) {

				foreach ((array) $this->collArticles as $o) {

					$o->clearAllReferences($deep);

				}

			}

		} // if ($deep)

		$this->collArticles = null;

	}

	// symfony_behaviors behavior

	/**

	 * Calls methods defined via {@link sfMixer}.

	 */

	public function __call($method, $arguments)

	{

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

	  {

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

	  }

	  array_unshift($arguments, $this);

	  return call_user_func_array($callable, $arguments);

	}

} // BaseBook