/**
  * 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(JournalEntryImagePeer::DATABASE_NAME, Propel::CONNECTION_WRITE);
     }
     $con->beginTransaction();
     $isInsert = $this->isNew();
     try {
         $ret = $this->preSave($con);
         if ($isInsert) {
             $ret = $ret && $this->preInsert($con);
             // extended_timestampable behavior
             if (!$this->isColumnModified(JournalEntryImagePeer::CREATED_AT)) {
                 $this->setCreatedAt(time());
             }
             if (!$this->isColumnModified(JournalEntryImagePeer::UPDATED_AT)) {
                 $this->setUpdatedAt(time());
             }
             // attributable behavior
             if (Session::getSession()->isAuthenticated()) {
                 if (!$this->isColumnModified(JournalEntryImagePeer::CREATED_BY)) {
                     $this->setCreatedBy(Session::getSession()->getUser()->getId());
                 }
                 if (!$this->isColumnModified(JournalEntryImagePeer::UPDATED_BY)) {
                     $this->setUpdatedBy(Session::getSession()->getUser()->getId());
                 }
             }
             // denyable behavior
             if (!(JournalEntryImagePeer::isIgnoringRights() || $this->mayOperate("insert"))) {
                 throw new PropelException(new NotPermittedException("insert.by_role", array("role_key" => "journal_entry_images")));
             }
         } else {
             $ret = $ret && $this->preUpdate($con);
             // extended_timestampable behavior
             if ($this->isModified() && !$this->isColumnModified(JournalEntryImagePeer::UPDATED_AT)) {
                 $this->setUpdatedAt(time());
             }
             // attributable behavior
             if (Session::getSession()->isAuthenticated()) {
                 if ($this->isModified() && !$this->isColumnModified(JournalEntryImagePeer::UPDATED_BY)) {
                     $this->setUpdatedBy(Session::getSession()->getUser()->getId());
                 }
             }
             // denyable behavior
             if (!(JournalEntryImagePeer::isIgnoringRights() || $this->mayOperate("update"))) {
                 throw new PropelException(new NotPermittedException("update.by_role", array("role_key" => "journal_entry_images")));
             }
         }
         if ($ret) {
             $affectedRows = $this->doSave($con);
             if ($isInsert) {
                 $this->postInsert($con);
             } else {
                 $this->postUpdate($con);
             }
             $this->postSave($con);
             JournalEntryImagePeer::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                 JournalEntryImage A model object, or null if the key is not found
  * @throws PropelException
  */
 protected function findPkSimple($key, $con)
 {
     $sql = 'SELECT `journal_entry_id`, `document_id`, `sort`, `legend`, `created_at`, `updated_at`, `created_by`, `updated_by` FROM `journal_entry_images` WHERE `journal_entry_id` = :p0 AND `document_id` = :p1';
     try {
         $stmt = $con->prepare($sql);
         $stmt->bindValue(':p0', $key[0], PDO::PARAM_INT);
         $stmt->bindValue(':p1', $key[1], 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)) {
         $obj = new JournalEntryImage();
         $obj->hydrate($row);
         JournalEntryImagePeer::addInstanceToPool($obj, serialize(array((string) $key[0], (string) $key[1])));
     }
     $stmt->closeCursor();
     return $obj;
 }
 /**
  * Selects a collection of JournalEntryImage objects pre-filled with all related objects except UserRelatedByUpdatedBy.
  *
  * @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 JournalEntryImage objects.
  * @throws PropelException Any exceptions caught during processing will be
  *		 rethrown wrapped into a PropelException.
  */
 public static function doSelectJoinAllExceptUserRelatedByUpdatedBy(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(JournalEntryImagePeer::DATABASE_NAME);
     }
     JournalEntryImagePeer::addSelectColumns($criteria);
     $startcol2 = JournalEntryImagePeer::NUM_HYDRATE_COLUMNS;
     JournalEntryPeer::addSelectColumns($criteria);
     $startcol3 = $startcol2 + JournalEntryPeer::NUM_HYDRATE_COLUMNS;
     DocumentPeer::addSelectColumns($criteria);
     $startcol4 = $startcol3 + DocumentPeer::NUM_HYDRATE_COLUMNS;
     $criteria->addJoin(JournalEntryImagePeer::JOURNAL_ENTRY_ID, JournalEntryPeer::ID, $join_behavior);
     $criteria->addJoin(JournalEntryImagePeer::DOCUMENT_ID, DocumentPeer::ID, $join_behavior);
     $stmt = BasePeer::doSelect($criteria, $con);
     $results = array();
     while ($row = $stmt->fetch(PDO::FETCH_NUM)) {
         $key1 = JournalEntryImagePeer::getPrimaryKeyHashFromRow($row, 0);
         if (null !== ($obj1 = JournalEntryImagePeer::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 = JournalEntryImagePeer::getOMClass();
             $obj1 = new $cls();
             $obj1->hydrate($row);
             JournalEntryImagePeer::addInstanceToPool($obj1, $key1);
         }
         // if obj1 already loaded
         // Add objects for joined JournalEntry rows
         $key2 = JournalEntryPeer::getPrimaryKeyHashFromRow($row, $startcol2);
         if ($key2 !== null) {
             $obj2 = JournalEntryPeer::getInstanceFromPool($key2);
             if (!$obj2) {
                 $cls = JournalEntryPeer::getOMClass();
                 $obj2 = new $cls();
                 $obj2->hydrate($row, $startcol2);
                 JournalEntryPeer::addInstanceToPool($obj2, $key2);
             }
             // if $obj2 already loaded
             // Add the $obj1 (JournalEntryImage) to the collection in $obj2 (JournalEntry)
             $obj2->addJournalEntryImage($obj1);
         }
         // if joined row is not null
         // Add objects for joined Document rows
         $key3 = DocumentPeer::getPrimaryKeyHashFromRow($row, $startcol3);
         if ($key3 !== null) {
             $obj3 = DocumentPeer::getInstanceFromPool($key3);
             if (!$obj3) {
                 $cls = DocumentPeer::getOMClass();
                 $obj3 = new $cls();
                 $obj3->hydrate($row, $startcol3);
                 DocumentPeer::addInstanceToPool($obj3, $key3);
             }
             // if $obj3 already loaded
             // Add the $obj1 (JournalEntryImage) to the collection in $obj3 (Document)
             $obj3->addJournalEntryImage($obj1);
         }
         // if joined row is not null
         $results[] = $obj1;
     }
     $stmt->closeCursor();
     return $results;
 }