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));
}
}