root/trunk/lib/model/om/BaseSnippetSnippet.php

<?php

require_once 'propel/om/BaseObject.php';

require_once 'propel/om/Persistent.php';


include_once 'propel/util/Criteria.php';

include_once 'model/SnippetSnippetPeer.php';

/**
 * Base class that represents a row from the 'sn_snippet' table.
 *
 * 
 *
 * @package model.om
 */
abstract class BaseSnippetSnippet extends BaseObject  implements Persistent {


    /**
     * The Peer class.
     * Instance provides a convenient way of calling static methods on a class
     * that calling code may not be able to identify.
     * @var SnippetSnippetPeer
     */
    protected static $peer;


    /**
     * The value for the id field.
     * @var int
     */
    protected $id;


    /**
     * The value for the user_id field.
     * @var int
     */
    protected $user_id;


    /**
     * The value for the title field.
     * @var string
     */
    protected $title;


    /**
     * The value for the body field.
     * @var string
     */
    protected $body;


    /**
     * The value for the html_body field.
     * @var string
     */
    protected $html_body;


    /**
     * The value for the created_at field.
     * @var int
     */
    protected $created_at;


    /**
     * The value for the average_vote field.
     * @var double
     */
    protected $average_vote;


    /**
     * The value for the nb_comments field.
     * @var int
     */
    protected $nb_comments;


    /**
     * The value for the all_tags field.
     * @var string
     */
    protected $all_tags;

    /**
     * @var SnippetUser
     */
    protected $aSnippetUser;

    /**
     * Collection to store aggregation of collSnippetTags.
     * @var array
     */
    protected $collSnippetTags;
    
    /**
     * The criteria used to select the current contents of collSnippetTags.
     * @var Criteria
     */
    private $lastSnippetTagCriteria = null;

    /**
     * Collection to store aggregation of collSnippetComments.
     * @var array
     */
    protected $collSnippetComments;
    
    /**
     * The criteria used to select the current contents of collSnippetComments.
     * @var Criteria
     */
    private $lastSnippetCommentCriteria = null;

    /**
     * Collection to store aggregation of collSnippetVotes.
     * @var array
     */
    protected $collSnippetVotes;
    
    /**
     * The criteria used to select the current contents of collSnippetVotes.
     * @var Criteria
     */
    private $lastSnippetVoteCriteria = null;

    /**
     * Flag to prevent endless save loop, if this object is referenced
     * by another object which falls in this transaction.
     * @var boolean
     */
    protected $alreadyInSave = false;

    /**
     * Flag to prevent endless validation loop, if this object is referenced
     * by another object which falls in this transaction.
     * @var boolean
     */
    protected $alreadyInValidation = false;

    /**
     * Get the [id] column value.
     * 
     * @return int
     */
    public function getId()
    {

        return $this->id;
    }

    /**
     * Get the [user_id] column value.
     * 
     * @return int
     */
    public function getUserId()
    {

        return $this->user_id;
    }

    /**
     * Get the [title] column value.
     * 
     * @return string
     */
    public function getTitle()
    {

        return $this->title;
    }

    /**
     * Get the [body] column value.
     * 
     * @return string
     */
    public function getBody()
    {

        return $this->body;
    }

    /**
     * Get the [html_body] column value.
     * 
     * @return string
     */
    public function getHtmlBody()
    {

        return $this->html_body;
    }

    /**
     * Get the [optionally formatted] [created_at] column value.
     * 
     * @param string $format The date/time format string (either date()-style or strftime()-style).
     *                            If format is NULL, then the integer unix timestamp will be returned.
     * @return mixed Formatted date/time value as string or integer unix timestamp (if format is NULL).
     * @throws PropelException - if unable to convert the date/time to timestamp.
     */
    public function getCreatedAt($format = 'Y-m-d H:i:s')
    {

        if ($this->created_at === null || $this->created_at === '') {
            return null;
        } elseif (!is_int($this->created_at)) {
            // a non-timestamp value was set externally, so we convert it
            $ts = strtotime($this->created_at);
            if ($ts === -1 || $ts === false) { // in PHP 5.1 return value changes to FALSE
                throw new PropelException("Unable to parse value of [created_at] as date/time value: " . var_export($this->created_at, true));
            }
        } else {
            $ts = $this->created_at;
        }
        if ($format === null) {
            return $ts;
        } elseif (strpos($format, '%') !== false) {
            return strftime($format, $ts);
        } else {
            return date($format, $ts);
        }
    }

    /**
     * Get the [average_vote] column value.
     * 
     * @return double
     */
    public function getAverageVote()
    {

        return $this->average_vote;
    }

    /**
     * Get the [nb_comments] column value.
     * 
     * @return int
     */
    public function getNbComments()
    {

        return $this->nb_comments;
    }

    /**
     * Get the [all_tags] column value.
     * 
     * @return string
     */
    public function getAllTags()
    {

        return $this->all_tags;
    }

    /**
     * Set the value of [id] column.
     * 
     * @param int $v new value
     * @return void
     */
    public function setId($v)
    {

        if ($this->id !== $v) {
            $this->id = $v;
            $this->modifiedColumns[] = SnippetSnippetPeer::ID;
        }

    } // setId()

    /**
     * Set the value of [user_id] column.
     * 
     * @param int $v new value
     * @return void
     */
    public function setUserId($v)
    {

        if ($this->user_id !== $v) {
            $this->user_id = $v;
            $this->modifiedColumns[] = SnippetSnippetPeer::USER_ID;
        }

        if ($this->aSnippetUser !== null && $this->aSnippetUser->getId() !== $v) {
            $this->aSnippetUser = null;
        }        

    } // setUserId()

