/**
* Retrieve a single object by pkey.
*
* @param int $pk the primary key.
* @param PropelPDO $con the connection to use
* @return Document
*/
public static function retrieveByPK($pk, PropelPDO $con = null)
{
if (null !== ($obj = DocumentPeer::getInstanceFromPool((string) $pk))) {
return $obj;
}
if ($con === null) {
$con = Propel::getConnection(DocumentPeer::DATABASE_NAME, Propel::CONNECTION_READ);
}
$criteria = new Criteria(DocumentPeer::DATABASE_NAME);
$criteria->add(DocumentPeer::ID, $pk);
$v = DocumentPeer::doSelect($criteria, $con);
return !empty($v) > 0 ? $v[0] : null;
}
/**
* Selects a collection of DocumentationPart objects pre-filled with all related objects except UserRelatedByUpdatedBy.
*
* @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 DocumentationPart objects.
* @throws PropelException Any exceptions caught during processing will be
* rethrown wrapped into a PropelException.
*/
public static function doSelectJoinAllExceptUserRelatedByUpdatedBy(Criteria $criteria, $con = null, $join_behavior = Criteria::LEFT_JOIN)
{
$criteria = clone $criteria;
// Set the correct dbName if it has not been overridden
// $criteria->getDbName() will return the same object if not set to another value
// so == check is okay and faster
if ($criteria->getDbName() == Propel::getDefaultDB()) {
$criteria->setDbName(DocumentationPartPeer::DATABASE_NAME);
}
DocumentationPartPeer::addSelectColumns($criteria);
$startcol2 = DocumentationPartPeer::NUM_HYDRATE_COLUMNS;
LanguagePeer::addSelectColumns($criteria);
$startcol3 = $startcol2 + LanguagePeer::NUM_HYDRATE_COLUMNS;
DocumentationPeer::addSelectColumns($criteria);
$startcol4 = $startcol3 + DocumentationPeer::NUM_HYDRATE_COLUMNS;
DocumentPeer::addSelectColumns($criteria);
$startcol5 = $startcol4 + DocumentPeer::NUM_HYDRATE_COLUMNS;
$criteria->addJoin(DocumentationPartPeer::LANGUAGE_ID, LanguagePeer::ID, $join_behavior);
$criteria->addJoin(DocumentationPartPeer::DOCUMENTATION_ID, DocumentationPeer::ID, $join_behavior);
$criteria->addJoin(DocumentationPartPeer::IMAGE_ID, DocumentPeer::ID, $join_behavior);
$stmt = BasePeer::doSelect($criteria, $con);
$results = array();
while ($row = $stmt->fetch(PDO::FETCH_NUM)) {
$key1 = DocumentationPartPeer::getPrimaryKeyHashFromRow($row, 0);
if (null !== ($obj1 = DocumentationPartPeer::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 = DocumentationPartPeer::getOMClass();
$obj1 = new $cls();
$obj1->hydrate($row);
DocumentationPartPeer::addInstanceToPool($obj1, $key1);
}
// if obj1 already loaded
// Add objects for joined Language rows
$key2 = LanguagePeer::getPrimaryKeyHashFromRow($row, $startcol2);
if ($key2 !== null) {
$obj2 = LanguagePeer::getInstanceFromPool($key2);
if (!$obj2) {
$cls = LanguagePeer::getOMClass();
$obj2 = new $cls();
$obj2->hydrate($row, $startcol2);
LanguagePeer::addInstanceToPool($obj2, $key2);
}
// if $obj2 already loaded
// Add the $obj1 (DocumentationPart) to the collection in $obj2 (Language)
$obj2->addDocumentationPart($obj1);
}
// if joined row is not null
// Add objects for joined Documentation rows
$key3 = DocumentationPeer::getPrimaryKeyHashFromRow($row, $startcol3);
if ($key3 !== null) {
$obj3 = DocumentationPeer::getInstanceFromPool($key3);
if (!$obj3) {
$cls = DocumentationPeer::getOMClass();
$obj3 = new $cls();
$obj3->hydrate($row, $startcol3);
DocumentationPeer::addInstanceToPool($obj3, $key3);
}
// if $obj3 already loaded
// Add the $obj1 (DocumentationPart) to the collection in $obj3 (Documentation)
$obj3->addDocumentationPart($obj1);
}
// if joined row is not null
// Add objects for joined Document rows
$key4 = DocumentPeer::getPrimaryKeyHashFromRow($row, $startcol4);
if ($key4 !== null) {
$obj4 = DocumentPeer::getInstanceFromPool($key4);
if (!$obj4) {
$cls = DocumentPeer::getOMClass();
$obj4 = new $cls();
$obj4->hydrate($row, $startcol4);
DocumentPeer::addInstanceToPool($obj4, $key4);
}
// if $obj4 already loaded
// Add the $obj1 (DocumentationPart) to the collection in $obj4 (Document)
$obj4->addDocumentationPart($obj1);
}
// if joined row is not null
$results[] = $obj1;
}
$stmt->closeCursor();
return $results;
}
/**
* 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 Document|Document[]|mixed the result, formatted by the current formatter
*/
public function findPk($key, $con = null)
{
if ($key === null) {
return null;
}
if (null !== ($obj = DocumentPeer::getInstanceFromPool((string) $key)) && !$this->formatter) {
// the object is already in the instance pool
return $obj;
}
if ($con === null) {
$con = Propel::getConnection(DocumentPeer::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);
}
}
/**
* Find object by primary key
* Use instance pooling to avoid a database query if the object exists
* <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 Document|array|mixed the result, formatted by the current formatter
*/
public function findPk($key, $con = null)
{
if (null !== ($obj = DocumentPeer::getInstanceFromPool((string) $key)) && $this->getFormatter()->isObjectFormatter()) {
// the object is alredy in the instance pool
return $obj;
} else {
// the object has not been requested yet, or the formatter is not an object formatter
$criteria = $this->isKeepQuery() ? clone $this : $this;
$stmt = $criteria->filterByPrimaryKey($key)->getSelectStatement($con);
return $criteria->getFormatter()->init($criteria)->formatOne($stmt);
}
}