/**
* If this collection has already been initialized with
* an identical criteria, it returns the collection.
* Otherwise if this User is new, it will return
* an empty collection; or if this User has previously
* been saved, it will retrieve related ExamComments from storage.
*
* This method is protected by default in order to keep the public
* api reasonable. You can provide public methods for those you
* actually need in User.
*/
public function getExamCommentsJoinExam($criteria = null, $con = null, $join_behavior = Criteria::LEFT_JOIN)
{
if ($criteria === null) {
$criteria = new Criteria(UserPeer::DATABASE_NAME);
} elseif ($criteria instanceof Criteria) {
$criteria = clone $criteria;
}
if ($this->collExamComments === null) {
if ($this->isNew()) {
$this->collExamComments = array();
} else {
$criteria->add(ExamCommentPeer::USER_ID, $this->id);
$this->collExamComments = ExamCommentPeer::doSelectJoinExam($criteria, $con, $join_behavior);
}
} else {
// the following code is to determine if a new query is
// called for. If the criteria is the same as the last
// one, just return the collection.
$criteria->add(ExamCommentPeer::USER_ID, $this->id);
if (!isset($this->lastExamCommentCriteria) || !$this->lastExamCommentCriteria->equals($criteria)) {
$this->collExamComments = ExamCommentPeer::doSelectJoinExam($criteria, $con, $join_behavior);
}
}
$this->lastExamCommentCriteria = $criteria;
return $this->collExamComments;
}
/**
* Selects a collection of ExamCommentDig objects pre-filled with all related objects.
*
* @param Criteria $c
* @param PropelPDO $con
* @param String $join_behavior the type of joins to use, defaults to Criteria::LEFT_JOIN
* @return array Array of ExamCommentDig objects.
* @throws PropelException Any exceptions caught during processing will be
* rethrown wrapped into a PropelException.
*/
public static function doSelectJoinAll(Criteria $c, $con = null, $join_behavior = Criteria::LEFT_JOIN)
{
foreach (sfMixer::getCallables('BaseExamCommentDigPeer:doSelectJoinAll:doSelectJoinAll') as $callable) {
call_user_func($callable, 'BaseExamCommentDigPeer', $c, $con);
}
$c = clone $c;
// Set the correct dbName if it has not been overridden
if ($c->getDbName() == Propel::getDefaultDB()) {
$c->setDbName(self::DATABASE_NAME);
}
ExamCommentDigPeer::addSelectColumns($c);
$startcol2 = ExamCommentDigPeer::NUM_COLUMNS - ExamCommentDigPeer::NUM_LAZY_LOAD_COLUMNS;
ExamCommentPeer::addSelectColumns($c);
$startcol3 = $startcol2 + (ExamCommentPeer::NUM_COLUMNS - ExamCommentPeer::NUM_LAZY_LOAD_COLUMNS);
$c->addJoin(array(ExamCommentDigPeer::COMMENT_ID), array(ExamCommentPeer::ID), $join_behavior);
$stmt = BasePeer::doSelect($c, $con);
$results = array();
while ($row = $stmt->fetch(PDO::FETCH_NUM)) {
$key1 = ExamCommentDigPeer::getPrimaryKeyHashFromRow($row, 0);
if (null !== ($obj1 = ExamCommentDigPeer::getInstanceFromPool($key1))) {
// We no longer rehydrate the object, since this can cause data loss.
// See http://propel.phpdb.org/trac/ticket/509
// $obj1->hydrate($row, 0, true); // rehydrate
} else {
$omClass = ExamCommentDigPeer::getOMClass();
$cls = substr('.' . $omClass, strrpos('.' . $omClass, '.') + 1);
$obj1 = new $cls();
$obj1->hydrate($row);
ExamCommentDigPeer::addInstanceToPool($obj1, $key1);
}
// if obj1 already loaded
// Add objects for joined ExamComment rows
$key2 = ExamCommentPeer::getPrimaryKeyHashFromRow($row, $startcol2);
if ($key2 !== null) {
$obj2 = ExamCommentPeer::getInstanceFromPool($key2);
if (!$obj2) {
$omClass = ExamCommentPeer::getOMClass();
$cls = substr('.' . $omClass, strrpos('.' . $omClass, '.') + 1);
$obj2 = new $cls();
$obj2->hydrate($row, $startcol2);
ExamCommentPeer::addInstanceToPool($obj2, $key2);
}
// if obj2 loaded
// Add the $obj1 (ExamCommentDig) to the collection in $obj2 (ExamComment)
$obj2->addExamCommentDig($obj1);
}
// if joined row not null
$results[] = $obj1;
}
$stmt->closeCursor();
return $results;
}
/**
* 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 PropelPDO $con
* @return int The number of affected rows (if supported by underlying database driver).
*/
protected static function doOnDeleteCascade(Criteria $criteria, PropelPDO $con)
{
// initialize var to track total num of affected rows
$affectedRows = 0;
// first find the objects that are implicated by the $criteria
$objects = ExamPeer::doSelect($criteria, $con);
foreach ($objects as $obj) {
// delete related ExamComment objects
$c = new Criteria(ExamCommentPeer::DATABASE_NAME);
$c->add(ExamCommentPeer::EXAM_ID, $obj->getId());
$affectedRows += ExamCommentPeer::doDelete($c, $con);
}
return $affectedRows;
}
/**
* Populates the object using an array.
*
* This is particularly useful when populating an object from one of the
* request arrays (e.g. $_POST). This method goes through the column
* names, checking to see whether a matching key exists in populated
* array. If so the setByName() method is called for that column.
*
* You can specify the key type of the array by additionally passing one
* of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME,
* BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM.
* The default key type is the column's phpname (e.g. 'AuthorId')
*
* @param array $arr An array to populate the object from.
* @param string $keyType The type of keys the array uses.
* @return void
*/
public function fromArray($arr, $keyType = BasePeer::TYPE_PHPNAME)
{
$keys = ExamCommentPeer::getFieldNames($keyType);
if (array_key_exists($keys[0], $arr)) {
$this->setId($arr[$keys[0]]);
}
if (array_key_exists($keys[1], $arr)) {
$this->setExamId($arr[$keys[1]]);
}
if (array_key_exists($keys[2], $arr)) {
$this->setUserId($arr[$keys[2]]);
}
if (array_key_exists($keys[3], $arr)) {
$this->setComment($arr[$keys[3]]);
}
if (array_key_exists($keys[4], $arr)) {
$this->setInputDt($arr[$keys[4]]);
}
}
/**
* Returns the number of related ExamComment objects.
*
* @param Criteria $criteria
* @param boolean $distinct
* @param PropelPDO $con
* @return int Count of related ExamComment objects.
* @throws PropelException
*/
public function countExamComments(Criteria $criteria = null, $distinct = false, PropelPDO $con = null)
{
if ($criteria === null) {
$criteria = new Criteria(ExamPeer::DATABASE_NAME);
} else {
$criteria = clone $criteria;
}
if ($distinct) {
$criteria->setDistinct();
}
$count = null;
if ($this->collExamComments === null) {
if ($this->isNew()) {
$count = 0;
} else {
$criteria->add(ExamCommentPeer::EXAM_ID, $this->id);
$count = ExamCommentPeer::doCount($criteria, $con);
}
} else {
// criteria has no effect for a new object
if (!$this->isNew()) {
// the following code is to determine if a new query is
// called for. If the criteria is the same as the last
// one, just return count of the collection.
$criteria->add(ExamCommentPeer::EXAM_ID, $this->id);
if (!isset($this->lastExamCommentCriteria) || !$this->lastExamCommentCriteria->equals($criteria)) {
$count = ExamCommentPeer::doCount($criteria, $con);
} else {
$count = count($this->collExamComments);
}
} else {
$count = count($this->collExamComments);
}
}
return $count;
}
/**
* Retrieve multiple objects by pkey.
*
* @param array $pks List of primary keys
* @param PropelPDO $con the connection to use
* @throws PropelException Any exceptions caught during processing will be
* rethrown wrapped into a PropelException.
*/
public static function retrieveByPKs($pks, PropelPDO $con = null)
{
if ($con === null) {
$con = Propel::getConnection(ExamCommentPeer::DATABASE_NAME, Propel::CONNECTION_READ);
}
$objs = null;
if (empty($pks)) {
$objs = array();
} else {
$criteria = new Criteria(ExamCommentPeer::DATABASE_NAME);
$criteria->add(ExamCommentPeer::ID, $pks, Criteria::IN);
$objs = ExamCommentPeer::doSelect($criteria, $con);
}
return $objs;
}
/**
* Get the associated ExamComment object
*
* @param PropelPDO Optional Connection object.
* @return ExamComment The associated ExamComment object.
* @throws PropelException
*/
public function getExamComment(PropelPDO $con = null)
{
if ($this->aExamComment === null && $this->comment_id !== null) {
$c = new Criteria(ExamCommentPeer::DATABASE_NAME);
$c->add(ExamCommentPeer::ID, $this->comment_id);
$this->aExamComment = ExamCommentPeer::doSelectOne($c, $con);
/* The following can be used additionally to
guarantee the related object contains a reference
to this object. This level of coupling may, however, be
undesirable since it could result in an only partially populated collection
in the referenced object.
$this->aExamComment->addExamCommentDigs($this);
*/
}
return $this->aExamComment;
}