    /**
     * Set the value of [title] column.
     * 
     * @param string $v new value
     * @return void
     */
    public function setTitle($v)
    {

        if ($this->title !== $v) {
            $this->title = $v;
            $this->modifiedColumns[] = SnippetSnippetPeer::TITLE;
        }

    } // setTitle()

    /**
     * Set the value of [body] column.
     * 
     * @param string $v new value
     * @return void
     */
    public function setBody($v)
    {

        if ($this->body !== $v) {
            $this->body = $v;
            $this->modifiedColumns[] = SnippetSnippetPeer::BODY;
        }

    } // setBody()

    /**
     * Set the value of [html_body] column.
     * 
     * @param string $v new value
     * @return void
     */
    public function setHtmlBody($v)
    {

        if ($this->html_body !== $v) {
            $this->html_body = $v;
            $this->modifiedColumns[] = SnippetSnippetPeer::HTML_BODY;
        }

    } // setHtmlBody()

    /**
     * Set the value of [created_at] column.
     * 
     * @param int $v new value
     * @return void
     */
    public function setCreatedAt($v)
    {

        if ($v !== null && !is_int($v)) {
            $ts = strtotime($v);
            if ($ts === -1 || $ts === false) { // in PHP 5.1 return value changes to FALSE
                throw new PropelException("Unable to parse date/time value for [created_at] from input: " . var_export($v, true));
            }
        } else {
            $ts = $v;
        }
        if ($this->created_at !== $ts) {
            $this->created_at = $ts;
            $this->modifiedColumns[] = SnippetSnippetPeer::CREATED_AT;
        }

    } // setCreatedAt()

    /**
     * Set the value of [average_vote] column.
     * 
     * @param double $v new value
     * @return void
     */
    public function setAverageVote($v)
    {

        if ($this->average_vote !== $v) {
            $this->average_vote = $v;
            $this->modifiedColumns[] = SnippetSnippetPeer::AVERAGE_VOTE;
        }

    } // setAverageVote()

    /**
     * Set the value of [nb_comments] column.
     * 
     * @param int $v new value
     * @return void
     */
    public function setNbComments($v)
    {

        if ($this->nb_comments !== $v) {
            $this->nb_comments = $v;
            $this->modifiedColumns[] = SnippetSnippetPeer::NB_COMMENTS;
        }

    } // setNbComments()

    /**
     * Set the value of [all_tags] column.
     * 
     * @param string $v new value
     * @return void
     */
    public function setAllTags($v)
    {

        if ($this->all_tags !== $v) {
            $this->all_tags = $v;
            $this->modifiedColumns[] = SnippetSnippetPeer::ALL_TAGS;
        }

    } // setAllTags()

    /**
     * Hydrates (populates) the object variables with values from the database resultset.
     *
     * An offset (1-based "start column") is specified so that objects can be hydrated
     * with a subset of the columns in the resultset rows.  This is needed, for example,
     * for results of JOIN queries where the resultset row includes columns from two or
     * more tables.
     *
     * @param ResultSet $rs The ResultSet class with cursor advanced to desired record pos.
     * @param int $startcol 1-based offset column which indicates which restultset column to start with.
     * @return int next starting column
     * @throws PropelException  - Any caught Exception will be rewrapped as a PropelException.
     */
    public function hydrate(ResultSet $rs, $startcol = 1)
    {
        try {

            $this->id = $rs->getInt($startcol + 0);

            $this->user_id = $rs->getInt($startcol + 1);

            $this->title = $rs->getString($startcol + 2);

            $this->body = $rs->getString($startcol + 3);

            $this->html_body = $rs->getString($startcol + 4);

            $this->created_at = $rs->getTimestamp($startcol + 5, null);

            $this->average_vote = $rs->getFloat($startcol + 6);

            $this->nb_comments = $rs->getInt($startcol + 7);

            $this->all_tags = $rs->getString($startcol + 8);

            $this->resetModified();

            $this->setNew(false);

            // FIXME - using NUM_COLUMNS may be clearer.
            return $startcol + 9; // 9 = SnippetSnippetPeer::NUM_COLUMNS - SnippetSnippetPeer::NUM_LAZY_LOAD_COLUMNS).

        } catch (Exception $e) {
            throw new PropelException("Error populating SnippetSnippet object", $e);
        }
    }

    /**
     * Removes this object from datastore and sets delete attribute.
     *
     * @param Connection $con
     * @return void
     * @throws PropelException
     * @see BaseObject::setDeleted()
     * @see BaseObject::isDeleted()
     */
    public function delete($con = null)
    {
        if ($this->isDeleted()) {
            throw new PropelException("This object has already been deleted.");
        }

        if ($con === null) {
            $con = Propel::getConnection(SnippetSnippetPeer::DATABASE_NAME);
        }

        try {
            $con->begin();
            SnippetSnippetPeer::doDelete($this, $con);
            $this->setDeleted(true);
            $con->commit();
        } catch (PropelException $e) {
            $con->rollback();
            throw $e;
        }
    }

