array ('Id', 'Title', 'ISBN', 'PublisherId', 'AuthorId', ), BasePeer::TYPE_COLNAME => array (BookPeer::ID, BookPeer::TITLE, BookPeer::ISBN, BookPeer::PUBLISHER_ID, BookPeer::AUTHOR_ID, ), BasePeer::TYPE_FIELDNAME => array ('id', 'title', 'isbn', 'publisher_id', 'author_id', ), BasePeer::TYPE_NUM => array (0, 1, 2, 3, 4, ) ); /** * holds an array of keys for quick access to the fieldnames array * * first dimension keys are the type constants * e.g. self::$fieldNames[BasePeer::TYPE_PHPNAME]['Id'] = 0 */ private static $fieldKeys = array ( BasePeer::TYPE_PHPNAME => array ('Id' => 0, 'Title' => 1, 'ISBN' => 2, 'PublisherId' => 3, 'AuthorId' => 4, ), BasePeer::TYPE_COLNAME => array (BookPeer::ID => 0, BookPeer::TITLE => 1, BookPeer::ISBN => 2, BookPeer::PUBLISHER_ID => 3, BookPeer::AUTHOR_ID => 4, ), BasePeer::TYPE_FIELDNAME => array ('id' => 0, 'title' => 1, 'isbn' => 2, 'publisher_id' => 3, 'author_id' => 4, ), BasePeer::TYPE_NUM => array (0, 1, 2, 3, 4, ) ); /** * @return MapBuilder the map builder for this peer * @throws PropelException Any exceptions caught during processing will be * rethrown wrapped into a PropelException. */ public static function getMapBuilder() { include_once 'bookstore/map/BookMapBuilder.php'; return BasePeer::getMapBuilder('bookstore.map.BookMapBuilder'); } /** * Gets a map (hash) of PHP names to DB column names. * * @return array The PHP to DB name map for this peer * @throws PropelException Any exceptions caught during processing will be * rethrown wrapped into a PropelException. * @todo Consider having template build the array rather than doing it at runtime. */ public static function getPhpNameMap() { if (self::$phpNameMap === null) { $map = BookPeer::getTableMap(); $columns = $map->getColumns(); $nameMap = array(); foreach ($columns as $column) { $nameMap[$column->getPhpName()] = $column->getColumnName(); } self::$phpNameMap = $nameMap; } return self::$phpNameMap; } /** * Translates a fieldname to another type * * @param string $name field name * @param string $fromType One of the class type constants TYPE_PHPNAME, * TYPE_COLNAME, TYPE_FIELDNAME, TYPE_NUM * @param string $toType One of the class type constants * @return string translated name of the field. */ static public function translateFieldName($name, $fromType, $toType) { $toNames = self::getFieldNames($toType); $key = self::$fieldKeys[$fromType][$name]; if ($key === false) { throw new PropelException("'$name' could not be found in the field names of type '$fromType'. These are: " . print_r($fromNames, true)); } return $toNames[$key]; } /** * Returns an array of of field names. * * @param string $type The type of fieldnames to return: * One of the class type constants TYPE_PHPNAME, * TYPE_COLNAME, TYPE_FIELDNAME, TYPE_NUM * @return array A list of field names */ static public function getFieldNames($type = BasePeer::TYPE_PHPNAME) { if (!array_key_exists($type, self::$fieldNames)) { throw new PropelException('Method getFieldNames() expects the parameter $type to be one of the class constants TYPE_PHPNAME, TYPE_COLNAME, TYPE_FIELDNAME, TYPE_NUM. ' . $type . ' was given.'); } return self::$fieldNames[$type]; } /** * Convenience method which changes table.column to alias.column. * * Using this method you can maintain SQL abstraction while using column aliases. * * $c->addAlias("alias1", TablePeer::TABLE_NAME); * $c->addJoin(TablePeer::alias("alias1", TablePeer::PRIMARY_KEY_COLUMN), TablePeer::PRIMARY_KEY_COLUMN); * * @param string $alias The alias for the current table. * @param string $column The column name for current table. (i.e. BookPeer::COLUMN_NAME). * @return string */ public static function alias($alias, $column) { return $alias . substr($column, strlen(BookPeer::TABLE_NAME)); } /** * Add all the columns needed to create a new object. * * Note: any columns that were marked with lazyLoad="true" in the * XML schema will not be added to the select list and only loaded * on demand. * * @param criteria object containing the columns to add. * @throws PropelException Any exceptions caught during processing will be * rethrown wrapped into a PropelException. */ public static function addSelectColumns(Criteria $criteria) { $criteria->addSelectColumn(BookPeer::ID); $criteria->addSelectColumn(BookPeer::TITLE); $criteria->addSelectColumn(BookPeer::ISBN); $criteria->addSelectColumn(BookPeer::PUBLISHER_ID); $criteria->addSelectColumn(BookPeer::AUTHOR_ID); } const COUNT = 'COUNT(book.ID)'; const COUNT_DISTINCT = 'COUNT(DISTINCT book.ID)'; /** * Returns the number of rows matching criteria. * * @param Criteria $criteria * @param boolean $distinct Whether to select only distinct columns (You can also set DISTINCT modifier in Criteria). * @param Connection $con * @return int Number of matching rows. */ public static function doCount(Criteria $criteria, $distinct = false, $con = null) { // we're going to modify criteria, so copy it first $criteria = clone $criteria; // clear out anything that might confuse the ORDER BY clause $criteria->clearSelectColumns()->clearOrderByColumns(); if ($distinct || in_array(Criteria::DISTINCT, $criteria->getSelectModifiers())) { $criteria->addSelectColumn(BookPeer::COUNT_DISTINCT); } else { $criteria->addSelectColumn(BookPeer::COUNT); } // just in case we're grouping: add those columns to the select statement foreach($criteria->getGroupByColumns() as $column) { $criteria->addSelectColumn($column); } $rs = BookPeer::doSelectRS($criteria, $con); if ($rs->next()) { return $rs->getInt(1); } else { // no rows returned; we infer that means 0 matches. return 0; } } /** * Method to select one object from the DB. * * @param Criteria $criteria object used to create the SELECT statement. * @param Connection $con * @return Book * @throws PropelException Any exceptions caught during processing will be * rethrown wrapped into a PropelException. */ public static function doSelectOne(Criteria $criteria, $con = null) { $critcopy = clone $criteria; $critcopy->setLimit(1); $objects = BookPeer::doSelect($critcopy, $con); if ($objects) { return $objects[0]; } return null; } /** * Method to do selects. * * @param Criteria $criteria The Criteria object used to build the SELECT statement. * @param Connection $con * @return array Array of selected Objects * @throws PropelException Any exceptions caught during processing will be * rethrown wrapped into a PropelException. */ public static function doSelect(Criteria $criteria, $con = null) { return BookPeer::populateObjects(BookPeer::doSelectRS($criteria, $con)); } /** * Prepares the Criteria object and uses the parent doSelect() * method to get a ResultSet. * * Use this method directly if you want to just get the resultset * (instead of an array of objects). * * @param Criteria $criteria The Criteria object used to build the SELECT statement. * @param Connection $con the connection to use * @throws PropelException Any exceptions caught during processing will be * rethrown wrapped into a PropelException. * @return ResultSet The resultset object with numerically-indexed fields. * @see BasePeer::doSelect() */ public static function doSelectRS(Criteria $criteria, $con = null) { if ($con === null) { $con = Propel::getConnection(self::DATABASE_NAME); } if (!$criteria->getSelectColumns()) { $criteria = clone $criteria; BookPeer::addSelectColumns($criteria); } // Set the correct dbName $criteria->setDbName(self::DATABASE_NAME); // BasePeer returns a Creole ResultSet, set to return // rows indexed numerically. return BasePeer::doSelect($criteria, $con); } /** * The returned array will contain objects of the default type or * objects that inherit from the default. * * @throws PropelException Any exceptions caught during processing will be * rethrown wrapped into a PropelException. */ public static function populateObjects(ResultSet $rs) { $results = array(); // set the class once to avoid overhead in the loop $cls = BookPeer::getOMClass(); $cls = Propel::import($cls); // populate the object(s) while($rs->next()) { $obj = new $cls(); $obj->hydrate($rs); $results[] = $obj; } return $results; } /** * Returns the number of rows matching criteria, joining the related Publisher table * * @param Criteria $c * @param boolean $distinct Whether to select only distinct columns (You can also set DISTINCT modifier in Criteria). * @param Connection $con * @return int Number of matching rows. */ public static function doCountJoinPublisher(Criteria $c, $distinct = false, $con = null) { // we're going to modify criteria, so copy it first $criteria = clone $criteria; // clear out anything that might confuse the ORDER BY clause $criteria->clearSelectColumns()->clearOrderByColumns(); if ($distinct || in_array(Criteria::DISTINCT, $criteria->getSelectModifiers())) { $criteria->addSelectColumn(BookPeer::COUNT_DISTINCT); } else { $criteria->addSelectColumn(BookPeer::COUNT); } // just in case we're grouping: add those columns to the select statement foreach($criteria->getGroupByColumns() as $column) { $criteria->addSelectColumn($column); } $criteria->addJoin(BookPeer::PUBLISHER_ID, PublisherPeer::ID); $rs = BookPeer::doSelectRS($criteria, $con); if ($rs->next()) { return $rs->getInt(1); } else { // no rows returned; we infer that means 0 matches. return 0; } } /** * Returns the number of rows matching criteria, joining the related Author table * * @param Criteria $c * @param boolean $distinct Whether to select only distinct columns (You can also set DISTINCT modifier in Criteria). * @param Connection $con * @return int Number of matching rows. */ public static function doCountJoinAuthor(Criteria $c, $distinct = false, $con = null) { // we're going to modify criteria, so copy it first $criteria = clone $criteria; // clear out anything that might confuse the ORDER BY clause $criteria->clearSelectColumns()->clearOrderByColumns(); if ($distinct || in_array(Criteria::DISTINCT, $criteria->getSelectModifiers())) { $criteria->addSelectColumn(BookPeer::COUNT_DISTINCT); } else { $criteria->addSelectColumn(BookPeer::COUNT); } // just in case we're grouping: add those columns to the select statement foreach($criteria->getGroupByColumns() as $column) { $criteria->addSelectColumn($column); } $criteria->addJoin(BookPeer::AUTHOR_ID, AuthorPeer::ID); $rs = BookPeer::doSelectRS($criteria, $con); if ($rs->next()) { return $rs->getInt(1); } else { // no rows returned; we infer that means 0 matches. return 0; } } /** * Selects a collection of Book objects pre-filled with their Publisher objects. * * @return array Array of Book objects. * @throws PropelException Any exceptions caught during processing will be * rethrown wrapped into a PropelException. */ public static function doSelectJoinPublisher(Criteria $c, $con = null) { $c = clone $c; // Set the correct dbName if it has not been overridden if ($c->getDbName() == Propel::getDefaultDB()) { $c->setDbName(self::DATABASE_NAME); } BookPeer::addSelectColumns($c); $startcol = (BookPeer::NUM_COLUMNS - BookPeer::NUM_LAZY_LOAD_COLUMNS) + 1; PublisherPeer::addSelectColumns($c); $c->addJoin(BookPeer::PUBLISHER_ID, PublisherPeer::ID); $rs = BasePeer::doSelect($c, $con); $results = array(); while($rs->next()) { $omClass = BookPeer::getOMClass(); $cls = Propel::import($omClass); $obj1 = new $cls(); $obj1->hydrate($rs); $omClass = PublisherPeer::getOMClass(); $cls = Propel::import($omClass); $obj2 = new $cls(); $obj2->hydrate($rs, $startcol); $newObject = true; foreach($results as $temp_obj1) { $temp_obj2 = $temp_obj1->getPublisher(); //CHECKME if ($temp_obj2->getPrimaryKey() === $obj2->getPrimaryKey()) { $newObject = false; // e.g. $author->addBookRelatedByBookId() $temp_obj2->addBook($obj1); //CHECKME break; } } if ($newObject) { $obj2->initBooks(); $obj2->addBook($obj1); //CHECKME } $results[] = $obj1; } return $results; } /** * Selects a collection of Book objects pre-filled with their Author objects. * * @return array Array of Book objects. * @throws PropelException Any exceptions caught during processing will be * rethrown wrapped into a PropelException. */ public static function doSelectJoinAuthor(Criteria $c, $con = null) { $c = clone $c; // Set the correct dbName if it has not been overridden if ($c->getDbName() == Propel::getDefaultDB()) { $c->setDbName(self::DATABASE_NAME); } BookPeer::addSelectColumns($c); $startcol = (BookPeer::NUM_COLUMNS - BookPeer::NUM_LAZY_LOAD_COLUMNS) + 1; AuthorPeer::addSelectColumns($c); $c->addJoin(BookPeer::AUTHOR_ID, AuthorPeer::ID); $rs = BasePeer::doSelect($c, $con); $results = array(); while($rs->next()) { $omClass = BookPeer::getOMClass(); $cls = Propel::import($omClass); $obj1 = new $cls(); $obj1->hydrate($rs); $omClass = AuthorPeer::getOMClass(); $cls = Propel::import($omClass); $obj2 = new $cls(); $obj2->hydrate($rs, $startcol); $newObject = true; foreach($results as $temp_obj1) { $temp_obj2 = $temp_obj1->getAuthor(); //CHECKME if ($temp_obj2->getPrimaryKey() === $obj2->getPrimaryKey()) { $newObject = false; // e.g. $author->addBookRelatedByBookId() $temp_obj2->addBook($obj1); //CHECKME break; } } if ($newObject) { $obj2->initBooks(); $obj2->addBook($obj1); //CHECKME } $results[] = $obj1; } return $results; } /** * Returns the number of rows matching criteria, joining all related tables * * @param Criteria $c * @param boolean $distinct Whether to select only distinct columns (You can also set DISTINCT modifier in Criteria). * @param Connection $con * @return int Number of matching rows. */ public static function doCountJoinAll(Criteria $c, $distinct = false, $con = null) { $criteria = clone $c; // clear out anything that might confuse the ORDER BY clause $criteria->clearSelectColumns()->clearOrderByColumns(); if ($distinct || in_array(Criteria::DISTINCT, $criteria->getSelectModifiers())) { $criteria->addSelectColumn(BookPeer::COUNT_DISTINCT); } else { $criteria->addSelectColumn(BookPeer::COUNT); } // just in case we're grouping: add those columns to the select statement foreach($criteria->getGroupByColumns() as $column) { $criteria->addSelectColumn($column); } $criteria->addJoin(BookPeer::PUBLISHER_ID, PublisherPeer::ID); $criteria->addJoin(BookPeer::AUTHOR_ID, AuthorPeer::ID); $rs = BookPeer::doSelectRS($criteria, $con); if ($rs->next()) { return $rs->getInt(1); } else { // no rows returned; we infer that means 0 matches. return 0; } } /** * Selects a collection of Book objects pre-filled with all related objects. * * @return array Array of Book objects. * @throws PropelException Any exceptions caught during processing will be * rethrown wrapped into a PropelException. */ public static function doSelectJoinAll(Criteria $c, $con = null) { $c = clone $c; // Set the correct dbName if it has not been overridden if ($c->getDbName() == Propel::getDefaultDB()) { $c->setDbName(self::DATABASE_NAME); } BookPeer::addSelectColumns($c); $startcol2 = (BookPeer::NUM_COLUMNS - BookPeer::NUM_LAZY_LOAD_COLUMNS) + 1; PublisherPeer::addSelectColumns($c); $startcol3 = $startcol2 + PublisherPeer::NUM_COLUMNS; AuthorPeer::addSelectColumns($c); $startcol4 = $startcol3 + AuthorPeer::NUM_COLUMNS; $c->addJoin(BookPeer::PUBLISHER_ID, PublisherPeer::ID); $c->addJoin(BookPeer::AUTHOR_ID, AuthorPeer::ID); $rs = BasePeer::doSelect($c, $con); $results = array(); while($rs->next()) { $omClass = BookPeer::getOMClass(); $cls = Propel::import($omClass); $obj1 = new $cls(); $obj1->hydrate($rs); // Add objects for joined Author rows $omClass = AuthorPeer::getOMClass(); $cls = Propel::import($omClass); $obj2 = new $cls(); $obj2->hydrate($rs, $startcol2); $newObject = true; for ($j=0, $resCount=count($results); $j < $resCount; $j++) { $temp_obj1 = $results[$j]; $temp_obj2 = $temp_obj1->getPublisher(); // CHECKME if ($temp_obj2->getPrimaryKey() === $obj2->getPrimaryKey()) { $newObject = false; $temp_obj2->addBook($obj1); // CHECKME break; } } if ($newObject) { $obj2->initBooks(); $obj2->addBook($obj1); } // Add objects for joined Author rows $omClass = AuthorPeer::getOMClass(); $cls = Propel::import($omClass); $obj3 = new $cls(); $obj3->hydrate($rs, $startcol3); $newObject = true; for ($j=0, $resCount=count($results); $j < $resCount; $j++) { $temp_obj1 = $results[$j]; $temp_obj3 = $temp_obj1->getAuthor(); // CHECKME if ($temp_obj3->getPrimaryKey() === $obj3->getPrimaryKey()) { $newObject = false; $temp_obj3->addBook($obj1); // CHECKME break; } } if ($newObject) { $obj3->initBooks(); $obj3->addBook($obj1); } $results[] = $obj1; } return $results; } /** * Returns the number of rows matching criteria, joining the related Publisher table * * @param Criteria $c * @param boolean $distinct Whether to select only distinct columns (You can also set DISTINCT modifier in Criteria). * @param Connection $con * @return int Number of matching rows. */ public static function doCountJoinAllExceptPublisher(Criteria $c, $distinct = false, $con = null) { // we're going to modify criteria, so copy it first $criteria = clone $criteria; // clear out anything that might confuse the ORDER BY clause $criteria->clearSelectColumns()->clearOrderByColumns(); if ($distinct || in_array(Criteria::DISTINCT, $criteria->getSelectModifiers())) { $criteria->addSelectColumn(BookPeer::COUNT_DISTINCT); } else { $criteria->addSelectColumn(BookPeer::COUNT); } // just in case we're grouping: add those columns to the select statement foreach($criteria->getGroupByColumns() as $column) { $criteria->addSelectColumn($column); } $criteria->addJoin(BookPeer::AUTHOR_ID, AuthorPeer::ID); $rs = BookPeer::doSelectRS($criteria, $con); if ($rs->next()) { return $rs->getInt(1); } else { // no rows returned; we infer that means 0 matches. return 0; } } /** * Returns the number of rows matching criteria, joining the related Author table * * @param Criteria $c * @param boolean $distinct Whether to select only distinct columns (You can also set DISTINCT modifier in Criteria). * @param Connection $con * @return int Number of matching rows. */ public static function doCountJoinAllExceptAuthor(Criteria $c, $distinct = false, $con = null) { // we're going to modify criteria, so copy it first $criteria = clone $criteria; // clear out anything that might confuse the ORDER BY clause $criteria->clearSelectColumns()->clearOrderByColumns(); if ($distinct || in_array(Criteria::DISTINCT, $criteria->getSelectModifiers())) { $criteria->addSelectColumn(BookPeer::COUNT_DISTINCT); } else { $criteria->addSelectColumn(BookPeer::COUNT); } // just in case we're grouping: add those columns to the select statement foreach($criteria->getGroupByColumns() as $column) { $criteria->addSelectColumn($column); } $criteria->addJoin(BookPeer::PUBLISHER_ID, PublisherPeer::ID); $rs = BookPeer::doSelectRS($criteria, $con); if ($rs->next()) { return $rs->getInt(1); } else { // no rows returned; we infer that means 0 matches. return 0; } } /** * Selects a collection of Book objects pre-filled with all related objects except Publisher. * * @return array Array of Book objects. * @throws PropelException Any exceptions caught during processing will be * rethrown wrapped into a PropelException. */ public static function doSelectJoinAllExceptPublisher(Criteria $c, $con = null) { $c = clone $c; // Set the correct dbName if it has not been overridden // $c->getDbName() will return the same object if not set to another value // so == check is okay and faster if ($c->getDbName() == Propel::getDefaultDB()) { $c->setDbName(self::DATABASE_NAME); } BookPeer::addSelectColumns($c); $startcol2 = (BookPeer::NUM_COLUMNS - BookPeer::NUM_LAZY_LOAD_COLUMNS) + 1; AuthorPeer::addSelectColumns($c); $startcol3 = $startcol2 + AuthorPeer::NUM_COLUMNS; $c->addJoin(BookPeer::AUTHOR_ID, AuthorPeer::ID); $rs = BasePeer::doSelect($c, $con); $results = array(); while($rs->next()) { $omClass = BookPeer::getOMClass(); $cls = Propel::import($omClass); $obj1 = new $cls(); $obj1->hydrate($rs); $omClass = AuthorPeer::getOMClass(); $cls = Propel::import($omClass); $obj2 = new $cls(); $obj2->hydrate($rs, $startcol2); $newObject = true; for ($j=0, $resCount=count($results); $j < $resCount; $j++) { $temp_obj1 = $results[$j]; $temp_obj2 = $temp_obj1->getAuthor(); //CHECKME if ($temp_obj2->getPrimaryKey() === $obj2->getPrimaryKey()) { $newObject = false; $temp_obj2->addBook($obj1); break; } } if ($newObject) { $obj2->initBooks(); $obj2->addBook($obj1); } $results[] = $obj1; } return $results; } /** * Selects a collection of Book objects pre-filled with all related objects except Author. * * @return array Array of Book objects. * @throws PropelException Any exceptions caught during processing will be * rethrown wrapped into a PropelException. */ public static function doSelectJoinAllExceptAuthor(Criteria $c, $con = null) { $c = clone $c; // Set the correct dbName if it has not been overridden // $c->getDbName() will return the same object if not set to another value // so == check is okay and faster if ($c->getDbName() == Propel::getDefaultDB()) { $c->setDbName(self::DATABASE_NAME); } BookPeer::addSelectColumns($c); $startcol2 = (BookPeer::NUM_COLUMNS - BookPeer::NUM_LAZY_LOAD_COLUMNS) + 1; PublisherPeer::addSelectColumns($c); $startcol3 = $startcol2 + PublisherPeer::NUM_COLUMNS; $c->addJoin(BookPeer::PUBLISHER_ID, PublisherPeer::ID); $rs = BasePeer::doSelect($c, $con); $results = array(); while($rs->next()) { $omClass = BookPeer::getOMClass(); $cls = Propel::import($omClass); $obj1 = new $cls(); $obj1->hydrate($rs); $omClass = PublisherPeer::getOMClass(); $cls = Propel::import($omClass); $obj2 = new $cls(); $obj2->hydrate($rs, $startcol2); $newObject = true; for ($j=0, $resCount=count($results); $j < $resCount; $j++) { $temp_obj1 = $results[$j]; $temp_obj2 = $temp_obj1->getPublisher(); //CHECKME if ($temp_obj2->getPrimaryKey() === $obj2->getPrimaryKey()) { $newObject = false; $temp_obj2->addBook($obj1); break; } } if ($newObject) { $obj2->initBooks(); $obj2->addBook($obj1); } $results[] = $obj1; } return $results; } /** * Returns the TableMap related to this peer. * This method is not needed for general use but a specific application could have a need. * @return TableMap * @throws PropelException Any exceptions caught during processing will be * rethrown wrapped into a PropelException. */ public static function getTableMap() { return Propel::getDatabaseMap(self::DATABASE_NAME)->getTable(self::TABLE_NAME); } /** * The class that the Peer will make instances of. * * This uses a dot-path notation which is tranalted into a path * relative to a location on the PHP include_path. * (e.g. path.to.MyClass -> 'path/to/MyClass.php') * * @return string path.to.ClassName */ public static function getOMClass() { return BookPeer::CLASS_DEFAULT; } /** * Method perform an INSERT on the database, given a Book or Criteria object. * * @param mixed $values Criteria or Book object containing data that is used to create the INSERT statement. * @param Connection $con the connection to use * @return mixed The new primary key. * @throws PropelException Any exceptions caught during processing will be * rethrown wrapped into a PropelException. */ public static function doInsert($values, $con = null) { if ($con === null) { $con = Propel::getConnection(self::DATABASE_NAME); } if ($values instanceof Criteria) { $criteria = clone $values; // rename for clarity } else { $criteria = $values->buildCriteria(); // build Criteria from Book object } $criteria->remove(BookPeer::ID); // remove pkey col since this table uses auto-increment // Set the correct dbName $criteria->setDbName(self::DATABASE_NAME); try { // use transaction because $criteria could contain info // for more than one table (I guess, conceivably) $con->begin(); $pk = BasePeer::doInsert($criteria, $con); $con->commit(); } catch(PropelException $e) { $con->rollback(); throw $e; } return $pk; } /** * Method perform an UPDATE on the database, given a Book or Criteria object. * * @param mixed $values Criteria or Book object containing data that is used to create the UPDATE statement. * @param Connection $con The connection to use (specify Connection object to exert more control over transactions). * @return int The number of affected rows (if supported by underlying database driver). * @throws PropelException Any exceptions caught during processing will be * rethrown wrapped into a PropelException. */ public static function doUpdate($values, $con = null) { if ($con === null) { $con = Propel::getConnection(self::DATABASE_NAME); } $selectCriteria = new Criteria(self::DATABASE_NAME); if ($values instanceof Criteria) { $criteria = clone $values; // rename for clarity $comparison = $criteria->getComparison(BookPeer::ID); $selectCriteria->add(BookPeer::ID, $criteria->remove(BookPeer::ID), $comparison); } else { // $values is Book object $criteria = $values->buildCriteria(); // gets full criteria $selectCriteria = $values->buildPkeyCriteria(); // gets criteria w/ primary key(s) } // set the correct dbName $criteria->setDbName(self::DATABASE_NAME); return BasePeer::doUpdate($selectCriteria, $criteria, $con); } /** * Method to DELETE all rows from the book table. * * @return int The number of affected rows (if supported by underlying database driver). */ public static function doDeleteAll($con = null) { if ($con === null) { $con = Propel::getConnection(self::DATABASE_NAME); } $affectedRows = 0; // initialize var to track total num of affected rows try { // use transaction because $criteria could contain info // for more than one table or we could emulating ON DELETE CASCADE, etc. $con->begin(); $affectedRows += BookPeer::doOnDeleteCascade(new Criteria(), $con); $affectedRows += BasePeer::doDeleteAll(BookPeer::TABLE_NAME, $con); $con->commit(); return $affectedRows; } catch (PropelException $e) { $con->rollback(); throw $e; } } /** * Method perform a DELETE on the database, given a Book or Criteria object OR a primary key value. * * @param mixed $values Criteria or Book object or primary key or array of primary keys * which is used to create the DELETE statement * @param Connection $con the connection to use * @return int The number of affected rows (if supported by underlying database driver). This includes CASCADE-related rows * if supported by native driver or if emulated using Propel. * @throws PropelException Any exceptions caught during processing will be * rethrown wrapped into a PropelException. */ public static function doDelete($values, $con = null) { if ($con === null) { $con = Propel::getConnection(BookPeer::DATABASE_NAME); } if ($values instanceof Criteria) { $criteria = clone $values; // rename for clarity } elseif ($values instanceof Book) { $criteria = $values->buildPkeyCriteria(); } else { // it must be the primary key $criteria = new Criteria(self::DATABASE_NAME); $criteria->add(BookPeer::ID, (array) $values, Criteria::IN); } // Set the correct dbName $criteria->setDbName(self::DATABASE_NAME); $affectedRows = 0; // initialize var to track total num of affected rows try { // use transaction because $criteria could contain info // for more than one table or we could emulating ON DELETE CASCADE, etc. $con->begin(); $affectedRows += BookPeer::doOnDeleteCascade($criteria, $con); $affectedRows += BasePeer::doDelete($criteria, $con); $con->commit(); return $affectedRows; } catch (PropelException $e) { $con->rollback(); throw $e; } } /** * This is a method for emulating ON DELETE CASCADE for DBs that don't support this * feature (like MySQL or SQLite). * * This method is not very speedy because it must perform a query first to get * the implicated records and then perform the deletes by calling those Peer classes. * * This method should be used within a transaction if possible. * * @param Criteria $criteria * @param Connection $con * @return int The number of affected rows (if supported by underlying database driver). */ protected static function doOnDeleteCascade(Criteria $criteria, Connection $con) { // initialize var to track total num of affected rows $affectedRows = 0; // first find the objects that are implicated by the $criteria $objects = BookPeer::doSelect($criteria, $con); foreach($objects as $obj) { include_once 'bookstore/Review.php'; // delete related Review objects $c = new Criteria(); $c->add(ReviewPeer::BOOK_ID, $obj->getId()); $affectedRows += ReviewPeer::doDelete($c, $con); include_once 'bookstore/Media.php'; // delete related Media objects $c = new Criteria(); $c->add(MediaPeer::BOOK_ID, $obj->getId()); $affectedRows += MediaPeer::doDelete($c, $con); include_once 'bookstore/BookListRel.php'; // delete related BookListRel objects $c = new Criteria(); $c->add(BookListRelPeer::BOOK_ID, $obj->getId()); $affectedRows += BookListRelPeer::doDelete($c, $con); } return $affectedRows; } /** * Validates all modified columns of given Book object. * If parameter $columns is either a single column name or an array of column names * than only those columns are validated. * * NOTICE: This does not apply to primary or foreign keys for now. * * @param Book $obj The object to validate. * @param mixed $cols Column name or array of column names. * * @return mixed TRUE if all columns are valid or the error message of the first invalid column. */ public static function doValidate(Book $obj, $cols = null) { $columns = array(); if ($cols) { $dbMap = Propel::getDatabaseMap(BookPeer::DATABASE_NAME); $tableMap = $dbMap->getTable(BookPeer::TABLE_NAME); if (! is_array($cols)) { $cols = array($cols); } foreach($cols as $colName) { if ($tableMap->containsColumn($colName)) { $get = 'get' . $tableMap->getColumn($colName)->getPhpName(); $columns[$colName] = $obj->$get(); } } } else { if ($obj->isNew() || $obj->isColumnModified(BookPeer::TITLE)) $columns[BookPeer::TITLE] = $obj->getTitle(); if ($obj->isNew() || $obj->isColumnModified(BookPeer::ISBN)) $columns[BookPeer::ISBN] = $obj->getISBN(); } return BasePeer::doValidate(BookPeer::DATABASE_NAME, BookPeer::TABLE_NAME, $columns); } /** * Retrieve a single object by pkey. * * @param mixed $pk the primary key. * @param Connection $con the connection to use * @return Book */ public static function retrieveByPK($pk, $con = null) { if ($con === null) { $con = Propel::getConnection(self::DATABASE_NAME); } $criteria = new Criteria(BookPeer::DATABASE_NAME); $criteria->add(BookPeer::ID, $pk); $v = BookPeer::doSelect($criteria, $con); return !empty($v) > 0 ? $v[0] : null; } /** * Retrieve multiple objects by pkey. * * @param array $pks List of primary keys * @param Connection $con the connection to use * @throws PropelException Any exceptions caught during processing will be * rethrown wrapped into a PropelException. */ public static function retrieveByPKs($pks, $con = null) { if ($con === null) { $con = Propel::getConnection(self::DATABASE_NAME); } $objs = null; if (empty($pks)) { $objs = array(); } else { $criteria = new Criteria(); $criteria->add(BookPeer::ID, $pks, Criteria::IN); $objs = BookPeer::doSelect($criteria, $con); } return $objs; } } // BaseBookPeer // static code to register the map builder for this Peer with the main Propel class if (Propel::isInit()) { // the MapBuilder classes register themselves with Propel during initialization // so we need to load them here. try { BaseBookPeer::getMapBuilder(); } catch (Exception $e) { Propel::log('Could not initialize Peer: ' . $e->getMessage(), Propel::LOG_ERR); } } else { // even if Propel is not yet initialized, the map builder class can be registered // now and then it will be loaded when Propel initializes. require_once 'bookstore/map/BookMapBuilder.php'; Propel::registerMapBuilder('bookstore.map.BookMapBuilder'); }