array ('Id', 'FirstName', 'LastName', 'Email', 'Age', ), BasePeer::TYPE_COLNAME => array (AuthorPeer::ID, AuthorPeer::FIRST_NAME, AuthorPeer::LAST_NAME, AuthorPeer::EMAIL, AuthorPeer::AGE, ), BasePeer::TYPE_FIELDNAME => array ('id', 'first_name', 'last_name', 'email', 'age', ), 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, 'FirstName' => 1, 'LastName' => 2, 'Email' => 3, 'Age' => 4, ), BasePeer::TYPE_COLNAME => array (AuthorPeer::ID => 0, AuthorPeer::FIRST_NAME => 1, AuthorPeer::LAST_NAME => 2, AuthorPeer::EMAIL => 3, AuthorPeer::AGE => 4, ), BasePeer::TYPE_FIELDNAME => array ('id' => 0, 'first_name' => 1, 'last_name' => 2, 'email' => 3, 'age' => 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/AuthorMapBuilder.php'; return BasePeer::getMapBuilder('bookstore.map.AuthorMapBuilder'); } /** * 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 = AuthorPeer::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. AuthorPeer::COLUMN_NAME). * @return string */ public static function alias($alias, $column) { return $alias . substr($column, strlen(AuthorPeer::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(AuthorPeer::ID); $criteria->addSelectColumn(AuthorPeer::FIRST_NAME); $criteria->addSelectColumn(AuthorPeer::LAST_NAME); $criteria->addSelectColumn(AuthorPeer::EMAIL); $criteria->addSelectColumn(AuthorPeer::AGE); } const COUNT = 'COUNT(author.ID)'; const COUNT_DISTINCT = 'COUNT(DISTINCT author.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(AuthorPeer::COUNT_DISTINCT); } else { $criteria->addSelectColumn(AuthorPeer::COUNT); } // just in case we're grouping: add those columns to the select statement foreach($criteria->getGroupByColumns() as $column) { $criteria->addSelectColumn($column); } $rs = AuthorPeer::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 Author * @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 = AuthorPeer::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 AuthorPeer::populateObjects(AuthorPeer::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; AuthorPeer::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 = AuthorPeer::getOMClass(); $cls = Propel::import($cls); // populate the object(s) while($rs->next()) { $obj = new $cls(); $obj->hydrate($rs); $results[] = $obj; } 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 AuthorPeer::CLASS_DEFAULT; } /** * Method perform an INSERT on the database, given a Author or Criteria object. * * @param mixed $values Criteria or Author 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 Author object } $criteria->remove(AuthorPeer::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 Author or Criteria object. * * @param mixed $values Criteria or Author 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(AuthorPeer::ID); $selectCriteria->add(AuthorPeer::ID, $criteria->remove(AuthorPeer::ID), $comparison); } else { // $values is Author 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 author 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(); AuthorPeer::doOnDeleteSetNull(new Criteria(), $con); $affectedRows += BasePeer::doDeleteAll(AuthorPeer::TABLE_NAME, $con); $con->commit(); return $affectedRows; } catch (PropelException $e) { $con->rollback(); throw $e; } } /** * Method perform a DELETE on the database, given a Author or Criteria object OR a primary key value. * * @param mixed $values Criteria or Author 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(AuthorPeer::DATABASE_NAME); } if ($values instanceof Criteria) { $criteria = clone $values; // rename for clarity } elseif ($values instanceof Author) { $criteria = $values->buildPkeyCriteria(); } else { // it must be the primary key $criteria = new Criteria(self::DATABASE_NAME); $criteria->add(AuthorPeer::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(); AuthorPeer::doOnDeleteSetNull($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 SET NULL 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 void */ protected static function doOnDeleteSetNull(Criteria $criteria, Connection $con) { // first find the objects that are implicated by the $criteria $objects = AuthorPeer::doSelect($criteria, $con); foreach($objects as $obj) { // set fkey col in related Book rows to NULL $selectCriteria = new Criteria(AuthorPeer::DATABASE_NAME); $updateValues = new Criteria(AuthorPeer::DATABASE_NAME); $selectCriteria->add(BookPeer::AUTHOR_ID, $obj->getId()); $updateValues->add(BookPeer::AUTHOR_ID, null); BasePeer::doUpdate($selectCriteria, $updateValues, $con); // use BasePeer because generated Peer doUpdate() methods only update using pkey } } /** * Validates all modified columns of given Author 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 Author $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(Author $obj, $cols = null) { $columns = array(); if ($cols) { $dbMap = Propel::getDatabaseMap(AuthorPeer::DATABASE_NAME); $tableMap = $dbMap->getTable(AuthorPeer::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(AuthorPeer::LAST_NAME)) $columns[AuthorPeer::LAST_NAME] = $obj->getLastName(); if ($obj->isNew() || $obj->isColumnModified(AuthorPeer::EMAIL)) $columns[AuthorPeer::EMAIL] = $obj->getEmail(); if ($obj->isNew() || $obj->isColumnModified(AuthorPeer::AGE)) $columns[AuthorPeer::AGE] = $obj->getAge(); } return BasePeer::doValidate(AuthorPeer::DATABASE_NAME, AuthorPeer::TABLE_NAME, $columns); } /** * Retrieve a single object by pkey. * * @param mixed $pk the primary key. * @param Connection $con the connection to use * @return Author */ public static function retrieveByPK($pk, $con = null) { if ($con === null) { $con = Propel::getConnection(self::DATABASE_NAME); } $criteria = new Criteria(AuthorPeer::DATABASE_NAME); $criteria->add(AuthorPeer::ID, $pk); $v = AuthorPeer::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(AuthorPeer::ID, $pks, Criteria::IN); $objs = AuthorPeer::doSelect($criteria, $con); } return $objs; } } // BaseAuthorPeer // 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 { BaseAuthorPeer::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/AuthorMapBuilder.php'; Propel::registerMapBuilder('bookstore.map.AuthorMapBuilder'); }