    /**
     * Stores the object in the database.  If the object is new,
     * it inserts it; otherwise an update is performed.  This method
     * wraps the doSave() worker method in a transaction.
     *
     * @param Connection $con
     * @return int The number of rows affected by this insert/update and any referring fk objects' save() operations.
     * @throws PropelException
     * @see doSave()
     */
    public function save($con = null)
    {
    if ($this->isNew() && !$this->isColumnModified('created_at'))
    {
      $this->setCreatedAt(time());
    }

        if ($this->isDeleted()) {
            throw new PropelException("You cannot save an object that has been deleted.");
        }

        if ($con === null) {
            $con = Propel::getConnection(SnippetSnippetPeer::DATABASE_NAME);
        }
        
        try {
            $con->begin();
            $affectedRows = $this->doSave($con);
            $con->commit();
            return $affectedRows;
        } catch (PropelException $e) {
            $con->rollback();
            throw $e;
        }
    }

    /**
     * Stores the object in the database.
     * 
     * If the object is new, it inserts it; otherwise an update is performed.
     * All related objects are also updated in this method.
     *
     * @param Connection $con
     * @return int The number of rows affected by this insert/update and any referring fk objects' save() operations.
     * @throws PropelException
     * @see save()
     */
    protected function doSave($con)
    {
        $affectedRows = 0; // initialize var to track total num of affected rows    
        if (!$this->alreadyInSave) {
            $this->alreadyInSave = true;


            // We call the save method on the following object(s) if they
            // were passed to this object by their coresponding set
            // method.  This object relates to these object(s) by a
            // foreign key reference.

            if ($this->aSnippetUser !== null) {
                if ($this->aSnippetUser->isModified()) {
                    $affectedRows += $this->aSnippetUser->save($con);
                }
                $this->setSnippetUser($this->aSnippetUser);
            }
    

            // If this object has been modified, then save it to the database.
            if ($this->isModified()) {
                if ($this->isNew()) {
                    $pk = SnippetSnippetPeer::doInsert($this, $con);
                    $affectedRows += 1; // we are assuming that there is only 1 row per doInsert() which 
                                         // should always be true here (even though technically 
                                         // BasePeer::doInsert() can insert multiple rows).

                    $this->setId($pk);  //[IMV] update autoincrement primary key

                    $this->setNew(false);
                } else {
                    $affectedRows += SnippetSnippetPeer::doUpdate($this, $con);
                }
                $this->resetModified(); // [HL] After being saved an object is no longer 'modified'
            }

            if ($this->collSnippetTags !== null) {
                foreach($this->collSnippetTags as $referrerFK) {
                    if (!$referrerFK->isDeleted()) {
                        $affectedRows += $referrerFK->save($con);
                    }
                }
            }

            if ($this->collSnippetComments !== null) {
                foreach($this->collSnippetComments as $referrerFK) {
                    if (!$referrerFK->isDeleted()) {
                        $affectedRows += $referrerFK->save($con);
                    }
                }
            }

            if ($this->collSnippetVotes !== null) {
                foreach($this->collSnippetVotes as $referrerFK) {
                    if (!$referrerFK->isDeleted()) {
                        $affectedRows += $referrerFK->save($con);
                    }
                }
            }

            $this->alreadyInSave = false;
        }
        return $affectedRows;
    } // doSave()

    /**
     * Array of ValidationFailed objects.
     * @var array ValidationFailed[]
     */
    protected $validationFailures = array();

    /**
     * Gets any ValidationFailed objects that resulted from last call to validate().
     *
     *
     * @return array ValidationFailed[]
     * @see validate()
     */
    public function getValidationFailures()
    {
        return $this->validationFailures;
    }

    /**
     * Validates the objects modified field values and all objects related to this table.
     *
     * If $columns is either a column name or an array of column names
     * only those columns are validated.
     *
     * @param mixed $columns Column name or an array of column names.
     * @return boolean Whether all columns pass validation.
     * @see doValidate()
     * @see getValidationFailures()
     */
    public function validate($columns = null)
    {
        $res = $this->doValidate($columns);
        if ($res === true) {
            $this->validationFailures = array();
            return true;
        } else {
            $this->validationFailures = $res;
            return false;
        }
    }

    /**
     * This function performs the validation work for complex object models.
     *
     * In addition to checking the current object, all related objects will
     * also be validated.  If all pass then <code>true</code> is returned; otherwise
     * an aggreagated array of ValidationFailed objects will be returned.
     *
     * @param array $columns Array of column names to validate.
     * @return mixed <code>true</code> if all validations pass; array of <code>ValidationFailed</code> objets otherwise.
     */
    protected function doValidate($columns = null)
    {
        if (!$this->alreadyInValidation) {
            $this->alreadyInValidation = true;
            $retval = null;

            $failureMap = array();


            // We call the validate method on the following object(s) if they
            // were passed to this object by their coresponding set
            // method.  This object relates to these object(s) by a
            // foreign key reference.

            if ($this->aSnippetUser !== null) {
                if (!$this->aSnippetUser->validate($columns)) {
                    $failureMap = array_merge($failureMap, $this->aSnippetUser->getValidationFailures());
                }
            }


            if (($retval = SnippetSnippetPeer::doValidate($this, $columns)) !== true) {
                $failureMap = array_merge($failureMap, $retval);
            }


                if ($this->collSnippetTags !== null) {
                    foreach($this->collSnippetTags as $referrerFK) {
                        if (!$referrerFK->validate($columns)) {
                            $failureMap = array_merge($failureMap, $referrerFK->getValidationFailures());
                        }
                    }
                }

                if ($this->collSnippetComments !== null) {
                    foreach($this->collSnippetComments as $referrerFK) {
                        if (!$referrerFK->validate($columns)) {
                            $failureMap = array_merge($failureMap, $referrerFK->getValidationFailures());
                        }
                    }
                }

                if ($this->collSnippetVotes !== null) {
                    foreach($this->collSnippetVotes as $referrerFK) {
                        if (!$referrerFK->validate($columns)) {
                            $failureMap = array_merge($failureMap, $referrerFK->getValidationFailures());
                        }
                    }
                }


            $this->alreadyInValidation = false;
        }

        return (!empty($failureMap) ? $failureMap : true);
    }

