modifiedColumns; } /** * Has specified column been modified? * * @param string $col column fully qualified name (TableMap::TYPE_COLNAME), e.g. Book::AUTHOR_ID * @return boolean True if $col has been modified. */ public function isColumnModified($col) { return $this->modifiedColumns && isset($this->modifiedColumns[$col]); } /** * Get the columns that have been modified in this object. * @return array A unique list of the modified column names for this object. */ public function getModifiedColumns() { return $this->modifiedColumns ? array_keys($this->modifiedColumns) : []; } /** * Returns whether the object has ever been saved. This will * be false, if the object was retrieved from storage or was created * and then saved. * * @return boolean true, if the object has never been persisted. */ public function isNew() { return $this->new; } /** * Setter for the isNew attribute. This method will be called * by Propel-generated children and objects. * * @param boolean $b the state of the object. */ public function setNew($b) { $this->new = (boolean) $b; } /** * Whether this object has been deleted. * @return boolean The deleted state of this object. */ public function isDeleted() { return $this->deleted; } /** * Specify whether this object has been deleted. * @param boolean $b The deleted state of this object. * @return void */ public function setDeleted($b) { $this->deleted = (boolean) $b; } /** * Sets the modified state for the object to be false. * @param string $col If supplied, only the specified column is reset. * @return void */ public function resetModified($col = null) { if (null !== $col) { if (isset($this->modifiedColumns[$col])) { unset($this->modifiedColumns[$col]); } } else { $this->modifiedColumns = array(); } } /** * Compares this with another Product instance. If * obj is an instance of Product, delegates to * equals(Product). Otherwise, returns false. * * @param mixed $obj The object to compare to. * @return boolean Whether equal to the object specified. */ public function equals($obj) { if (!$obj instanceof static) { return false; } if ($this === $obj) { return true; } if (null === $this->getPrimaryKey() || null === $obj->getPrimaryKey()) { return false; } return $this->getPrimaryKey() === $obj->getPrimaryKey(); } /** * Get the associative array of the virtual columns in this object * * @return array */ public function getVirtualColumns() { return $this->virtualColumns; } /** * Checks the existence of a virtual column in this object * * @param string $name The virtual column name * @return boolean */ public function hasVirtualColumn($name) { return array_key_exists($name, $this->virtualColumns); } /** * Get the value of a virtual column in this object * * @param string $name The virtual column name * @return mixed * * @throws PropelException */ public function getVirtualColumn($name) { if (!$this->hasVirtualColumn($name)) { throw new PropelException(sprintf('Cannot get value of inexistent virtual column %s.', $name)); } return $this->virtualColumns[$name]; } /** * Set the value of a virtual column in this object * * @param string $name The virtual column name * @param mixed $value The value to give to the virtual column * * @return $this|Product The current object, for fluid interface */ public function setVirtualColumn($name, $value) { $this->virtualColumns[$name] = $value; return $this; } /** * Logs a message using Propel::log(). * * @param string $msg * @param int $priority One of the Propel::LOG_* logging levels * @return boolean */ protected function log($msg, $priority = Propel::LOG_INFO) { return Propel::log(get_class($this) . ': ' . $msg, $priority); } /** * Export the current object properties to a string, using a given parser format * * $book = BookQuery::create()->findPk(9012); * echo $book->exportTo('JSON'); * => {"Id":9012,"Title":"Don Juan","ISBN":"0140422161","Price":12.99,"PublisherId":1234,"AuthorId":5678}'); * * * @param mixed $parser A AbstractParser instance, or a format name ('XML', 'YAML', 'JSON', 'CSV') * @param boolean $includeLazyLoadColumns (optional) Whether to include lazy load(ed) columns. Defaults to TRUE. * @return string The exported data */ public function exportTo($parser, $includeLazyLoadColumns = true) { if (!$parser instanceof AbstractParser) { $parser = AbstractParser::getParser($parser); } return $parser->fromArray($this->toArray(TableMap::TYPE_PHPNAME, $includeLazyLoadColumns, array(), true)); } /** * Clean up internal collections prior to serializing * Avoids recursive loops that turn into segmentation faults when serializing */ public function __sleep() { $this->clearAllReferences(); return array_keys(get_object_vars($this)); } /** * Get the [id] column value. * * @return int */ public function getId() { return $this->id; } /** * Get the [name] column value. * * @return string */ public function getName() { return $this->name; } /** * Get the [price] column value. * * @return string */ public function getPrice() { return $this->price; } /** * Get the [width] column value. * * @return int */ public function getWidth() { return $this->width; } /** * Get the [height] column value. * * @return int */ public function getHeight() { return $this->height; } /** * Get the [description] column value. * * @return string */ public function getDescription() { return $this->description; } /** * Set the value of [id] column. * * @param int $v new value * @return $this|\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[ProductTableMap::COL_ID] = true; } return $this; } // setId() /** * Set the value of [name] column. * * @param string $v new value * @return $this|\Product The current object (for fluent API support) */ public function setName($v) { if ($v !== null) { $v = (string) $v; } if ($this->name !== $v) { $this->name = $v; $this->modifiedColumns[ProductTableMap::COL_NAME] = true; } return $this; } // setName() /** * Set the value of [price] column. * * @param string $v new value * @return $this|\Product The current object (for fluent API support) */ public function setPrice($v) { if ($v !== null) { $v = (string) $v; } if ($this->price !== $v) { $this->price = $v; $this->modifiedColumns[ProductTableMap::COL_PRICE] = true; } return $this; } // setPrice() /** * Set the value of [width] column. * * @param int $v new value * @return $this|\Product The current object (for fluent API support) */ public function setWidth($v) { if ($v !== null) { $v = (int) $v; } if ($this->width !== $v) { $this->width = $v; $this->modifiedColumns[ProductTableMap::COL_WIDTH] = true; } return $this; } // setWidth() /** * Set the value of [height] column. * * @param int $v new value * @return $this|\Product The current object (for fluent API support) */ public function setHeight($v) { if ($v !== null) { $v = (int) $v; } if ($this->height !== $v) { $this->height = $v; $this->modifiedColumns[ProductTableMap::COL_HEIGHT] = true; } return $this; } // setHeight() /** * Set the value of [description] column. * * @param string $v new value * @return $this|\Product The current object (for fluent API support) */ public function setDescription($v) { if ($v !== null) { $v = (string) $v; } if ($this->description !== $v) { $this->description = $v; $this->modifiedColumns[ProductTableMap::COL_DESCRIPTION] = true; } return $this; } // setDescription() /** * 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 TRUE return 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 DataFetcher->fetch(). * @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. * @param string $indexType The index type of $row. Mostly DataFetcher->getIndexType(). One of the class type constants TableMap::TYPE_PHPNAME, TableMap::TYPE_CAMELNAME * TableMap::TYPE_COLNAME, TableMap::TYPE_FIELDNAME, TableMap::TYPE_NUM. * * @return int next starting column * @throws PropelException - Any caught Exception will be rewrapped as a PropelException. */ public function hydrate($row, $startcol = 0, $rehydrate = false, $indexType = TableMap::TYPE_NUM) { try { $col = $row[TableMap::TYPE_NUM == $indexType ? 0 + $startcol : ProductTableMap::translateFieldName('Id', TableMap::TYPE_PHPNAME, $indexType)]; $this->id = (null !== $col) ? (int) $col : null; $col = $row[TableMap::TYPE_NUM == $indexType ? 1 + $startcol : ProductTableMap::translateFieldName('Name', TableMap::TYPE_PHPNAME, $indexType)]; $this->name = (null !== $col) ? (string) $col : null; $col = $row[TableMap::TYPE_NUM == $indexType ? 2 + $startcol : ProductTableMap::translateFieldName('Price', TableMap::TYPE_PHPNAME, $indexType)]; $this->price = (null !== $col) ? (string) $col : null; $col = $row[TableMap::TYPE_NUM == $indexType ? 3 + $startcol : ProductTableMap::translateFieldName('Width', TableMap::TYPE_PHPNAME, $indexType)]; $this->width = (null !== $col) ? (int) $col : null; $col = $row[TableMap::TYPE_NUM == $indexType ? 4 + $startcol : ProductTableMap::translateFieldName('Height', TableMap::TYPE_PHPNAME, $indexType)]; $this->height = (null !== $col) ? (int) $col : null; $col = $row[TableMap::TYPE_NUM == $indexType ? 5 + $startcol : ProductTableMap::translateFieldName('Description', TableMap::TYPE_PHPNAME, $indexType)]; $this->description = (null !== $col) ? (string) $col : null; $this->resetModified(); $this->setNew(false); if ($rehydrate) { $this->ensureConsistency(); } return $startcol + 6; // 6 = ProductTableMap::NUM_HYDRATE_COLUMNS. } catch (Exception $e) { throw new PropelException(sprintf('Error populating %s object', '\\Product'), 0, $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 ConnectionInterface $con (optional) The ConnectionInterface 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, ConnectionInterface $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::getServiceContainer()->getReadConnection(ProductTableMap::DATABASE_NAME); } // We don't need to alter the object instance pool; we're just modifying this instance // already in the pool. $dataFetcher = ChildProductQuery::create(null, $this->buildPkeyCriteria())->setFormatter(ModelCriteria::FORMAT_STATEMENT)->find($con); $row = $dataFetcher->fetch(); $dataFetcher->close(); if (!$row) { throw new PropelException('Cannot find matching row in the database to reload object values.'); } $this->hydrate($row, 0, true, $dataFetcher->getIndexType()); // rehydrate if ($deep) { // also de-associate any related objects? $this->collProductCategories = null; $this->collCategories = null; } // if (deep) } /** * Removes this object from datastore and sets delete attribute. * * @param ConnectionInterface $con * @return void * @throws PropelException * @see Product::setDeleted() * @see Product::isDeleted() */ public function delete(ConnectionInterface $con = null) { if ($this->isDeleted()) { throw new PropelException("This object has already been deleted."); } if ($con === null) { $con = Propel::getServiceContainer()->getWriteConnection(ProductTableMap::DATABASE_NAME); } $con->transaction(function () use ($con) { $deleteQuery = ChildProductQuery::create() ->filterByPrimaryKey($this->getPrimaryKey()); $ret = $this->preDelete($con); if ($ret) { $deleteQuery->delete($con); $this->postDelete($con); $this->setDeleted(true); } }); } /** * 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 ConnectionInterface $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(ConnectionInterface $con = null) { if ($this->isDeleted()) { throw new PropelException("You cannot save an object that has been deleted."); } if ($con === null) { $con = Propel::getServiceContainer()->getWriteConnection(ProductTableMap::DATABASE_NAME); } return $con->transaction(function () use ($con) { $isInsert = $this->isNew(); $ret = $this->preSave($con); 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); ProductTableMap::addInstanceToPool($this); } else { $affectedRows = 0; } return $affectedRows; }); } /** * 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 ConnectionInterface $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(ConnectionInterface $con) { $affectedRows = 0; // initialize var to track total num of affected rows if (!$this->alreadyInSave) { $this->alreadyInSave = true; if ($this->isNew() || $this->isModified()) { // persist changes if ($this->isNew()) { $this->doInsert($con); $affectedRows += 1; } else { $affectedRows += $this->doUpdate($con); } $this->resetModified(); } if ($this->categoriesScheduledForDeletion !== null) { if (!$this->categoriesScheduledForDeletion->isEmpty()) { $pks = array(); foreach ($this->categoriesScheduledForDeletion as $entry) { $entryPk = []; $entryPk[0] = $this->getId(); $entryPk[1] = $entry->getId(); $pks[] = $entryPk; } \ProductCategoryQuery::create() ->filterByPrimaryKeys($pks) ->delete($con); $this->categoriesScheduledForDeletion = null; } } if ($this->collCategories) { foreach ($this->collCategories as $category) { if (!$category->isDeleted() && ($category->isNew() || $category->isModified())) { $category->save($con); } } } if ($this->productCategoriesScheduledForDeletion !== null) { if (!$this->productCategoriesScheduledForDeletion->isEmpty()) { \ProductCategoryQuery::create() ->filterByPrimaryKeys($this->productCategoriesScheduledForDeletion->getPrimaryKeys(false)) ->delete($con); $this->productCategoriesScheduledForDeletion = null; } } if ($this->collProductCategories !== null) { foreach ($this->collProductCategories as $referrerFK) { if (!$referrerFK->isDeleted() && ($referrerFK->isNew() || $referrerFK->isModified())) { $affectedRows += $referrerFK->save($con); } } } $this->alreadyInSave = false; } return $affectedRows; } // doSave() /** * Insert the row in the database. * * @param ConnectionInterface $con * * @throws PropelException * @see doSave() */ protected function doInsert(ConnectionInterface $con) { $modifiedColumns = array(); $index = 0; $this->modifiedColumns[ProductTableMap::COL_ID] = true; if (null !== $this->id) { throw new PropelException('Cannot insert a value for auto-increment primary key (' . ProductTableMap::COL_ID . ')'); } // check the columns in natural order for more readable SQL queries if ($this->isColumnModified(ProductTableMap::COL_ID)) { $modifiedColumns[':p' . $index++] = 'id'; } if ($this->isColumnModified(ProductTableMap::COL_NAME)) { $modifiedColumns[':p' . $index++] = 'name'; } if ($this->isColumnModified(ProductTableMap::COL_PRICE)) { $modifiedColumns[':p' . $index++] = 'price'; } if ($this->isColumnModified(ProductTableMap::COL_WIDTH)) { $modifiedColumns[':p' . $index++] = 'width'; } if ($this->isColumnModified(ProductTableMap::COL_HEIGHT)) { $modifiedColumns[':p' . $index++] = 'height'; } if ($this->isColumnModified(ProductTableMap::COL_DESCRIPTION)) { $modifiedColumns[':p' . $index++] = 'description'; } $sql = sprintf( 'INSERT INTO product (%s) VALUES (%s)', implode(', ', $modifiedColumns), implode(', ', array_keys($modifiedColumns)) ); try { $stmt = $con->prepare($sql); foreach ($modifiedColumns as $identifier => $columnName) { switch ($columnName) { case 'id': $stmt->bindValue($identifier, $this->id, PDO::PARAM_INT); break; case 'name': $stmt->bindValue($identifier, $this->name, PDO::PARAM_STR); break; case 'price': $stmt->bindValue($identifier, $this->price, PDO::PARAM_STR); break; case 'width': $stmt->bindValue($identifier, $this->width, PDO::PARAM_INT); break; case 'height': $stmt->bindValue($identifier, $this->height, PDO::PARAM_INT); break; case 'description': $stmt->bindValue($identifier, $this->description, PDO::PARAM_STR); break; } } $stmt->execute(); } catch (Exception $e) { Propel::log($e->getMessage(), Propel::LOG_ERR); throw new PropelException(sprintf('Unable to execute INSERT statement [%s]', $sql), 0, $e); } try { $pk = $con->lastInsertId(); } catch (Exception $e) { throw new PropelException('Unable to get autoincrement id.', 0, $e); } $this->setId($pk); $this->setNew(false); } /** * Update the row in the database. * * @param ConnectionInterface $con * * @return Integer Number of updated rows * @see doSave() */ protected function doUpdate(ConnectionInterface $con) { $selectCriteria = $this->buildPkeyCriteria(); $valuesCriteria = $this->buildCriteria(); return $selectCriteria->doUpdate($valuesCriteria, $con); } /** * 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 TableMap::TYPE_PHPNAME, TableMap::TYPE_CAMELNAME * TableMap::TYPE_COLNAME, TableMap::TYPE_FIELDNAME, TableMap::TYPE_NUM. * Defaults to TableMap::TYPE_PHPNAME. * @return mixed Value of field. */ public function getByName($name, $type = TableMap::TYPE_PHPNAME) { $pos = ProductTableMap::translateFieldName($name, $type, TableMap::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->getName(); break; case 2: return $this->getPrice(); break; case 3: return $this->getWidth(); break; case 4: return $this->getHeight(); break; case 5: return $this->getDescription(); 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 TableMap::TYPE_PHPNAME, TableMap::TYPE_CAMELNAME, * TableMap::TYPE_COLNAME, TableMap::TYPE_FIELDNAME, TableMap::TYPE_NUM. * Defaults to TableMap::TYPE_PHPNAME. * @param boolean $includeLazyLoadColumns (optional) Whether to include lazy loaded columns. Defaults to TRUE. * @param array $alreadyDumpedObjects List of objects to skip to avoid recursion * @param boolean $includeForeignObjects (optional) Whether to include hydrated related objects. Default to FALSE. * * @return array an associative array containing the field names (as keys) and field values */ public function toArray($keyType = TableMap::TYPE_PHPNAME, $includeLazyLoadColumns = true, $alreadyDumpedObjects = array(), $includeForeignObjects = false) { if (isset($alreadyDumpedObjects['Product'][$this->hashCode()])) { return '*RECURSION*'; } $alreadyDumpedObjects['Product'][$this->hashCode()] = true; $keys = ProductTableMap::getFieldNames($keyType); $result = array( $keys[0] => $this->getId(), $keys[1] => $this->getName(), $keys[2] => $this->getPrice(), $keys[3] => $this->getWidth(), $keys[4] => $this->getHeight(), $keys[5] => $this->getDescription(), ); $virtualColumns = $this->virtualColumns; foreach ($virtualColumns as $key => $virtualColumn) { $result[$key] = $virtualColumn; } if ($includeForeignObjects) { if (null !== $this->collProductCategories) { switch ($keyType) { case TableMap::TYPE_CAMELNAME: $key = 'productCategories'; break; case TableMap::TYPE_FIELDNAME: $key = 'product_categories'; break; default: $key = 'ProductCategories'; } $result[$key] = $this->collProductCategories->toArray(null, false, $keyType, $includeLazyLoadColumns, $alreadyDumpedObjects); } } return $result; } /** * Sets a field from the object by name passed in as a string. * * @param string $name * @param mixed $value field value * @param string $type The type of fieldname the $name is of: * one of the class type constants TableMap::TYPE_PHPNAME, TableMap::TYPE_CAMELNAME * TableMap::TYPE_COLNAME, TableMap::TYPE_FIELDNAME, TableMap::TYPE_NUM. * Defaults to TableMap::TYPE_PHPNAME. * @return $this|\Product */ public function setByName($name, $value, $type = TableMap::TYPE_PHPNAME) { $pos = ProductTableMap::translateFieldName($name, $type, TableMap::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 $this|\Product */ public function setByPosition($pos, $value) { switch ($pos) { case 0: $this->setId($value); break; case 1: $this->setName($value); break; case 2: $this->setPrice($value); break; case 3: $this->setWidth($value); break; case 4: $this->setHeight($value); break; case 5: $this->setDescription($value); break; } // switch() return $this; } /** * 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 TableMap::TYPE_PHPNAME, TableMap::TYPE_CAMELNAME, * TableMap::TYPE_COLNAME, TableMap::TYPE_FIELDNAME, TableMap::TYPE_NUM. * The default key type is the column's TableMap::TYPE_PHPNAME. * * @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 = TableMap::TYPE_PHPNAME) { $keys = ProductTableMap::getFieldNames($keyType); if (array_key_exists($keys[0], $arr)) { $this->setId($arr[$keys[0]]); } if (array_key_exists($keys[1], $arr)) { $this->setName($arr[$keys[1]]); } if (array_key_exists($keys[2], $arr)) { $this->setPrice($arr[$keys[2]]); } if (array_key_exists($keys[3], $arr)) { $this->setWidth($arr[$keys[3]]); } if (array_key_exists($keys[4], $arr)) { $this->setHeight($arr[$keys[4]]); } if (array_key_exists($keys[5], $arr)) { $this->setDescription($arr[$keys[5]]); } } /** * Populate the current object from a string, using a given parser format * * $book = new Book(); * $book->importFrom('JSON', '{"Id":9012,"Title":"Don Juan","ISBN":"0140422161","Price":12.99,"PublisherId":1234,"AuthorId":5678}'); * * * You can specify the key type of the array by additionally passing one * of the class type constants TableMap::TYPE_PHPNAME, TableMap::TYPE_CAMELNAME, * TableMap::TYPE_COLNAME, TableMap::TYPE_FIELDNAME, TableMap::TYPE_NUM. * The default key type is the column's TableMap::TYPE_PHPNAME. * * @param mixed $parser A AbstractParser instance, * or a format name ('XML', 'YAML', 'JSON', 'CSV') * @param string $data The source data to import from * @param string $keyType The type of keys the array uses. * * @return $this|\Product The current object, for fluid interface */ public function importFrom($parser, $data, $keyType = TableMap::TYPE_PHPNAME) { if (!$parser instanceof AbstractParser) { $parser = AbstractParser::getParser($parser); } $this->fromArray($parser->toArray($data), $keyType); return $this; } /** * 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(ProductTableMap::DATABASE_NAME); if ($this->isColumnModified(ProductTableMap::COL_ID)) { $criteria->add(ProductTableMap::COL_ID, $this->id); } if ($this->isColumnModified(ProductTableMap::COL_NAME)) { $criteria->add(ProductTableMap::COL_NAME, $this->name); } if ($this->isColumnModified(ProductTableMap::COL_PRICE)) { $criteria->add(ProductTableMap::COL_PRICE, $this->price); } if ($this->isColumnModified(ProductTableMap::COL_WIDTH)) { $criteria->add(ProductTableMap::COL_WIDTH, $this->width); } if ($this->isColumnModified(ProductTableMap::COL_HEIGHT)) { $criteria->add(ProductTableMap::COL_HEIGHT, $this->height); } if ($this->isColumnModified(ProductTableMap::COL_DESCRIPTION)) { $criteria->add(ProductTableMap::COL_DESCRIPTION, $this->description); } 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. * * @throws LogicException if no primary key is defined * * @return Criteria The Criteria object containing value(s) for primary key(s). */ public function buildPkeyCriteria() { $criteria = ChildProductQuery::create(); $criteria->add(ProductTableMap::COL_ID, $this->id); return $criteria; } /** * If the primary key is not null, return the hashcode of the * primary key. Otherwise, return the hash code of the object. * * @return int Hashcode */ public function hashCode() { $validPk = null !== $this->getId(); $validPrimaryKeyFKs = 0; $primaryKeyFKs = []; if ($validPk) { return crc32(json_encode($this->getPrimaryKey(), JSON_UNESCAPED_UNICODE)); } elseif ($validPrimaryKeyFKs) { return crc32(json_encode($primaryKeyFKs, JSON_UNESCAPED_UNICODE)); } return spl_object_hash($this); } /** * 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); } /** * Returns true if the primary key for this object is null. * @return boolean */ public function isPrimaryKeyNull() { return null === $this->getId(); } /** * 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. * @param boolean $makeNew Whether to reset autoincrement PKs and make the object new. * @throws PropelException */ public function copyInto($copyObj, $deepCopy = false, $makeNew = true) { $copyObj->setName($this->getName()); $copyObj->setPrice($this->getPrice()); $copyObj->setWidth($this->getWidth()); $copyObj->setHeight($this->getHeight()); $copyObj->setDescription($this->getDescription()); 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->getProductCategories() as $relObj) { if ($relObj !== $this) { // ensure that we don't try to copy a reference to ourselves $copyObj->addProductCategory($relObj->copy($deepCopy)); } } } // if ($deepCopy) if ($makeNew) { $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; } /** * Initializes a collection based on the name of a relation. * Avoids crafting an 'init[$relationName]s' method name * that wouldn't work when StandardEnglishPluralizer is used. * * @param string $relationName The name of the relation to initialize * @return void */ public function initRelation($relationName) { if ('ProductCategory' == $relationName) { return $this->initProductCategories(); } } /** * Clears out the collProductCategories collection * * 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 addProductCategories() */ public function clearProductCategories() { $this->collProductCategories = null; // important to set this to NULL since that means it is uninitialized } /** * Reset is the collProductCategories collection loaded partially. */ public function resetPartialProductCategories($v = true) { $this->collProductCategoriesPartial = $v; } /** * Initializes the collProductCategories collection. * * By default this just sets the collProductCategories collection to an empty array (like clearcollProductCategories()); * 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. * * @param boolean $overrideExisting If set to true, the method call initializes * the collection even if it is not empty * * @return void */ public function initProductCategories($overrideExisting = true) { if (null !== $this->collProductCategories && !$overrideExisting) { return; } $this->collProductCategories = new ObjectCollection(); $this->collProductCategories->setModel('\ProductCategory'); } /** * Gets an array of ChildProductCategory objects which contain a foreign key that references this object. * * If the $criteria is not null, it is used to always fetch the results from the database. * Otherwise the results are fetched from the database the first time, then cached. * Next time the same method is called without $criteria, the cached collection is returned. * If this ChildProduct is new, it will return * an empty collection or the current collection; the criteria is ignored on a new object. * * @param Criteria $criteria optional Criteria object to narrow the query * @param ConnectionInterface $con optional connection object * @return ObjectCollection|ChildProductCategory[] List of ChildProductCategory objects * @throws PropelException */ public function getProductCategories(Criteria $criteria = null, ConnectionInterface $con = null) { $partial = $this->collProductCategoriesPartial && !$this->isNew(); if (null === $this->collProductCategories || null !== $criteria || $partial) { if ($this->isNew() && null === $this->collProductCategories) { // return empty collection $this->initProductCategories(); } else { $collProductCategories = ChildProductCategoryQuery::create(null, $criteria) ->filterByProduct($this) ->find($con); if (null !== $criteria) { if (false !== $this->collProductCategoriesPartial && count($collProductCategories)) { $this->initProductCategories(false); foreach ($collProductCategories as $obj) { if (false == $this->collProductCategories->contains($obj)) { $this->collProductCategories->append($obj); } } $this->collProductCategoriesPartial = true; } return $collProductCategories; } if ($partial && $this->collProductCategories) { foreach ($this->collProductCategories as $obj) { if ($obj->isNew()) { $collProductCategories[] = $obj; } } } $this->collProductCategories = $collProductCategories; $this->collProductCategoriesPartial = false; } } return $this->collProductCategories; } /** * Sets a collection of ChildProductCategory objects related by a one-to-many relationship * to the current object. * It will also schedule objects for deletion based on a diff between old objects (aka persisted) * and new objects from the given Propel collection. * * @param Collection $productCategories A Propel collection. * @param ConnectionInterface $con Optional connection object * @return $this|ChildProduct The current object (for fluent API support) */ public function setProductCategories(Collection $productCategories, ConnectionInterface $con = null) { /** @var ChildProductCategory[] $productCategoriesToDelete */ $productCategoriesToDelete = $this->getProductCategories(new Criteria(), $con)->diff($productCategories); //since at least one column in the foreign key is at the same time a PK //we can not just set a PK to NULL in the lines below. We have to store //a backup of all values, so we are able to manipulate these items based on the onDelete value later. $this->productCategoriesScheduledForDeletion = clone $productCategoriesToDelete; foreach ($productCategoriesToDelete as $productCategoryRemoved) { $productCategoryRemoved->setProduct(null); } $this->collProductCategories = null; foreach ($productCategories as $productCategory) { $this->addProductCategory($productCategory); } $this->collProductCategories = $productCategories; $this->collProductCategoriesPartial = false; return $this; } /** * Returns the number of related ProductCategory objects. * * @param Criteria $criteria * @param boolean $distinct * @param ConnectionInterface $con * @return int Count of related ProductCategory objects. * @throws PropelException */ public function countProductCategories(Criteria $criteria = null, $distinct = false, ConnectionInterface $con = null) { $partial = $this->collProductCategoriesPartial && !$this->isNew(); if (null === $this->collProductCategories || null !== $criteria || $partial) { if ($this->isNew() && null === $this->collProductCategories) { return 0; } if ($partial && !$criteria) { return count($this->getProductCategories()); } $query = ChildProductCategoryQuery::create(null, $criteria); if ($distinct) { $query->distinct(); } return $query ->filterByProduct($this) ->count($con); } return count($this->collProductCategories); } /** * Method called to associate a ChildProductCategory object to this object * through the ChildProductCategory foreign key attribute. * * @param ChildProductCategory $l ChildProductCategory * @return $this|\Product The current object (for fluent API support) */ public function addProductCategory(ChildProductCategory $l) { if ($this->collProductCategories === null) { $this->initProductCategories(); $this->collProductCategoriesPartial = true; } if (!$this->collProductCategories->contains($l)) { $this->doAddProductCategory($l); } return $this; } /** * @param ChildProductCategory $productCategory The ChildProductCategory object to add. */ protected function doAddProductCategory(ChildProductCategory $productCategory) { $this->collProductCategories[]= $productCategory; $productCategory->setProduct($this); } /** * @param ChildProductCategory $productCategory The ChildProductCategory object to remove. * @return $this|ChildProduct The current object (for fluent API support) */ public function removeProductCategory(ChildProductCategory $productCategory) { if ($this->getProductCategories()->contains($productCategory)) { $pos = $this->collProductCategories->search($productCategory); $this->collProductCategories->remove($pos); if (null === $this->productCategoriesScheduledForDeletion) { $this->productCategoriesScheduledForDeletion = clone $this->collProductCategories; $this->productCategoriesScheduledForDeletion->clear(); } $this->productCategoriesScheduledForDeletion[]= clone $productCategory; $productCategory->setProduct(null); } return $this; } /** * If this collection has already been initialized with * an identical criteria, it returns the collection. * Otherwise if this Product is new, it will return * an empty collection; or if this Product has previously * been saved, it will retrieve related ProductCategories 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 Product. * * @param Criteria $criteria optional Criteria object to narrow the query * @param ConnectionInterface $con optional connection object * @param string $joinBehavior optional join type to use (defaults to Criteria::LEFT_JOIN) * @return ObjectCollection|ChildProductCategory[] List of ChildProductCategory objects */ public function getProductCategoriesJoinCategory(Criteria $criteria = null, ConnectionInterface $con = null, $joinBehavior = Criteria::LEFT_JOIN) { $query = ChildProductCategoryQuery::create(null, $criteria); $query->joinWith('Category', $joinBehavior); return $this->getProductCategories($query, $con); } /** * Clears out the collCategories collection * * 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 addCategories() */ public function clearCategories() { $this->collCategories = null; // important to set this to NULL since that means it is uninitialized } /** * Initializes the collCategories crossRef collection. * * By default this just sets the collCategories collection to an empty collection (like clearCategories()); * 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 initCategories() { $this->collCategories = new ObjectCollection(); $this->collCategoriesPartial = true; $this->collCategories->setModel('\Category'); } /** * Checks if the collCategories collection is loaded. * * @return bool */ public function isCategoriesLoaded() { return null !== $this->collCategories; } /** * Gets a collection of ChildCategory objects related by a many-to-many relationship * to the current object by way of the product_category cross-reference table. * * If the $criteria is not null, it is used to always fetch the results from the database. * Otherwise the results are fetched from the database the first time, then cached. * Next time the same method is called without $criteria, the cached collection is returned. * If this ChildProduct is new, it will return * an empty collection or the current collection; the criteria is ignored on a new object. * * @param Criteria $criteria Optional query object to filter the query * @param ConnectionInterface $con Optional connection object * * @return ObjectCollection|ChildCategory[] List of ChildCategory objects */ public function getCategories(Criteria $criteria = null, ConnectionInterface $con = null) { $partial = $this->collCategoriesPartial && !$this->isNew(); if (null === $this->collCategories || null !== $criteria || $partial) { if ($this->isNew()) { // return empty collection if (null === $this->collCategories) { $this->initCategories(); } } else { $query = ChildCategoryQuery::create(null, $criteria) ->filterByProduct($this); $collCategories = $query->find($con); if (null !== $criteria) { return $collCategories; } if ($partial && $this->collCategories) { //make sure that already added objects gets added to the list of the database. foreach ($this->collCategories as $obj) { if (!$collCategories->contains($obj)) { $collCategories[] = $obj; } } } $this->collCategories = $collCategories; $this->collCategoriesPartial = false; } } return $this->collCategories; } /** * Sets a collection of Category objects related by a many-to-many relationship * to the current object by way of the product_category cross-reference table. * It will also schedule objects for deletion based on a diff between old objects (aka persisted) * and new objects from the given Propel collection. * * @param Collection $categories A Propel collection. * @param ConnectionInterface $con Optional connection object * @return $this|ChildProduct The current object (for fluent API support) */ public function setCategories(Collection $categories, ConnectionInterface $con = null) { $this->clearCategories(); $currentCategories = $this->getCategories(); $categoriesScheduledForDeletion = $currentCategories->diff($categories); foreach ($categoriesScheduledForDeletion as $toDelete) { $this->removeCategory($toDelete); } foreach ($categories as $category) { if (!$currentCategories->contains($category)) { $this->doAddCategory($category); } } $this->collCategoriesPartial = false; $this->collCategories = $categories; return $this; } /** * Gets the number of Category objects related by a many-to-many relationship * to the current object by way of the product_category cross-reference table. * * @param Criteria $criteria Optional query object to filter the query * @param boolean $distinct Set to true to force count distinct * @param ConnectionInterface $con Optional connection object * * @return int the number of related Category objects */ public function countCategories(Criteria $criteria = null, $distinct = false, ConnectionInterface $con = null) { $partial = $this->collCategoriesPartial && !$this->isNew(); if (null === $this->collCategories || null !== $criteria || $partial) { if ($this->isNew() && null === $this->collCategories) { return 0; } else { if ($partial && !$criteria) { return count($this->getCategories()); } $query = ChildCategoryQuery::create(null, $criteria); if ($distinct) { $query->distinct(); } return $query ->filterByProduct($this) ->count($con); } } else { return count($this->collCategories); } } /** * Associate a ChildCategory to this object * through the product_category cross reference table. * * @param ChildCategory $category * @return ChildProduct The current object (for fluent API support) */ public function addCategory(ChildCategory $category) { if ($this->collCategories === null) { $this->initCategories(); } if (!$this->getCategories()->contains($category)) { // only add it if the **same** object is not already associated $this->collCategories->push($category); $this->doAddCategory($category); } return $this; } /** * * @param ChildCategory $category */ protected function doAddCategory(ChildCategory $category) { $productCategory = new ChildProductCategory(); $productCategory->setCategory($category); $productCategory->setProduct($this); $this->addProductCategory($productCategory); // set the back reference to this object directly as using provided method either results // in endless loop or in multiple relations if (!$category->isProductsLoaded()) { $category->initProducts(); $category->getProducts()->push($this); } elseif (!$category->getProducts()->contains($this)) { $category->getProducts()->push($this); } } /** * Remove category of this object * through the product_category cross reference table. * * @param ChildCategory $category * @return ChildProduct The current object (for fluent API support) */ public function removeCategory(ChildCategory $category) { if ($this->getCategories()->contains($category)) { $productCategory = new ChildProductCategory(); $productCategory->setCategory($category); if ($category->isProductsLoaded()) { //remove the back reference if available $category->getProducts()->removeObject($this); } $productCategory->setProduct($this); $this->removeProductCategory(clone $productCategory); $productCategory->clear(); $this->collCategories->remove($this->collCategories->search($category)); if (null === $this->categoriesScheduledForDeletion) { $this->categoriesScheduledForDeletion = clone $this->collCategories; $this->categoriesScheduledForDeletion->clear(); } $this->categoriesScheduledForDeletion->push($category); } return $this; } /** * Clears the current object, sets all attributes to their default values and removes * outgoing references as well as back-references (from other objects to this one. Results probably in a database * change of those foreign objects when you call `save` there). */ public function clear() { $this->id = null; $this->name = null; $this->price = null; $this->width = null; $this->height = null; $this->description = null; $this->alreadyInSave = false; $this->clearAllReferences(); $this->resetModified(); $this->setNew(true); $this->setDeleted(false); } /** * Resets all references and back-references to other model objects or collections of model objects. * * This method is used to reset all php object references (not the actual reference in the database). * Necessary for object serialisation. * * @param boolean $deep Whether to also clear the references on all referrer objects. */ public function clearAllReferences($deep = false) { if ($deep) { if ($this->collProductCategories) { foreach ($this->collProductCategories as $o) { $o->clearAllReferences($deep); } } if ($this->collCategories) { foreach ($this->collCategories as $o) { $o->clearAllReferences($deep); } } } // if ($deep) $this->collProductCategories = null; $this->collCategories = null; } /** * Return the string representation of this object * * @return string */ public function __toString() { return (string) $this->exportTo(ProductTableMap::DEFAULT_STRING_FORMAT); } /** * Code to be run before persisting the object * @param ConnectionInterface $con * @return boolean */ public function preSave(ConnectionInterface $con = null) { return true; } /** * Code to be run after persisting the object * @param ConnectionInterface $con */ public function postSave(ConnectionInterface $con = null) { } /** * Code to be run before inserting to database * @param ConnectionInterface $con * @return boolean */ public function preInsert(ConnectionInterface $con = null) { return true; } /** * Code to be run after inserting to database * @param ConnectionInterface $con */ public function postInsert(ConnectionInterface $con = null) { } /** * Code to be run before updating the object in database * @param ConnectionInterface $con * @return boolean */ public function preUpdate(ConnectionInterface $con = null) { return true; } /** * Code to be run after updating the object in database * @param ConnectionInterface $con */ public function postUpdate(ConnectionInterface $con = null) { } /** * Code to be run before deleting the object in database * @param ConnectionInterface $con * @return boolean */ public function preDelete(ConnectionInterface $con = null) { return true; } /** * Code to be run after deleting the object in database * @param ConnectionInterface $con */ public function postDelete(ConnectionInterface $con = null) { } /** * Derived method to catches calls to undefined methods. * * Provides magic import/export method support (fromXML()/toXML(), fromYAML()/toYAML(), etc.). * Allows to define default __call() behavior if you overwrite __call() * * @param string $name * @param mixed $params * * @return array|string */ public function __call($name, $params) { if (0 === strpos($name, 'get')) { $virtualColumn = substr($name, 3); if ($this->hasVirtualColumn($virtualColumn)) { return $this->getVirtualColumn($virtualColumn); } $virtualColumn = lcfirst($virtualColumn); if ($this->hasVirtualColumn($virtualColumn)) { return $this->getVirtualColumn($virtualColumn); } } if (0 === strpos($name, 'from')) { $format = substr($name, 4); return $this->importFrom($format, reset($params)); } if (0 === strpos($name, 'to')) { $format = substr($name, 2); $includeLazyLoadColumns = isset($params[0]) ? $params[0] : true; return $this->exportTo($format, $includeLazyLoadColumns); } throw new BadMethodCallException(sprintf('Call to undefined method: %s.', $name)); } }