/**
* Find object by primary key.
* Propel uses the instance pool to skip the database if the object exists.
* Go fast if the query is untouched.
*
* <code>
* $obj = $c->findPk(12, $con);
* </code>
*
* @param mixed $key Primary key to use for the query
* @param PropelPDO $con an optional connection object
*
* @return Author|Author[]|mixed the result, formatted by the current formatter
*/
public function findPk($key, $con = null)
{
if ($key === null) {
return null;
}
if (null !== ($obj = AuthorPeer::getInstanceFromPool((string) $key)) && !$this->formatter) {
// the object is already in the instance pool
return $obj;
}
if ($con === null) {
$con = Propel::getConnection(AuthorPeer::DATABASE_NAME, Propel::CONNECTION_READ);
}
$this->basePreSelect($con);
if ($this->formatter || $this->modelAlias || $this->with || $this->select || $this->selectColumns || $this->asColumns || $this->selectModifiers || $this->map || $this->having || $this->joins) {
return $this->findPkComplex($key, $con);
} else {
return $this->findPkSimple($key, $con);
}
}
/**
* Retrieve a single object by pkey.
*
* @param int $pk the primary key.
* @param PropelPDO $con the connection to use
* @return Author
*/
public static function retrieveByPK($pk, PropelPDO $con = null)
{
if (null !== ($obj = AuthorPeer::getInstanceFromPool((string) $pk))) {
return $obj;
}
if ($con === null) {
$con = Propel::getConnection(AuthorPeer::DATABASE_NAME, Propel::CONNECTION_READ);
}
$criteria = new Criteria(AuthorPeer::DATABASE_NAME);
$criteria->add(AuthorPeer::ID, $pk);
$v = AuthorPeer::doSelect($criteria, $con);
return !empty($v) > 0 ? $v[0] : null;
}
/**
* Selects a collection of Book objects pre-filled with all related objects.
*
* @param Criteria $criteria
* @param PropelPDO $con
* @param String $join_behavior the type of joins to use, defaults to Criteria::LEFT_JOIN
* @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 $criteria, $con = null, $join_behavior = Criteria::LEFT_JOIN)
{
$criteria = clone $criteria;
// Set the correct dbName if it has not been overridden
if ($criteria->getDbName() == Propel::getDefaultDB()) {
$criteria->setDbName(BookPeer::DATABASE_NAME);
}
BookPeer::addSelectColumns($criteria);
$startcol2 = BookPeer::NUM_HYDRATE_COLUMNS;
AuthorPeer::addSelectColumns($criteria);
$startcol3 = $startcol2 + AuthorPeer::NUM_HYDRATE_COLUMNS;
$criteria->addJoin(BookPeer::AUTHOR_ID, AuthorPeer::ID, $join_behavior);
$stmt = BasePeer::doSelect($criteria, $con);
$results = array();
while ($row = $stmt->fetch(PDO::FETCH_NUM)) {
$key1 = BookPeer::getPrimaryKeyHashFromRow($row, 0);
if (null !== ($obj1 = BookPeer::getInstanceFromPool($key1))) {
// We no longer rehydrate the object, since this can cause data loss.
// See http://www.propelorm.org/ticket/509
// $obj1->hydrate($row, 0, true); // rehydrate
} else {
$cls = BookPeer::getOMClass();
$obj1 = new $cls();
$obj1->hydrate($row);
BookPeer::addInstanceToPool($obj1, $key1);
}
// if obj1 already loaded
// Add objects for joined Author rows
$key2 = AuthorPeer::getPrimaryKeyHashFromRow($row, $startcol2);
if ($key2 !== null) {
$obj2 = AuthorPeer::getInstanceFromPool($key2);
if (!$obj2) {
$cls = AuthorPeer::getOMClass();
$obj2 = new $cls();
$obj2->hydrate($row, $startcol2);
AuthorPeer::addInstanceToPool($obj2, $key2);
}
// if obj2 loaded
// Add the $obj1 (Book) to the collection in $obj2 (Author)
$obj2->addBook($obj1);
}
// if joined row not null
$results[] = $obj1;
}
$stmt->closeCursor();
return $results;
}
