/**
* If this collection has already been initialized with
* an identical criteria, it returns the collection.
* Otherwise if this PcTask is new, it will return
* an empty collection; or if this PcTask has previously
* been saved, it will retrieve related PcTasksContextss 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 PcTask.
*/
public function getPcTasksContextssJoinPcUsersContexts($criteria = null, $con = null, $join_behavior = Criteria::LEFT_JOIN)
{
if ($criteria === null) {
$criteria = new Criteria(PcTaskPeer::DATABASE_NAME);
} elseif ($criteria instanceof Criteria) {
$criteria = clone $criteria;
}
if ($this->collPcTasksContextss === null) {
if ($this->isNew()) {
$this->collPcTasksContextss = array();
} else {
$criteria->add(PcTasksContextsPeer::TASK_ID, $this->id);
$this->collPcTasksContextss = PcTasksContextsPeer::doSelectJoinPcUsersContexts($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(PcTasksContextsPeer::TASK_ID, $this->id);
if (!isset($this->lastPcTasksContextsCriteria) || !$this->lastPcTasksContextsCriteria->equals($criteria)) {
$this->collPcTasksContextss = PcTasksContextsPeer::doSelectJoinPcUsersContexts($criteria, $con, $join_behavior);
}
}
$this->lastPcTasksContextsCriteria = $criteria;
return $this->collPcTasksContextss;
}
/**
* 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 = PcTaskPeer::doSelect($criteria, $con);
foreach ($objects as $obj) {
// delete related PcTasksContexts objects
$criteria = new Criteria(PcTasksContextsPeer::DATABASE_NAME);
$criteria->add(PcTasksContextsPeer::TASK_ID, $obj->getId());
$affectedRows += PcTasksContextsPeer::doDelete($criteria, $con);
// delete related PcGoogleCalendarEvent objects
$criteria = new Criteria(PcGoogleCalendarEventPeer::DATABASE_NAME);
$criteria->add(PcGoogleCalendarEventPeer::TASK_ID, $obj->getId());
$affectedRows += PcGoogleCalendarEventPeer::doDelete($criteria, $con);
}
return $affectedRows;
}
/**
* It is called by the save() method.
* It populates the pc_tasks_contexts table.
*
* @return void
*/
public function alignTasksContextsTable()
{
$contexts = $this->getContexts();
// first, let's delete all the pre-existing contexts from this task
$c = new Criteria();
$c->add(PcTasksContextsPeer::TASK_ID, $this->getId());
PcTasksContextsPeer::doDelete($c);
$contexts = $this->getContexts();
$contextIds = PcUtils::explodeWithEmptyInputDetection(',', $contexts);
if (count($contextIds)) {
foreach ($contextIds as $contextId) {
if (is_numeric($contextId)) {
$record = new PcTasksContexts();
$record->setTaskId($this->getId())->setUsersContextsId($contextId)->save();
}
}
}
}
/**
* 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(PcTasksContextsPeer::DATABASE_NAME, Propel::CONNECTION_READ);
}
$objs = null;
if (empty($pks)) {
$objs = array();
} else {
$criteria = new Criteria(PcTasksContextsPeer::DATABASE_NAME);
$criteria->add(PcTasksContextsPeer::ID, $pks, Criteria::IN);
$objs = PcTasksContextsPeer::doSelect($criteria, $con);
}
return $objs;
}
/**
* 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 = PcTasksContextsPeer::getFieldNames($keyType);
if (array_key_exists($keys[0], $arr)) {
$this->setId($arr[$keys[0]]);
}
if (array_key_exists($keys[1], $arr)) {
$this->setTaskId($arr[$keys[1]]);
}
if (array_key_exists($keys[2], $arr)) {
$this->setUsersContextsId($arr[$keys[2]]);
}
}
