/**
* Performs an INSERT on the database, given a PurchaseHistory or Criteria object.
*
* @param mixed $criteria Criteria or PurchaseHistory object containing data that is used to create the INSERT statement.
* @param ConnectionInterface $con the ConnectionInterface connection to use
* @return mixed The new primary key.
* @throws PropelException Any exceptions caught during processing will be
* rethrown wrapped into a PropelException.
*/
public static function doInsert($criteria, ConnectionInterface $con = null)
{
if (null === $con) {
$con = Propel::getServiceContainer()->getWriteConnection(PurchaseHistoryTableMap::DATABASE_NAME);
}
if ($criteria instanceof Criteria) {
$criteria = clone $criteria;
// rename for clarity
} else {
$criteria = $criteria->buildCriteria();
// build Criteria from PurchaseHistory object
}
if ($criteria->containsKey(PurchaseHistoryTableMap::COL_ID) && $criteria->keyContainsValue(PurchaseHistoryTableMap::COL_ID)) {
throw new PropelException('Cannot insert a value for auto-increment primary key (' . PurchaseHistoryTableMap::COL_ID . ')');
}
// Set the correct dbName
$query = PurchaseHistoryQuery::create()->mergeWith($criteria);
// use transaction because $criteria could contain info
// for more than one table (I guess, conceivably)
return $con->transaction(function () use($con, $query) {
return $query->doInsert($con);
});
}
/**
* If this collection has already been initialized with
* an identical criteria, it returns the collection.
* Otherwise if this UserDetail is new, it will return
* an empty collection; or if this UserDetail has previously
* been saved, it will retrieve related PurchaseHistories 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 UserDetail.
*
* @param Criteria $criteria optional Criteria object to narrow the query
* @param ConnectionInterface $con optional connection object
* @param string $joinBehavior optional join type to use (defaults to Criteria::LEFT_JOIN)
* @return ObjectCollection|ChildPurchaseHistory[] List of ChildPurchaseHistory objects
*/
public function getPurchaseHistoriesJoinPurchase(Criteria $criteria = null, ConnectionInterface $con = null, $joinBehavior = Criteria::LEFT_JOIN)
{
$query = ChildPurchaseHistoryQuery::create(null, $criteria);
$query->joinWith('Purchase', $joinBehavior);
return $this->getPurchaseHistories($query, $con);
}
/**
* Removes this object from datastore and sets delete attribute.
*
* @param ConnectionInterface $con
* @return void
* @throws PropelException
* @see PurchaseHistory::setDeleted()
* @see PurchaseHistory::isDeleted()
*/
public function delete(ConnectionInterface $con = null)
{
if ($this->isDeleted()) {
throw new PropelException("This object has already been deleted.");
}
if ($con === null) {
$con = Propel::getServiceContainer()->getWriteConnection(PurchaseHistoryTableMap::DATABASE_NAME);
}
$con->transaction(function () use($con) {
$deleteQuery = ChildPurchaseHistoryQuery::create()->filterByPrimaryKey($this->getPrimaryKey());
$ret = $this->preDelete($con);
if ($ret) {
$deleteQuery->delete($con);
$this->postDelete($con);
$this->setDeleted(true);
}
});
}