/**
* Persists this object to the database.
*
* If the object is new, it inserts it; otherwise an update is performed.
* All modified related objects will also be persisted in the doSave()
* method. This method wraps all precipitate database operations in a
* single transaction.
*
* @param PropelPDO $con
* @return int The number of rows affected by this insert/update and any referring fk objects' save() operations.
* @throws PropelException
* @see doSave()
*/
public function save(PropelPDO $con = null)
{
if ($this->isDeleted()) {
throw new PropelException("You cannot save an object that has been deleted.");
}
if ($con === null) {
$con = Propel::getConnection(TagPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);
}
$con->beginTransaction();
$isInsert = $this->isNew();
try {
$ret = $this->preSave($con);
if ($isInsert) {
$ret = $ret && $this->preInsert($con);
} else {
$ret = $ret && $this->preUpdate($con);
}
if ($ret) {
$affectedRows = $this->doSave($con);
if ($isInsert) {
$this->postInsert($con);
} else {
$this->postUpdate($con);
}
$this->postSave($con);
TagPeer::addInstanceToPool($this);
} else {
$affectedRows = 0;
}
$con->commit();
return $affectedRows;
} catch (PropelException $e) {
$con->rollBack();
throw $e;
}
}
/**
* Persists this object to the database.
*
* If the object is new, it inserts it; otherwise an update is performed.
* All modified related objects will also be persisted in the doSave()
* method. This method wraps all precipitate database operations in a
* single transaction.
*
* @param PropelPDO $con
* @return int The number of rows affected by this insert/update and any referring fk objects' save() operations.
* @throws PropelException
* @see doSave()
*/
public function save(PropelPDO $con = null)
{
foreach (sfMixer::getCallables('BaseTag:save:pre') as $callable) {
$affectedRows = call_user_func($callable, $this, $con);
if (is_int($affectedRows)) {
return $affectedRows;
}
}
if ($this->isDeleted()) {
throw new PropelException("You cannot save an object that has been deleted.");
}
if ($con === null) {
$con = Propel::getConnection(TagPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);
}
$con->beginTransaction();
try {
$affectedRows = $this->doSave($con);
$con->commit();
foreach (sfMixer::getCallables('BaseTag:save:post') as $callable) {
call_user_func($callable, $this, $con, $affectedRows);
}
TagPeer::addInstanceToPool($this);
return $affectedRows;
} catch (PropelException $e) {
$con->rollBack();
throw $e;
}
}
/**
* Selects a collection of TagInstance 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 TagInstance 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(TagInstancePeer::DATABASE_NAME);
}
TagInstancePeer::addSelectColumns($criteria);
$startcol2 = TagInstancePeer::NUM_HYDRATE_COLUMNS;
TagPeer::addSelectColumns($criteria);
$startcol3 = $startcol2 + TagPeer::NUM_HYDRATE_COLUMNS;
$criteria->addJoin(TagInstancePeer::TAG_ID, TagPeer::ID, $join_behavior);
$stmt = BasePeer::doSelect($criteria, $con);
$results = array();
while ($row = $stmt->fetch(PDO::FETCH_NUM)) {
$key1 = TagInstancePeer::getPrimaryKeyHashFromRow($row, 0);
if (null !== ($obj1 = TagInstancePeer::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 = TagInstancePeer::getOMClass();
$obj1 = new $cls();
$obj1->hydrate($row);
TagInstancePeer::addInstanceToPool($obj1, $key1);
}
// if obj1 already loaded
// Add objects for joined Tag rows
$key2 = TagPeer::getPrimaryKeyHashFromRow($row, $startcol2);
if ($key2 !== null) {
$obj2 = TagPeer::getInstanceFromPool($key2);
if (!$obj2) {
$cls = TagPeer::getOMClass();
$obj2 = new $cls();
$obj2->hydrate($row, $startcol2);
TagPeer::addInstanceToPool($obj2, $key2);
}
// if $obj2 already loaded
// Add the $obj1 (TagInstance) to the collection in $obj2 (Tag)
$obj2->addTagInstance($obj1);
}
// if joined row is not null
$results[] = $obj1;
}
$stmt->closeCursor();
return $results;
}
/**
* Selects a collection of Tagging 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 Tagging 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('BaseTaggingPeer:doSelectJoinAll:doSelectJoinAll') as $callable) {
call_user_func($callable, 'BaseTaggingPeer', $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);
}
TaggingPeer::addSelectColumns($c);
$startcol2 = TaggingPeer::NUM_COLUMNS - TaggingPeer::NUM_LAZY_LOAD_COLUMNS;
TagPeer::addSelectColumns($c);
$startcol3 = $startcol2 + (TagPeer::NUM_COLUMNS - TagPeer::NUM_LAZY_LOAD_COLUMNS);
$c->addJoin(array(TaggingPeer::TAG_ID), array(TagPeer::ID), $join_behavior);
$stmt = BasePeer::doSelect($c, $con);
$results = array();
while ($row = $stmt->fetch(PDO::FETCH_NUM)) {
$key1 = TaggingPeer::getPrimaryKeyHashFromRow($row, 0);
if (null !== ($obj1 = TaggingPeer::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 = TaggingPeer::getOMClass();
$cls = substr('.' . $omClass, strrpos('.' . $omClass, '.') + 1);
$obj1 = new $cls();
$obj1->hydrate($row);
TaggingPeer::addInstanceToPool($obj1, $key1);
}
// if obj1 already loaded
// Add objects for joined Tag rows
$key2 = TagPeer::getPrimaryKeyHashFromRow($row, $startcol2);
if ($key2 !== null) {
$obj2 = TagPeer::getInstanceFromPool($key2);
if (!$obj2) {
$omClass = TagPeer::getOMClass();
$cls = substr('.' . $omClass, strrpos('.' . $omClass, '.') + 1);
$obj2 = new $cls();
$obj2->hydrate($row, $startcol2);
TagPeer::addInstanceToPool($obj2, $key2);
}
// if obj2 loaded
// Add the $obj1 (Tagging) to the collection in $obj2 (Tag)
$obj2->addTagging($obj1);
}
// if joined row not null
$results[] = $obj1;
}
$stmt->closeCursor();
return $results;
}
/**
* Persists this object to the database.
*
* If the object is new, it inserts it; otherwise an update is performed.
* All modified related objects will also be persisted in the doSave()
* method. This method wraps all precipitate database operations in a
* single transaction.
*
* @param PropelPDO $con
* @return int The number of rows affected by this insert/update and any referring fk objects' save() operations.
* @throws PropelException
* @throws Exception
* @see doSave()
*/
public function save(PropelPDO $con = null)
{
if ($this->isDeleted()) {
throw new PropelException("You cannot save an object that has been deleted.");
}
if ($con === null) {
$con = Propel::getConnection(TagPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);
}
$con->beginTransaction();
$isInsert = $this->isNew();
try {
$ret = $this->preSave($con);
if ($isInsert) {
$ret = $ret && $this->preInsert($con);
// denyable behavior
if (!(TagPeer::isIgnoringRights() || $this->mayOperate("insert"))) {
throw new PropelException(new NotPermittedException("insert.custom", array("role_key" => "tags")));
}
// extended_timestampable behavior
if (!$this->isColumnModified(TagPeer::CREATED_AT)) {
$this->setCreatedAt(time());
}
if (!$this->isColumnModified(TagPeer::UPDATED_AT)) {
$this->setUpdatedAt(time());
}
// attributable behavior
if (Session::getSession()->isAuthenticated()) {
if (!$this->isColumnModified(TagPeer::CREATED_BY)) {
$this->setCreatedBy(Session::getSession()->getUser()->getId());
}
if (!$this->isColumnModified(TagPeer::UPDATED_BY)) {
$this->setUpdatedBy(Session::getSession()->getUser()->getId());
}
}
} else {
$ret = $ret && $this->preUpdate($con);
// denyable behavior
if (!(TagPeer::isIgnoringRights() || $this->mayOperate("update"))) {
throw new PropelException(new NotPermittedException("update.custom", array("role_key" => "tags")));
}
// extended_timestampable behavior
if ($this->isModified() && !$this->isColumnModified(TagPeer::UPDATED_AT)) {
$this->setUpdatedAt(time());
}
// attributable behavior
if (Session::getSession()->isAuthenticated()) {
if ($this->isModified() && !$this->isColumnModified(TagPeer::UPDATED_BY)) {
$this->setUpdatedBy(Session::getSession()->getUser()->getId());
}
}
}
if ($ret) {
$affectedRows = $this->doSave($con);
if ($isInsert) {
$this->postInsert($con);
} else {
$this->postUpdate($con);
}
$this->postSave($con);
TagPeer::addInstanceToPool($this);
} else {
$affectedRows = 0;
}
$con->commit();
return $affectedRows;
} catch (Exception $e) {
$con->rollBack();
throw $e;
}
}
/**
* Adds the supplied object array to the instance pool.
*
* @param array $queryResult The array of objects to add to pool.
*/
public static function addInstancesToPool($queryResult)
{
if (Propel::isInstancePoolingEnabled()) {
if (count(self::$instances) + count($queryResult) <= kConf::get('max_num_instances_in_pool')) {
foreach ($queryResult as $curResult) {
TagPeer::addInstanceToPool($curResult);
}
}
}
}
/**
* Find object by primary key using raw SQL to go fast.
* Bypass doSelect() and the object formatter by using generated code.
*
* @param mixed $key Primary key to use for the query
* @param PropelPDO $con A connection object
*
* @return Tag A model object, or null if the key is not found
* @throws PropelException
*/
protected function findPkSimple($key, $con)
{
$sql = 'SELECT `id`, `name`, `created_at`, `updated_at`, `created_by`, `updated_by` FROM `tags` WHERE `id` = :p0';
try {
$stmt = $con->prepare($sql);
$stmt->bindValue(':p0', $key, PDO::PARAM_INT);
$stmt->execute();
} catch (Exception $e) {
Propel::log($e->getMessage(), Propel::LOG_ERR);
throw new PropelException(sprintf('Unable to execute SELECT statement [%s]', $sql), $e);
}
$obj = null;
if ($row = $stmt->fetch(PDO::FETCH_NUM)) {
$obj = new Tag();
$obj->hydrate($row);
TagPeer::addInstanceToPool($obj, (string) $key);
}
$stmt->closeCursor();
return $obj;
}
/**
* Adds the supplied object array to the instance pool.
*
* @param array $queryResult The array of objects to add to pool.
*/
public static function addInstancesToPool($queryResult)
{
foreach ($queryResult as $curResult) {
TagPeer::addInstanceToPool($curResult);
}
}
/**
* The returned array will contain objects of the default type or
* objects that inherit from the default.
*
* @throws PropelException Any exceptions caught during processing will be
* rethrown wrapped into a PropelException.
*/
public static function populateObjects(PDOStatement $stmt)
{
$results = array();
// set the class once to avoid overhead in the loop
$cls = TagPeer::getOMClass();
$cls = substr('.' . $cls, strrpos('.' . $cls, '.') + 1);
// populate the object(s)
while ($row = $stmt->fetch(PDO::FETCH_NUM)) {
$key = TagPeer::getPrimaryKeyHashFromRow($row, 0);
if (null !== ($obj = TagPeer::getInstanceFromPool($key))) {
// We no longer rehydrate the object, since this can cause data loss.
// See http://propel.phpdb.org/trac/ticket/509
// $obj->hydrate($row, 0, true); // rehydrate
$results[] = $obj;
} else {
$obj = new $cls();
$obj->hydrate($row);
$results[] = $obj;
TagPeer::addInstanceToPool($obj, $key);
}
// if key exists
}
$stmt->closeCursor();
return $results;
}