Blame | Letzte Änderung | Log anzeigen | RSS feed
<?php/*** Base class that represents a row from the 'product' table.**** This class was autogenerated by Propel 1.4.2 on:** Fri Aug 5 09:39:37 2011** @package lib.model.om*/abstract class BaseProduct 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 ProductPeer*/protected static $peer;/*** The value for the id field.* @var int*/protected $id;/*** The value for the price field.* @var double*/protected $price;/*** The value for the a_primary_string field.* @var string*/protected $a_primary_string;/*** @var array ProductI18n[] Collection to store aggregation of ProductI18n objects.*/protected $collTranslations;/*** @var Criteria The criteria used to select the current contents of collTranslations.*/private $lastTranslationCriteria = 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;// symfony behaviorconst PEER = 'ProductPeer';// symfony_i18n behavior/*** @var string The value for the culture field*/protected $culture = null;/*** @var array Current I18N objects*/protected $current_i18n = array();/*** Get the [id] column value.** @return int*/public function getId(){return $this->id;}/*** Get the [price] column value.** @return double*/public function getPrice(){return $this->price;}/*** Get the [a_primary_string] column value.** @return string*/public function getAPrimaryString(){return $this->a_primary_string;}/*** Set the value of [id] column.** @param int $v new value* @return Product The current object (for fluent API support)*/public function setId($v){if ($v !== null) {$v = (int) $v;}if ($this->id !== $v) {$this->id = $v;$this->modifiedColumns[] = ProductPeer::ID;}return $this;} // setId()/*** Set the value of [price] column.** @param double $v new value* @return Product The current object (for fluent API support)*/public function setPrice($v){if ($v !== null) {$v = (double) $v;}if ($this->price !== $v) {$this->price = $v;$this->modifiedColumns[] = ProductPeer::PRICE;}return $this;} // setPrice()/*** Set the value of [a_primary_string] column.** @param string $v new value* @return Product The current object (for fluent API support)*/public function setAPrimaryString($v){if ($v !== null) {$v = (string) $v;}if ($this->a_primary_string !== $v) {$this->a_primary_string = $v;$this->modifiedColumns[] = ProductPeer::A_PRIMARY_STRING;}return $this;} // setAPrimaryString()/*** Indicates whether the columns in this object are only set to default values.** This method can be used in conjunction with isModified() to indicate whether an object is both* modified _and_ has some values set which are non-default.** @return boolean Whether the columns in this object are only been set with default values.*/public function hasOnlyDefaultValues(){// otherwise, everything was equal, so return TRUEreturn true;} // hasOnlyDefaultValues()/*** Hydrates (populates) the object variables with values from the database resultset.** An offset (0-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 array $row The row returned by PDOStatement->fetch(PDO::FETCH_NUM)* @param int $startcol 0-based offset column which indicates which restultset column to start with.* @param boolean $rehydrate Whether this object is being re-hydrated from the database.* @return int next starting column* @throws PropelException - Any caught Exception will be rewrapped as a PropelException.*/public function hydrate($row, $startcol = 0, $rehydrate = false){try {$this->id = ($row[$startcol + 0] !== null) ? (int) $row[$startcol + 0] : null;$this->price = ($row[$startcol + 1] !== null) ? (double) $row[$startcol + 1] : null;$this->a_primary_string = ($row[$startcol + 2] !== null) ? (string) $row[$startcol + 2] : null;$this->resetModified();$this->setNew(false);if ($rehydrate) {$this->ensureConsistency();}// FIXME - using NUM_COLUMNS may be clearer.return $startcol + 3; // 3 = ProductPeer::NUM_COLUMNS - ProductPeer::NUM_LAZY_LOAD_COLUMNS).} catch (Exception $e) {throw new PropelException("Error populating Product object", $e);}}/*** Checks and repairs the internal consistency of the object.** This method is executed after an already-instantiated object is re-hydrated* from the database. It exists to check any foreign keys to make sure that* the objects related to the current object are correct based on foreign key.** You can override this method in the stub class, but you should always invoke* the base method from the overridden method (i.e. parent::ensureConsistency()),* in case your model changes.** @throws PropelException*/public function ensureConsistency(){} // ensureConsistency/*** Reloads this object from datastore based on primary key and (optionally) resets all associated objects.** This will only work if the object has been saved and has a valid primary key set.** @param boolean $deep (optional) Whether to also de-associated any related objects.* @param PropelPDO $con (optional) The PropelPDO connection to use.* @return void* @throws PropelException - if this object is deleted, unsaved or doesn't have pk match in db*/public function reload($deep = false, PropelPDO $con = null){if ($this->isDeleted()) {throw new PropelException("Cannot reload a deleted object.");}if ($this->isNew()) {throw new PropelException("Cannot reload an unsaved object.");}if ($con === null) {$con = Propel::getConnection(ProductPeer::DATABASE_NAME, Propel::CONNECTION_READ);}// We don't need to alter the object instance pool; we're just modifying this instance// already in the pool.$stmt = ProductPeer::doSelectStmt($this->buildPkeyCriteria(), $con);$row = $stmt->fetch(PDO::FETCH_NUM);$stmt->closeCursor();if (!$row) {throw new PropelException('Cannot find matching row in the database to reload object values.');}$this->hydrate($row, 0, true); // rehydrateif ($deep) { // also de-associate any related objects?$this->collTranslations = null;$this->lastTranslationCriteria = null;} // if (deep)}/*** Removes this object from datastore and sets delete attribute.** @param PropelPDO $con* @return void* @throws PropelException* @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(ProductPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);}$con->beginTransaction();try {$ret = $this->preDelete($con);// symfony_behaviors behaviorforeach (sfMixer::getCallables('BaseProduct:delete:pre') as $callable){if (call_user_func($callable, $this, $con)){$con->commit();return;}}if ($ret) {ProductPeer::doDelete($this, $con);$this->postDelete($con);// symfony_behaviors behaviorforeach (sfMixer::getCallables('BaseProduct:delete:post') as $callable){call_user_func($callable, $this, $con);}$this->setDeleted(true);$con->commit();} else {$con->commit();}} catch (PropelException $e) {$con->rollBack();throw $e;}}/*** 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* @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(ProductPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);}$con->beginTransaction();$isInsert = $this->isNew();try {$ret = $this->preSave($con);// symfony_behaviors behaviorforeach (sfMixer::getCallables('BaseProduct:save:pre') as $callable){if (is_integer($affectedRows = call_user_func($callable, $this, $con))){$con->commit();return $affectedRows;}}if ($isInsert) {$ret = $ret && $this->preInsert($con);} else {$ret = $ret && $this->preUpdate($con);}if ($ret) {$affectedRows = $this->doSave($con);if ($isInsert) {$this->postInsert($con);} else {$this->postUpdate($con);}$this->postSave($con);// symfony_behaviors behaviorforeach (sfMixer::getCallables('BaseProduct:save:post') as $callable){call_user_func($callable, $this, $con, $affectedRows);}ProductPeer::addInstanceToPool($this);} else {$affectedRows = 0;}$con->commit();return $affectedRows;} catch (PropelException $e) {$con->rollBack();throw $e;}}/*** Performs the work of inserting or updating the row 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 PropelPDO $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(PropelPDO $con){$affectedRows = 0; // initialize var to track total num of affected rowsif (!$this->alreadyInSave) {$this->alreadyInSave = true;if ($this->isNew() ) {$this->modifiedColumns[] = ProductPeer::ID;}// If this object has been modified, then save it to the database.if ($this->isModified()) {if ($this->isNew()) {$pk = ProductPeer::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 += ProductPeer::doUpdate($this, $con);}$this->resetModified(); // [HL] After being saved an object is no longer 'modified'}if ($this->collTranslations !== null) {foreach ($this->collTranslations 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();if (($retval = ProductPeer::doValidate($this, $columns)) !== true) {$failureMap = array_merge($failureMap, $retval);}if ($this->collTranslations !== null) {foreach ($this->collTranslations 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 BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME* BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM* @return mixed Value of field.*/public function getByName($name, $type = BasePeer::TYPE_PHPNAME){$pos = ProductPeer::translateFieldName($name, $type, BasePeer::TYPE_NUM);$field = $this->getByPosition($pos);return $field;}/*** 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->getPrice();break;case 2:return $this->getAPrimaryString();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 (optional) One of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME* BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM. Defaults to BasePeer::TYPE_PHPNAME.* @param boolean $includeLazyLoadColumns (optional) Whether to include lazy loaded columns. Defaults to TRUE.* @return an associative array containing the field names (as keys) and field values*/public function toArray($keyType = BasePeer::TYPE_PHPNAME, $includeLazyLoadColumns = true){$keys = ProductPeer::getFieldNames($keyType);$result = array($keys[0] => $this->getId(),$keys[1] => $this->getPrice(),$keys[2] => $this->getAPrimaryString(),);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 BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME* BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM* @return void*/public function setByName($name, $value, $type = BasePeer::TYPE_PHPNAME){$pos = ProductPeer::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->setPrice($value);break;case 2:$this->setAPrimaryString($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 BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME,* BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::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 = ProductPeer::getFieldNames($keyType);if (array_key_exists($keys[0], $arr)) $this->setId($arr[$keys[0]]);if (array_key_exists($keys[1], $arr)) $this->setPrice($arr[$keys[1]]);if (array_key_exists($keys[2], $arr)) $this->setAPrimaryString($arr[$keys[2]]);}/*** 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(ProductPeer::DATABASE_NAME);if ($this->isColumnModified(ProductPeer::ID)) $criteria->add(ProductPeer::ID, $this->id);if ($this->isColumnModified(ProductPeer::PRICE)) $criteria->add(ProductPeer::PRICE, $this->price);if ($this->isColumnModified(ProductPeer::A_PRIMARY_STRING)) $criteria->add(ProductPeer::A_PRIMARY_STRING, $this->a_primary_string);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(ProductPeer::DATABASE_NAME);$criteria->add(ProductPeer::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 Product (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->setPrice($this->price);$copyObj->setAPrimaryString($this->a_primary_string);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->getTranslations() as $relObj) {if ($relObj !== $this) { // ensure that we don't try to copy a reference to ourselves$copyObj->addTranslation($relObj->copy($deepCopy));}}} // if ($deepCopy)$copyObj->setNew(true);$copyObj->setId(NULL); // this is a auto-increment 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 Product 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 ProductPeer*/public function getPeer(){if (self::$peer === null) {self::$peer = new ProductPeer();}return self::$peer;}/*** Clears out the collTranslations collection (array).** This does not modify the database; however, it will remove any associated objects, causing* them to be refetched by subsequent calls to accessor method.** @return void* @see addTranslations()*/public function clearTranslations(){$this->collTranslations = null; // important to set this to NULL since that means it is uninitialized}/*** Initializes the collTranslations collection (array).** By default this just sets the collTranslations collection to an empty array (like clearcollTranslations());* however, you may wish to override this method in your stub class to provide setting appropriate* to your application -- for example, setting the initial array to the values stored in database.** @return void*/public function initTranslations(){$this->collTranslations = array();}/*** Gets an array of ProductI18n objects which contain a foreign key that references this object.** If this collection has already been initialized with an identical Criteria, it returns the collection.* Otherwise if this Product has previously been saved, it will retrieve* related Translations from storage. If this Product is new, it will return* an empty collection or the current collection, the criteria is ignored on a new object.** @param PropelPDO $con* @param Criteria $criteria* @return array ProductI18n[]* @throws PropelException*/public function getTranslations($criteria = null, PropelPDO $con = null){if ($criteria === null) {$criteria = new Criteria(ProductPeer::DATABASE_NAME);}elseif ($criteria instanceof Criteria){$criteria = clone $criteria;}if ($this->collTranslations === null) {if ($this->isNew()) {$this->collTranslations = array();} else {$criteria->add(ProductI18nPeer::ID, $this->id);ProductI18nPeer::addSelectColumns($criteria);$this->collTranslations = ProductI18nPeer::doSelect($criteria, $con);}} else {// criteria has no effect for a new objectif (!$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(ProductI18nPeer::ID, $this->id);ProductI18nPeer::addSelectColumns($criteria);if (!isset($this->lastTranslationCriteria) || !$this->lastTranslationCriteria->equals($criteria)) {$this->collTranslations = ProductI18nPeer::doSelect($criteria, $con);}}}$this->lastTranslationCriteria = $criteria;return $this->collTranslations;}/*** Returns the number of related ProductI18n objects.** @param Criteria $criteria* @param boolean $distinct* @param PropelPDO $con* @return int Count of related ProductI18n objects.* @throws PropelException*/public function countTranslations(Criteria $criteria = null, $distinct = false, PropelPDO $con = null){if ($criteria === null) {$criteria = new Criteria(ProductPeer::DATABASE_NAME);} else {$criteria = clone $criteria;}if ($distinct) {$criteria->setDistinct();}$count = null;if ($this->collTranslations === null) {if ($this->isNew()) {$count = 0;} else {$criteria->add(ProductI18nPeer::ID, $this->id);$count = ProductI18nPeer::doCount($criteria, false, $con);}} else {// criteria has no effect for a new objectif (!$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 count of the collection.$criteria->add(ProductI18nPeer::ID, $this->id);if (!isset($this->lastTranslationCriteria) || !$this->lastTranslationCriteria->equals($criteria)) {$count = ProductI18nPeer::doCount($criteria, false, $con);} else {$count = count($this->collTranslations);}} else {$count = count($this->collTranslations);}}return $count;}/*** Method called to associate a ProductI18n object to this object* through the ProductI18n foreign key attribute.** @param ProductI18n $l ProductI18n* @return void* @throws PropelException*/public function addTranslation(ProductI18n $l){if ($this->collTranslations === null) {$this->initTranslations();}if (!in_array($l, $this->collTranslations, true)) { // only add it if the **same** object is not already associatedarray_push($this->collTranslations, $l);$l->setProduct($this);}}/*** Resets all collections of referencing foreign keys.** This method is a user-space workaround for PHP's inability to garbage collect objects* with circular references. This is currently necessary when using Propel in certain* daemon or large-volumne/high-memory operations.** @param boolean $deep Whether to also clear the references on all associated objects.*/public function clearAllReferences($deep = false){if ($deep) {if ($this->collTranslations) {foreach ((array) $this->collTranslations as $o) {$o->clearAllReferences($deep);}}} // if ($deep)$this->collTranslations = null;}// symfony_behaviors behavior/*** Calls methods defined via {@link sfMixer}.*/public function __call($method, $arguments){if (!$callable = sfMixer::getCallable('BaseProduct:'.$method)){throw new sfException(sprintf('Call to undefined method BaseProduct::%s', $method));}array_unshift($arguments, $this);return call_user_func_array($callable, $arguments);}// symfony_i18n behavior/*** Returns the culture.** @return string The culture*/public function getCulture(){return $this->culture;}/*** Sets the culture.** @param string The culture to set** @return Product*/public function setCulture($culture){$this->culture = $culture;return $this;}/*** Returns the "name" value from the current {@link ProductI18n}.*/public function getName($culture = null){return $this->getCurrentTranslation($culture)->getName();}/*** Sets the "name" value of the current {@link ProductI18n}.** @return Product*/public function setName($value, $culture = null){$this->getCurrentTranslation($culture)->setName($value);return $this;}/*** Returns the current translation.** @return ProductI18n*/public function getCurrentTranslation($culture = null){if (null === $culture){$culture = null === $this->culture ? sfPropel::getDefaultCulture() : $this->culture;}if (!isset($this->current_i18n[$culture])){$object = $this->isNew() ? null : ProductI18nPeer::retrieveByPK($this->getPrimaryKey(), $culture);if ($object){$this->setTranslationForCulture($object, $culture);}else{$this->setTranslationForCulture(new ProductI18n(), $culture);$this->current_i18n[$culture]->setCulture($culture);}}return $this->current_i18n[$culture];}/*** Sets the translation object for a culture.*/public function setTranslationForCulture(ProductI18n $object, $culture){$this->current_i18n[$culture] = $object;$this->addTranslation($object);}/*** Return the string representation of this object** @return string The value of the 'a_primary_string' column*/public function __toString(){return (string) $this->getAPrimaryString();}} // BaseProduct