/**
  * 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(BranchCoveragePeer::DATABASE_NAME, Propel::CONNECTION_WRITE);
     }
     $con->beginTransaction();
     $isInsert = $this->isNew();
     try {
         $ret = $this->preSave($con);
         // event behavior
         EventDispatcherProxy::trigger('model.save.pre', new ModelEvent($this));
         if ($isInsert) {
             $ret = $ret && $this->preInsert($con);
             // event behavior
             EventDispatcherProxy::trigger('model.insert.pre', new ModelEvent($this));
         } else {
             $ret = $ret && $this->preUpdate($con);
             // event behavior
             EventDispatcherProxy::trigger(array('update.pre', 'model.update.pre'), new ModelEvent($this));
         }
         if ($ret) {
             $affectedRows = $this->doSave($con);
             if ($isInsert) {
                 $this->postInsert($con);
                 // event behavior
                 EventDispatcherProxy::trigger('model.insert.post', new ModelEvent($this));
             } else {
                 $this->postUpdate($con);
                 // event behavior
                 EventDispatcherProxy::trigger(array('update.post', 'model.update.post'), new ModelEvent($this));
             }
             $this->postSave($con);
             // event behavior
             EventDispatcherProxy::trigger('model.save.post', new ModelEvent($this));
             BranchCoveragePeer::addInstanceToPool($this);
         } else {
             $affectedRows = 0;
         }
         $con->commit();
         return $affectedRows;
     } catch (Exception $e) {
         $con->rollBack();
         throw $e;
     }
 }
 /**
  * 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                 BranchCoverage A model object, or null if the key is not found
  * @throws PropelException
  */
 protected function findPkSimple($key, $con)
 {
     $sql = 'SELECT `id`, `code`, `name`, `state_id`, `region_id`, `city_id` FROM `branch_coverage` 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)) {
         $cls = BranchCoveragePeer::getOMClass();
         $obj = new $cls();
         $obj->hydrate($row);
         BranchCoveragePeer::addInstanceToPool($obj, (string) $key);
     }
     $stmt->closeCursor();
     return $obj;
 }
 /**
  * Selects a collection of BranchCoverage objects pre-filled with all related objects except City.
  *
  * @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 BranchCoverage objects.
  * @throws PropelException Any exceptions caught during processing will be
  *		 rethrown wrapped into a PropelException.
  */
 public static function doSelectJoinAllExceptCity(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(BranchCoveragePeer::DATABASE_NAME);
     }
     BranchCoveragePeer::addSelectColumns($criteria);
     $startcol2 = BranchCoveragePeer::NUM_HYDRATE_COLUMNS;
     StatePeer::addSelectColumns($criteria);
     $startcol3 = $startcol2 + StatePeer::NUM_HYDRATE_COLUMNS;
     RegionPeer::addSelectColumns($criteria);
     $startcol4 = $startcol3 + RegionPeer::NUM_HYDRATE_COLUMNS;
     $criteria->addJoin(BranchCoveragePeer::STATE_ID, StatePeer::ID, $join_behavior);
     $criteria->addJoin(BranchCoveragePeer::REGION_ID, RegionPeer::ID, $join_behavior);
     $stmt = BasePeer::doSelect($criteria, $con);
     $results = array();
     while ($row = $stmt->fetch(PDO::FETCH_NUM)) {
         $key1 = BranchCoveragePeer::getPrimaryKeyHashFromRow($row, 0);
         if (null !== ($obj1 = BranchCoveragePeer::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 = BranchCoveragePeer::getOMClass();
             $obj1 = new $cls();
             $obj1->hydrate($row);
             BranchCoveragePeer::addInstanceToPool($obj1, $key1);
         }
         // if obj1 already loaded
         // Add objects for joined State rows
         $key2 = StatePeer::getPrimaryKeyHashFromRow($row, $startcol2);
         if ($key2 !== null) {
             $obj2 = StatePeer::getInstanceFromPool($key2);
             if (!$obj2) {
                 $cls = StatePeer::getOMClass();
                 $obj2 = new $cls();
                 $obj2->hydrate($row, $startcol2);
                 StatePeer::addInstanceToPool($obj2, $key2);
             }
             // if $obj2 already loaded
             // Add the $obj1 (BranchCoverage) to the collection in $obj2 (State)
             $obj2->addBranchCoverage($obj1);
         }
         // if joined row is not null
         // Add objects for joined Region rows
         $key3 = RegionPeer::getPrimaryKeyHashFromRow($row, $startcol3);
         if ($key3 !== null) {
             $obj3 = RegionPeer::getInstanceFromPool($key3);
             if (!$obj3) {
                 $cls = RegionPeer::getOMClass();
                 $obj3 = new $cls();
                 $obj3->hydrate($row, $startcol3);
                 RegionPeer::addInstanceToPool($obj3, $key3);
             }
             // if $obj3 already loaded
             // Add the $obj1 (BranchCoverage) to the collection in $obj3 (Region)
             $obj3->addBranchCoverage($obj1);
         }
         // if joined row is not null
         $results[] = $obj1;
     }
     $stmt->closeCursor();
     return $results;
 }