/**
* Performs a DELETE on the database, given a Canon or Criteria object OR a primary key value.
*
* @param mixed $values Criteria or Canon object or primary key or array of primary keys
* which is used to create the DELETE statement
* @param ConnectionInterface $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, ConnectionInterface $con = null)
{
if (null === $con) {
$con = Propel::getServiceContainer()->getWriteConnection(CanonTableMap::DATABASE_NAME);
}
if ($values instanceof Criteria) {
// rename for clarity
$criteria = $values;
} elseif ($values instanceof \SpoilerWiki\Canon) {
// it's a model object
// create criteria based on pk values
$criteria = $values->buildPkeyCriteria();
} else {
// it's a primary key, or an array of pks
$criteria = new Criteria(CanonTableMap::DATABASE_NAME);
$criteria->add(CanonTableMap::COL_ID, (array) $values, Criteria::IN);
}
$query = CanonQuery::create()->mergeWith($criteria);
if ($values instanceof Criteria) {
CanonTableMap::clearInstancePool();
} elseif (!is_object($values)) {
// it's a primary key, or an array of pks
foreach ((array) $values as $singleval) {
CanonTableMap::removeInstanceFromPool($singleval);
}
}
return $query->delete($con);
}
/**
* Deletes all rows from the canon table.
*
* @param ConnectionInterface $con the connection to use
* @return int The number of affected rows (if supported by underlying database driver).
*/
public function doDeleteAll(ConnectionInterface $con = null)
{
if (null === $con) {
$con = Propel::getServiceContainer()->getWriteConnection(CanonTableMap::DATABASE_NAME);
}
// use transaction because $criteria could contain info
// for more than one table or we could emulating ON DELETE CASCADE, etc.
return $con->transaction(function () use($con) {
$affectedRows = 0;
// initialize var to track total num of affected rows
$affectedRows += parent::doDeleteAll($con);
// Because this db requires some delete cascade/set null emulation, we have to
// clear the cached instance *after* the emulation has happened (since
// instances get re-added by the select statement contained therein).
CanonTableMap::clearInstancePool();
CanonTableMap::clearRelatedInstancePool();
return $affectedRows;
});
}