    /**
     * Retrieves a field from the object by name passed in as a string.
     *
     * @param string $name name
     * @param string $type The type of fieldname the $name is of:
     *                     one of the class type constants TYPE_PHPNAME,
     *                     TYPE_COLNAME, TYPE_FIELDNAME, TYPE_NUM
     * @return mixed Value of field.
     */
    public function getByName($name, $type = BasePeer::TYPE_PHPNAME)
    {
        $pos = SnippetSnippetPeer::translateFieldName($name, $type, BasePeer::TYPE_NUM);
        return $this->getByPosition($pos);
    }

    /**
     * Retrieves a field from the object by Position as specified in the xml schema.
     * Zero-based.
     *
     * @param int $pos position in xml schema
     * @return mixed Value of field at $pos
     */
    public function getByPosition($pos)
    {
        switch($pos) {
            case 0:
                return $this->getId();
                break;
            case 1:
                return $this->getUserId();
                break;
            case 2:
                return $this->getTitle();
                break;
            case 3:
                return $this->getBody();
                break;
            case 4:
                return $this->getHtmlBody();
                break;
            case 5:
                return $this->getCreatedAt();
                break;
            case 6:
                return $this->getAverageVote();
                break;
            case 7:
                return $this->getNbComments();
                break;
            case 8:
                return $this->getAllTags();
                break;
            default:
                return null;
                break;
        } // switch()
    }

    /**
     * Exports the object as an array.
     *
     * You can specify the key type of the array by passing one of the class
     * type constants.
     *
     * @param string $keyType One of the class type constants TYPE_PHPNAME,
     *                        TYPE_COLNAME, TYPE_FIELDNAME, TYPE_NUM
     * @return an associative array containing the field names (as keys) and field values
     */
    public function toArray($keyType = BasePeer::TYPE_PHPNAME)
    {
        $keys = SnippetSnippetPeer::getFieldNames($keyType);
        $result = array(
            $keys[0] => $this->getId(),
            $keys[1] => $this->getUserId(),
            $keys[2] => $this->getTitle(),
            $keys[3] => $this->getBody(),
            $keys[4] => $this->getHtmlBody(),
            $keys[5] => $this->getCreatedAt(),
            $keys[6] => $this->getAverageVote(),
            $keys[7] => $this->getNbComments(),
            $keys[8] => $this->getAllTags(),
        );
        return $result;
    }

    /**
     * Sets a field from the object by name passed in as a string.
     *
     * @param string $name peer name
     * @param mixed $value field value
     * @param string $type The type of fieldname the $name is of:
     *                     one of the class type constants TYPE_PHPNAME,
     *                     TYPE_COLNAME, TYPE_FIELDNAME, TYPE_NUM
     * @return void
     */
    public function setByName($name, $value, $type = BasePeer::TYPE_PHPNAME)
    {
        $pos = SnippetSnippetPeer::translateFieldName($name, $type, BasePeer::TYPE_NUM);
        return $this->setByPosition($pos, $value);
    }

    /**
     * Sets a field from the object by Position as specified in the xml schema.
     * Zero-based.
     *
     * @param int $pos position in xml schema
     * @param mixed $value field value
     * @return void
     */
    public function setByPosition($pos, $value)
    {
        switch($pos) {
            case 0:
                $this->setId($value);
                break;
            case 1:
                $this->setUserId($value);
                break;
            case 2:
                $this->setTitle($value);
                break;
            case 3:
                $this->setBody($value);
                break;
            case 4:
                $this->setHtmlBody($value);
                break;
            case 5:
                $this->setCreatedAt($value);
                break;
            case 6:
                $this->setAverageVote($value);
                break;
            case 7:
                $this->setNbComments($value);
                break;
            case 8:
                $this->setAllTags($value);
                break;
        } // switch()
    }

    /**
     * Populates the object using an array.
     *
     * This is particularly useful when populating an object from one of the
     * request arrays (e.g. $_POST).  This method goes through the column
     * names, checking to see whether a matching key exists in populated
     * array. If so the setByName() method is called for that column.
     *
     * You can specify the key type of the array by additionally passing one
     * of the class type constants TYPE_PHPNAME, TYPE_COLNAME, TYPE_FIELDNAME,
     * TYPE_NUM. The default key type is the column's phpname (e.g. 'authorId')
     *
     * @param array  $arr     An array to populate the object from.
     * @param string $keyType The type of keys the array uses.
     * @return void
     */
    public function fromArray($arr, $keyType = BasePeer::TYPE_PHPNAME)
    {
        $keys = SnippetSnippetPeer::getFieldNames($keyType);

        if (array_key_exists($keys[0], $arr)) $this->setId($arr[$keys[0]]);
        if (array_key_exists($keys[1], $arr)) $this->setUserId($arr[$keys[1]]);
        if (array_key_exists($keys[2], $arr)) $this->setTitle($arr[$keys[2]]);
        if (array_key_exists($keys[3], $arr)) $this->setBody($arr[$keys[3]]);
        if (array_key_exists($keys[4], $arr)) $this->setHtmlBody($arr[$keys[4]]);
        if (array_key_exists($keys[5], $arr)) $this->setCreatedAt($arr[$keys[5]]);
        if (array_key_exists($keys[6], $arr)) $this->setAverageVote($arr[$keys[6]]);
        if (array_key_exists($keys[7], $arr)) $this->setNbComments($arr[$keys[7]]);
        if (array_key_exists($keys[8], $arr)) $this->setAllTags($arr[$keys[8]]);
    }

