/**
* Retrieve a single object by pkey.
*
* @param int $pk the primary key.
* @param PropelPDO $con the connection to use
* @return Site
*/
public static function retrieveByPK($pk, PropelPDO $con = null)
{
if (null !== ($obj = SitePeer::getInstanceFromPool((string) $pk))) {
return $obj;
}
if ($con === null) {
$con = Propel::getConnection(SitePeer::DATABASE_NAME, Propel::CONNECTION_READ);
}
$criteria = new Criteria(SitePeer::DATABASE_NAME);
$criteria->add(SitePeer::ID, $pk);
$v = SitePeer::doSelect($criteria, $con);
return !empty($v) > 0 ? $v[0] : null;
}
/**
* Selects a collection of Environment 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 Environment 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(EnvironmentPeer::DATABASE_NAME);
}
EnvironmentPeer::addSelectColumns($criteria);
$startcol2 = EnvironmentPeer::NUM_HYDRATE_COLUMNS;
SitePeer::addSelectColumns($criteria);
$startcol3 = $startcol2 + SitePeer::NUM_HYDRATE_COLUMNS;
$criteria->addJoin(EnvironmentPeer::SITEID, SitePeer::ID, $join_behavior);
$stmt = BasePeer::doSelect($criteria, $con);
$results = array();
while ($row = $stmt->fetch(PDO::FETCH_NUM)) {
$key1 = EnvironmentPeer::getPrimaryKeyHashFromRow($row, 0);
if (null !== ($obj1 = EnvironmentPeer::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 = EnvironmentPeer::getOMClass();
$obj1 = new $cls();
$obj1->hydrate($row);
EnvironmentPeer::addInstanceToPool($obj1, $key1);
}
// if obj1 already loaded
// Add objects for joined Site rows
$key2 = SitePeer::getPrimaryKeyHashFromRow($row, $startcol2);
if ($key2 !== null) {
$obj2 = SitePeer::getInstanceFromPool($key2);
if (!$obj2) {
$cls = SitePeer::getOMClass();
$obj2 = new $cls();
$obj2->hydrate($row, $startcol2);
SitePeer::addInstanceToPool($obj2, $key2);
}
// if obj2 loaded
// Add the $obj1 (Environment) to the collection in $obj2 (Site)
$obj2->addEnvironment($obj1);
}
// if joined row 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 Site|Site[]|mixed the result, formatted by the current formatter
*/
public function findPk($key, $con = null)
{
if ($key === null) {
return null;
}
if (null !== ($obj = SitePeer::getInstanceFromPool((string) $key)) && !$this->formatter) {
// the object is already in the instance pool
return $obj;
}
if ($con === null) {
$con = Propel::getConnection(SitePeer::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);
}
}