/**
* Get the associated Area object
*
* @param PropelPDO $con Optional Connection object.
* @param $doQuery Executes a query to get the object if required
* @return Area The associated Area object.
* @throws PropelException
*/
public function getArea(PropelPDO $con = null, $doQuery = true)
{
if ($this->aArea === null && $this->area_id !== null && $doQuery) {
$this->aArea = AreaQuery::create()->findPk($this->area_id, $con);
/* The following can be used additionally to
guarantee the related object contains a reference
to this object. This level of coupling may, however, be
undesirable since it could result in an only partially populated collection
in the referenced object.
$this->aArea->addAreaAssignments($this);
*/
}
return $this->aArea;
}
/**
* If this collection has already been initialized with
* an identical criteria, it returns the collection.
* Otherwise if this State is new, it will return
* an empty collection; or if this State has previously
* been saved, it will retrieve related Areas 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 State.
*
* @param Criteria $criteria optional Criteria object to narrow the query
* @param PropelPDO $con optional connection object
* @param string $join_behavior optional join type to use (defaults to Criteria::LEFT_JOIN)
* @return PropelObjectCollection|Area[] List of Area objects
*/
public function getAreasJoinCity($criteria = null, $con = null, $join_behavior = Criteria::LEFT_JOIN)
{
$query = AreaQuery::create(null, $criteria);
$query->joinWith('City', $join_behavior);
return $this->getAreas($query, $con);
}
/**
* Removes this object from datastore and sets delete attribute.
*
* @param PropelPDO $con
* @return void
* @throws PropelException
* @throws Exception
* @see BaseObject::setDeleted()
* @see BaseObject::isDeleted()
*/
public function delete(PropelPDO $con = null)
{
if ($this->isDeleted()) {
throw new PropelException("This object has already been deleted.");
}
if ($con === null) {
$con = Propel::getConnection(AreaPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);
}
$con->beginTransaction();
try {
EventDispatcherProxy::trigger(array('delete.pre', 'model.delete.pre'), new ModelEvent($this));
$deleteQuery = AreaQuery::create()->filterByPrimaryKey($this->getPrimaryKey());
$ret = $this->preDelete($con);
if ($ret) {
$deleteQuery->delete($con);
$this->postDelete($con);
// event behavior
EventDispatcherProxy::trigger(array('delete.post', 'model.delete.post'), new ModelEvent($this));
$con->commit();
$this->setDeleted(true);
} else {
$con->commit();
}
} catch (Exception $e) {
$con->rollBack();
throw $e;
}
}