    /**
     * Build a Criteria object containing the values of all modified columns in this object.
     *
     * @return Criteria The Criteria object containing all modified values.
     */
    public function buildCriteria()
    {
        $criteria = new Criteria(SnippetSnippetPeer::DATABASE_NAME);

        if ($this->isColumnModified(SnippetSnippetPeer::ID)) $criteria->add(SnippetSnippetPeer::ID, $this->id);
        if ($this->isColumnModified(SnippetSnippetPeer::USER_ID)) $criteria->add(SnippetSnippetPeer::USER_ID, $this->user_id);
        if ($this->isColumnModified(SnippetSnippetPeer::TITLE)) $criteria->add(SnippetSnippetPeer::TITLE, $this->title);
        if ($this->isColumnModified(SnippetSnippetPeer::BODY)) $criteria->add(SnippetSnippetPeer::BODY, $this->body);
        if ($this->isColumnModified(SnippetSnippetPeer::HTML_BODY)) $criteria->add(SnippetSnippetPeer::HTML_BODY, $this->html_body);
        if ($this->isColumnModified(SnippetSnippetPeer::CREATED_AT)) $criteria->add(SnippetSnippetPeer::CREATED_AT, $this->created_at);
        if ($this->isColumnModified(SnippetSnippetPeer::AVERAGE_VOTE)) $criteria->add(SnippetSnippetPeer::AVERAGE_VOTE, $this->average_vote);
        if ($this->isColumnModified(SnippetSnippetPeer::NB_COMMENTS)) $criteria->add(SnippetSnippetPeer::NB_COMMENTS, $this->nb_comments);
        if ($this->isColumnModified(SnippetSnippetPeer::ALL_TAGS)) $criteria->add(SnippetSnippetPeer::ALL_TAGS, $this->all_tags);

        return $criteria;
    }

    /**
     * Builds a Criteria object containing the primary key for this object.
     *
     * Unlike buildCriteria() this method includes the primary key values regardless
     * of whether or not they have been modified.
     *
     * @return Criteria The Criteria object containing value(s) for primary key(s).
     */
    public function buildPkeyCriteria()
    {
        $criteria = new Criteria(SnippetSnippetPeer::DATABASE_NAME);

        $criteria->add(SnippetSnippetPeer::ID, $this->id);

        return $criteria;
    }

    /**
     * Returns the primary key for this object (row).
     * @return int
     */
    public function getPrimaryKey()
    {
        return $this->getId();
    }

    /**
     * Generic method to set the primary key (id column).
     *
     * @param int $key Primary key.
     * @return void
     */
    public function setPrimaryKey($key)
    {
        $this->setId($key);
    }

    /**
     * Sets contents of passed object to values from current object.
     * 
     * If desired, this method can also make copies of all associated (fkey referrers)
     * objects.
     *
     * @param object $copyObj An object of SnippetSnippet (or compatible) type.
     * @param boolean $deepCopy Whether to also copy all rows that refer (by fkey) to the current row.
     * @throws PropelException
     */
    public function copyInto($copyObj, $deepCopy = false)
    {

        $copyObj->setUserId($this->user_id);

        $copyObj->setTitle($this->title);

        $copyObj->setBody($this->body);

        $copyObj->setHtmlBody($this->html_body);

        $copyObj->setCreatedAt($this->created_at);

        $copyObj->setAverageVote($this->average_vote);

        $copyObj->setNbComments($this->nb_comments);

        $copyObj->setAllTags($this->all_tags);


        if ($deepCopy) {
            // important: temporarily setNew(false) because this affects the behavior of
            // the getter/setter methods for fkey referrer objects.
            $copyObj->setNew(false);

            foreach($this->getSnippetTags() as $relObj) {
                if($copyObj instanceof self && $this->getPrimaryKey() === $relObj->getPrimaryKey()) {
                    continue;
                }
                $copyObj->addSnippetTag($relObj->copy($deepCopy));
            }

            foreach($this->getSnippetComments() as $relObj) {
                if($copyObj instanceof self && $this->getPrimaryKey() === $relObj->getPrimaryKey()) {
                    continue;
                }
                $copyObj->addSnippetComment($relObj->copy($deepCopy));
            }

            foreach($this->getSnippetVotes() as $relObj) {
                if($copyObj instanceof self && $this->getPrimaryKey() === $relObj->getPrimaryKey()) {
                    continue;
                }
                $copyObj->addSnippetVote($relObj->copy($deepCopy));
            }

        } // if ($deepCopy)


        $copyObj->setNew(true);

        $copyObj->setId(NULL); // this is a pkey column, so set to default value

    }

