/**
* Performs a DELETE on the database, given a TagInstance or Criteria object OR a primary key value.
*
* @param mixed $values Criteria or TagInstance object or primary key or array of primary keys
* which is used to create the DELETE statement
* @param PropelPDO $con the connection to use
* @return int The number of affected rows (if supported by underlying database driver). This includes CASCADE-related rows
* if supported by native driver or if emulated using Propel.
* @throws PropelException Any exceptions caught during processing will be
* rethrown wrapped into a PropelException.
*/
public static function doDelete($values, PropelPDO $con = null)
{
if ($con === null) {
$con = Propel::getConnection(TagInstancePeer::DATABASE_NAME, Propel::CONNECTION_WRITE);
}
if ($values instanceof Criteria) {
// invalidate the cache for all objects of this type, since we have no
// way of knowing (without running a query) what objects should be invalidated
// from the cache based on this Criteria.
TagInstancePeer::clearInstancePool();
// rename for clarity
$criteria = clone $values;
} elseif ($values instanceof TagInstance) {
// it's a model object
// invalidate the cache for this single object
TagInstancePeer::removeInstanceFromPool($values);
// create criteria based on pk values
$criteria = $values->buildPkeyCriteria();
} else {
// it's a primary key, or an array of pks
$criteria = new Criteria(TagInstancePeer::DATABASE_NAME);
// primary key is composite; we therefore, expect
// the primary key passed to be an array of pkey values
if (count($values) == count($values, COUNT_RECURSIVE)) {
// array is not multi-dimensional
$values = array($values);
}
foreach ($values as $value) {
$criterion = $criteria->getNewCriterion(TagInstancePeer::TAG_ID, $value[0]);
$criterion->addAnd($criteria->getNewCriterion(TagInstancePeer::TAGGED_ITEM_ID, $value[1]));
$criterion->addAnd($criteria->getNewCriterion(TagInstancePeer::MODEL_NAME, $value[2]));
$criteria->addOr($criterion);
// we can invalidate the cache for this single PK
TagInstancePeer::removeInstanceFromPool($value);
}
}
// Set the correct dbName
$criteria->setDbName(TagInstancePeer::DATABASE_NAME);
$affectedRows = 0;
// initialize var to track total num of affected rows
try {
// use transaction because $criteria could contain info
// for more than one table or we could emulating ON DELETE CASCADE, etc.
$con->beginTransaction();
$affectedRows += BasePeer::doDelete($criteria, $con);
TagInstancePeer::clearRelatedInstancePool();
$con->commit();
return $affectedRows;
} catch (Exception $e) {
$con->rollBack();
throw $e;
}
}