    /**
     * Makes a copy of this object that will be inserted as a new row in table when saved.
     * It creates a new object filling in the simple attributes, but skipping any primary
     * keys that are defined for the table.
     * 
     * If desired, this method can also make copies of all associated (fkey referrers)
     * objects.
     *
     * @param boolean $deepCopy Whether to also copy all rows that refer (by fkey) to the current row.
     * @return SnippetSnippet Clone of current object.
     * @throws PropelException
     */
    public function copy($deepCopy = false)
    {
        // we use get_class(), because this might be a subclass
        $clazz = get_class($this);
        $copyObj = new $clazz();
        $this->copyInto($copyObj, $deepCopy);
        return $copyObj;
    }

    /**
     * Returns a peer instance associated with this om.
     *
     * Since Peer classes are not to have any instance attributes, this method returns the
     * same instance for all member of this class. The method could therefore
     * be static, but this would prevent one from overriding the behavior.
     *
     * @return SnippetSnippetPeer
     */
    public function getPeer()
    {
        if (self::$peer === null) {
            self::$peer = new SnippetSnippetPeer();
        }
        return self::$peer;
    }

    /**
     * Declares an association between this object and a SnippetUser object.
     *
     * @param SnippetUser $v
     * @return void
     * @throws PropelException
     */
    public function setSnippetUser($v)
    {


        if ($v === null) {
            $this->setUserId(NULL);
        } else {
            $this->setUserId($v->getId());
        }


        $this->aSnippetUser = $v;
    }


    /**
     * Get the associated SnippetUser object
     *
     * @param Connection Optional Connection object.
     * @return SnippetUser The associated SnippetUser object.
     * @throws PropelException
     */
    public function getSnippetUser($con = null)
    {
        // include the related Peer class
        include_once 'model/om/BaseSnippetUserPeer.php';

        if ($this->aSnippetUser === null && ($this->user_id !== null)) {

            $this->aSnippetUser = SnippetUserPeer::retrieveByPK($this->user_id, $con);
                    
            /* The following can be used instead of the line above to
               guarantee the related object contains a reference
               to this object, but this level of coupling
               may be undesirable in many circumstances.
               As it can lead to a db query with many results that may
               never be used.
               $obj = SnippetUserPeer::retrieveByPK($this->user_id, $con);
               $obj->addSnippetUsers($this);
             */
        }
        return $this->aSnippetUser;
    }

    /**
     * Temporary storage of collSnippetTags to save a possible db hit in
     * the event objects are add to the collection, but the
     * complete collection is never requested.
     * @return void
     */
    public function initSnippetTags()
    {
        if ($this->collSnippetTags === null) {
            $this->collSnippetTags = array();
        }
    }

    /**
     * If this collection has already been initialized with
     * an identical criteria, it returns the collection.
     * Otherwise if this SnippetSnippet has previously
     * been saved, it will retrieve related SnippetTags from storage.
     * If this SnippetSnippet is new, it will return
     * an empty collection or the current collection, the criteria
     * is ignored on a new object.
     *
     * @param Connection $con
     * @param Criteria $criteria
     * @throws PropelException
     */
    public function getSnippetTags($criteria = null, $con = null)
    {
        // include the Peer class
        include_once 'model/om/BaseSnippetTagPeer.php';
        if ($criteria === null) {
            $criteria = new Criteria();
        }
        elseif ($criteria instanceof Criteria)
        {
            $criteria = clone $criteria;
        }

        if ($this->collSnippetTags === null) {
            if ($this->isNew()) {
               $this->collSnippetTags = array();
            } else {

                $criteria->add(SnippetTagPeer::SNIPPET_ID, $this->getId());

                SnippetTagPeer::addSelectColumns($criteria);
                $this->collSnippetTags = SnippetTagPeer::doSelect($criteria, $con);
            }
        } else {
            // criteria has no effect for a new object
            if (!$this->isNew()) {
                // the following code is to determine if a new query is
                // called for.  If the criteria is the same as the last
                // one, just return the collection.


                $criteria->add(SnippetTagPeer::SNIPPET_ID, $this->getId());

                SnippetTagPeer::addSelectColumns($criteria);
                if (!isset($this->lastSnippetTagCriteria) || !$this->lastSnippetTagCriteria->equals($criteria)) {
                    $this->collSnippetTags = SnippetTagPeer::doSelect($criteria, $con);
                }
            }
        }
        $this->lastSnippetTagCriteria = $criteria;
        return $this->collSnippetTags;
    }

    /**
     * Returns the number of related SnippetTags.
     *
     * @param Criteria $criteria
     * @param boolean $distinct
     * @param Connection $con
     * @throws PropelException
     */
    public function countSnippetTags($criteria = null, $distinct = false, $con = null)
    {
        // include the Peer class
        include_once 'model/om/BaseSnippetTagPeer.php';
        if ($criteria === null) {
            $criteria = new Criteria();
        }
        elseif ($criteria instanceof Criteria)
        {
            $criteria = clone $criteria;
        }

        $criteria->add(SnippetTagPeer::SNIPPET_ID, $this->getId());

        return SnippetTagPeer::doCount($criteria, $distinct, $con);
    }

    /**
     * Method called to associate a SnippetTag object to this object
     * through the SnippetTag foreign key attribute
     *
     * @param SnippetTag $l SnippetTag
     * @return void
     * @throws PropelException
     */
    public function addSnippetTag(SnippetTag $l)
    {
        $this->collSnippetTags[] = $l;
        $l->setSnippetSnippet($this);
    }


    /**
     * If this collection has already been initialized with
     * an identical criteria, it returns the collection.
     * Otherwise if this SnippetSnippet is new, it will return
     * an empty collection; or if this SnippetSnippet has previously
     * been saved, it will retrieve related SnippetTags 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 SnippetSnippet.
     */
    public function getSnippetTagsJoinSnippetUser($criteria = null, $con = null)
    {
        // include the Peer class
        include_once 'model/om/BaseSnippetTagPeer.php';
        if ($criteria === null) {
            $criteria = new Criteria();
        }
        elseif ($criteria instanceof Criteria)
        {
            $criteria = clone $criteria;
        }

        if ($this->collSnippetTags === null) {
            if ($this->isNew()) {
                $this->collSnippetTags = array();
            } else {

                $criteria->add(SnippetTagPeer::SNIPPET_ID, $this->getId());

                $this->collSnippetTags = SnippetTagPeer::doSelectJoinSnippetUser($criteria, $con);
            }
        } else {
            // the following code is to determine if a new query is
            // called for.  If the criteria is the same as the last
            // one, just return the collection.

            $criteria->add(SnippetTagPeer::SNIPPET_ID, $this->getId());

            if (!isset($this->lastSnippetTagCriteria) || !$this->lastSnippetTagCriteria->equals($criteria)) {
                $this->collSnippetTags = SnippetTagPeer::doSelectJoinSnippetUser($criteria, $con);
            }
        }
        $this->lastSnippetTagCriteria = $criteria;

        return $this->collSnippetTags;
    }

    /**
     * Temporary storage of collSnippetComments to save a possible db hit in
     * the event objects are add to the collection, but the
     * complete collection is never requested.
     * @return void
     */
    public function initSnippetComments()
    {
        if ($this->collSnippetComments === null) {
            $this->collSnippetComments = array();
        }
    }

    /**
     * If this collection has already been initialized with
     * an identical criteria, it returns the collection.
     * Otherwise if this SnippetSnippet has previously
     * been saved, it will retrieve related SnippetComments from storage.
     * If this SnippetSnippet is new, it will return
     * an empty collection or the current collection, the criteria
     * is ignored on a new object.
     *
     * @param Connection $con
     * @param Criteria $criteria
     * @throws PropelException
     */
    public function getSnippetComments($criteria = null, $con = null)
    {
        // include the Peer class
        include_once 'model/om/BaseSnippetCommentPeer.php';
        if ($criteria === null) {
            $criteria = new Criteria();
        }
        elseif ($criteria instanceof Criteria)
        {
            $criteria = clone $criteria;
        }

        if ($this->collSnippetComments === null) {
            if ($this->isNew()) {
               $this->collSnippetComments = array();
            } else {

                $criteria->add(SnippetCommentPeer::SNIPPET_ID, $this->getId());

                SnippetCommentPeer::addSelectColumns($criteria);
                $this->collSnippetComments = SnippetCommentPeer::doSelect($criteria, $con);
            }
        } else {
            // criteria has no effect for a new object
            if (!$this->isNew()) {
                // the following code is to determine if a new query is
                // called for.  If the criteria is the same as the last
                // one, just return the collection.


                $criteria->add(SnippetCommentPeer::SNIPPET_ID, $this->getId());

                SnippetCommentPeer::addSelectColumns($criteria);
                if (!isset($this->lastSnippetCommentCriteria) || !$this->lastSnippetCommentCriteria->equals($criteria)) {
                    $this->collSnippetComments = SnippetCommentPeer::doSelect($criteria, $con);
                }
            }
        }
        $this->lastSnippetCommentCriteria = $criteria;
        return $this->collSnippetComments;
    }

    /**
     * Returns the number of related SnippetComments.
     *
     * @param Criteria $criteria
     * @param boolean $distinct
     * @param Connection $con
     * @throws PropelException
     */
    public function countSnippetComments($criteria = null, $distinct = false, $con = null)
    {
        // include the Peer class
        include_once 'model/om/BaseSnippetCommentPeer.php';
        if ($criteria === null) {
            $criteria = new Criteria();
        }
        elseif ($criteria instanceof Criteria)
        {
            $criteria = clone $criteria;
        }

        $criteria->add(SnippetCommentPeer::SNIPPET_ID, $this->getId());

        return SnippetCommentPeer::doCount($criteria, $distinct, $con);
    }

    /**
     * Method called to associate a SnippetComment object to this object
     * through the SnippetComment foreign key attribute
     *
     * @param SnippetComment $l SnippetComment
     * @return void
     * @throws PropelException
     */
    public function addSnippetComment(SnippetComment $l)
    {
        $this->collSnippetComments[] = $l;
        $l->setSnippetSnippet($this);
    }


    /**
     * If this collection has already been initialized with
     * an identical criteria, it returns the collection.
     * Otherwise if this SnippetSnippet is new, it will return
     * an empty collection; or if this SnippetSnippet has previously
     * been saved, it will retrieve related SnippetComments 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 SnippetSnippet.
     */
    public function getSnippetCommentsJoinSnippetUser($criteria = null, $con = null)
    {
        // include the Peer class
        include_once 'model/om/BaseSnippetCommentPeer.php';
        if ($criteria === null) {
            $criteria = new Criteria();
        }
        elseif ($criteria instanceof Criteria)
        {
            $criteria = clone $criteria;
        }

        if ($this->collSnippetComments === null) {
            if ($this->isNew()) {
                $this->collSnippetComments = array();
            } else {

                $criteria->add(SnippetCommentPeer::SNIPPET_ID, $this->getId());

                $this->collSnippetComments = SnippetCommentPeer::doSelectJoinSnippetUser($criteria, $con);
            }
        } else {
            // the following code is to determine if a new query is
            // called for.  If the criteria is the same as the last
            // one, just return the collection.

            $criteria->add(SnippetCommentPeer::SNIPPET_ID, $this->getId());

            if (!isset($this->lastSnippetCommentCriteria) || !$this->lastSnippetCommentCriteria->equals($criteria)) {
                $this->collSnippetComments = SnippetCommentPeer::doSelectJoinSnippetUser($criteria, $con);
            }
        }
        $this->lastSnippetCommentCriteria = $criteria;

        return $this->collSnippetComments;
    }

    /**
     * Temporary storage of collSnippetVotes to save a possible db hit in
     * the event objects are add to the collection, but the
     * complete collection is never requested.
     * @return void
     */
    public function initSnippetVotes()
    {
        if ($this->collSnippetVotes === null) {
            $this->collSnippetVotes = array();
        }
    }

    /**
     * If this collection has already been initialized with
     * an identical criteria, it returns the collection.
     * Otherwise if this SnippetSnippet has previously
     * been saved, it will retrieve related SnippetVotes from storage.
     * If this SnippetSnippet is new, it will return
     * an empty collection or the current collection, the criteria
     * is ignored on a new object.
     *
     * @param Connection $con
     * @param Criteria $criteria
     * @throws PropelException
     */
    public function getSnippetVotes($criteria = null, $con = null)
    {
        // include the Peer class
        include_once 'model/om/BaseSnippetVotePeer.php';
        if ($criteria === null) {
            $criteria = new Criteria();
        }
        elseif ($criteria instanceof Criteria)
        {
            $criteria = clone $criteria;
        }

        if ($this->collSnippetVotes === null) {
            if ($this->isNew()) {
               $this->collSnippetVotes = array();
            } else {

                $criteria->add(SnippetVotePeer::SNIPPET_ID, $this->getId());

                SnippetVotePeer::addSelectColumns($criteria);
                $this->collSnippetVotes = SnippetVotePeer::doSelect($criteria, $con);
            }
        } else {
            // criteria has no effect for a new object
            if (!$this->isNew()) {
                // the following code is to determine if a new query is
                // called for.  If the criteria is the same as the last
                // one, just return the collection.


                $criteria->add(SnippetVotePeer::SNIPPET_ID, $this->getId());

                SnippetVotePeer::addSelectColumns($criteria);
                if (!isset($this->lastSnippetVoteCriteria) || !$this->lastSnippetVoteCriteria->equals($criteria)) {
                    $this->collSnippetVotes = SnippetVotePeer::doSelect($criteria, $con);
                }
            }
        }
        $this->lastSnippetVoteCriteria = $criteria;
        return $this->collSnippetVotes;
    }

    /**
     * Returns the number of related SnippetVotes.
     *
     * @param Criteria $criteria
     * @param boolean $distinct
     * @param Connection $con
     * @throws PropelException
     */
    public function countSnippetVotes($criteria = null, $distinct = false, $con = null)
    {
        // include the Peer class
        include_once 'model/om/BaseSnippetVotePeer.php';
        if ($criteria === null) {
            $criteria = new Criteria();
        }
        elseif ($criteria instanceof Criteria)
        {
            $criteria = clone $criteria;
        }

        $criteria->add(SnippetVotePeer::SNIPPET_ID, $this->getId());

        return SnippetVotePeer::doCount($criteria, $distinct, $con);
    }

    /**
     * Method called to associate a SnippetVote object to this object
     * through the SnippetVote foreign key attribute
     *
     * @param SnippetVote $l SnippetVote
     * @return void
     * @throws PropelException
     */
    public function addSnippetVote(SnippetVote $l)
    {
        $this->collSnippetVotes[] = $l;
        $l->setSnippetSnippet($this);
    }


    /**
     * If this collection has already been initialized with
     * an identical criteria, it returns the collection.
     * Otherwise if this SnippetSnippet is new, it will return
     * an empty collection; or if this SnippetSnippet has previously
     * been saved, it will retrieve related SnippetVotes 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 SnippetSnippet.
     */
    public function getSnippetVotesJoinSnippetUser($criteria = null, $con = null)
    {
        // include the Peer class
        include_once 'model/om/BaseSnippetVotePeer.php';
        if ($criteria === null) {
            $criteria = new Criteria();
        }
        elseif ($criteria instanceof Criteria)
        {
            $criteria = clone $criteria;
        }

        if ($this->collSnippetVotes === null) {
            if ($this->isNew()) {
                $this->collSnippetVotes = array();
            } else {

                $criteria->add(SnippetVotePeer::SNIPPET_ID, $this->getId());

                $this->collSnippetVotes = SnippetVotePeer::doSelectJoinSnippetUser($criteria, $con);
            }
        } else {
            // the following code is to determine if a new query is
            // called for.  If the criteria is the same as the last
            // one, just return the collection.

            $criteria->add(SnippetVotePeer::SNIPPET_ID, $this->getId());

            if (!isset($this->lastSnippetVoteCriteria) || !$this->lastSnippetVoteCriteria->equals($criteria)) {
                $this->collSnippetVotes = SnippetVotePeer::doSelectJoinSnippetUser($criteria, $con);
            }
        }
        $this->lastSnippetVoteCriteria = $criteria;

        return $this->collSnippetVotes;
    }

} // BaseSnippetSnippet