3050 lines
101 KiB
PHP
3050 lines
101 KiB
PHP
<?php
|
|
|
|
namespace Trinity\Bundle\MediaBundle\Model\om;
|
|
|
|
use \BaseObject;
|
|
use \BasePeer;
|
|
use \Criteria;
|
|
use \DateTime;
|
|
use \Exception;
|
|
use \PDO;
|
|
use \Persistent;
|
|
use \Propel;
|
|
use \PropelCollection;
|
|
use \PropelDateTime;
|
|
use \PropelException;
|
|
use \PropelObjectCollection;
|
|
use \PropelPDO;
|
|
use Trinity\Bundle\MediaBundle\Model\Category;
|
|
use Trinity\Bundle\MediaBundle\Model\CategoryPeer;
|
|
use Trinity\Bundle\MediaBundle\Model\CategoryQuery;
|
|
use Trinity\Bundle\MediaBundle\Model\Media;
|
|
use Trinity\Bundle\MediaBundle\Model\MediaQuery;
|
|
|
|
abstract class BaseCategory extends BaseObject implements Persistent
|
|
{
|
|
/**
|
|
* Peer class name
|
|
*/
|
|
const PEER = 'Trinity\\Bundle\\MediaBundle\\Model\\CategoryPeer';
|
|
|
|
/**
|
|
* The Peer class.
|
|
* Instance provides a convenient way of calling static methods on a class
|
|
* that calling code may not be able to identify.
|
|
* @var CategoryPeer
|
|
*/
|
|
protected static $peer;
|
|
|
|
/**
|
|
* The flag var to prevent infinit loop in deep copy
|
|
* @var boolean
|
|
*/
|
|
protected $startCopy = false;
|
|
|
|
/**
|
|
* The value for the id field.
|
|
* @var int
|
|
*/
|
|
protected $id;
|
|
|
|
/**
|
|
* The value for the label field.
|
|
* @var string
|
|
*/
|
|
protected $label;
|
|
|
|
/**
|
|
* The value for the category_id field.
|
|
* @var int
|
|
*/
|
|
protected $category_id;
|
|
|
|
/**
|
|
* The value for the created_at field.
|
|
* @var string
|
|
*/
|
|
protected $created_at;
|
|
|
|
/**
|
|
* The value for the updated_at field.
|
|
* @var string
|
|
*/
|
|
protected $updated_at;
|
|
|
|
/**
|
|
* The value for the slug field.
|
|
* @var string
|
|
*/
|
|
protected $slug;
|
|
|
|
/**
|
|
* The value for the tree_left field.
|
|
* @var int
|
|
*/
|
|
protected $tree_left;
|
|
|
|
/**
|
|
* The value for the tree_right field.
|
|
* @var int
|
|
*/
|
|
protected $tree_right;
|
|
|
|
/**
|
|
* The value for the tree_level field.
|
|
* @var int
|
|
*/
|
|
protected $tree_level;
|
|
|
|
/**
|
|
* @var Category
|
|
*/
|
|
protected $aCategoryRelatedByCategoryId;
|
|
|
|
/**
|
|
* @var PropelObjectCollection|Media[] Collection to store aggregation of Media objects.
|
|
*/
|
|
protected $collMedias;
|
|
protected $collMediasPartial;
|
|
|
|
/**
|
|
* @var PropelObjectCollection|Category[] Collection to store aggregation of Category objects.
|
|
*/
|
|
protected $collCategoriesRelatedById;
|
|
protected $collCategoriesRelatedByIdPartial;
|
|
|
|
/**
|
|
* Flag to prevent endless save loop, if this object is referenced
|
|
* by another object which falls in this transaction.
|
|
* @var boolean
|
|
*/
|
|
protected $alreadyInSave = false;
|
|
|
|
/**
|
|
* Flag to prevent endless validation loop, if this object is referenced
|
|
* by another object which falls in this transaction.
|
|
* @var boolean
|
|
*/
|
|
protected $alreadyInValidation = false;
|
|
|
|
/**
|
|
* Flag to prevent endless clearAllReferences($deep=true) loop, if this object is referenced
|
|
* @var boolean
|
|
*/
|
|
protected $alreadyInClearAllReferencesDeep = false;
|
|
|
|
// nested_set behavior
|
|
|
|
/**
|
|
* Queries to be executed in the save transaction
|
|
* @var array
|
|
*/
|
|
protected $nestedSetQueries = array();
|
|
|
|
/**
|
|
* Internal cache for children nodes
|
|
* @var null|PropelObjectCollection
|
|
*/
|
|
protected $collNestedSetChildren = null;
|
|
|
|
/**
|
|
* Internal cache for parent node
|
|
* @var null|Category
|
|
*/
|
|
protected $aNestedSetParent = null;
|
|
|
|
|
|
/**
|
|
* An array of objects scheduled for deletion.
|
|
* @var PropelObjectCollection
|
|
*/
|
|
protected $mediasScheduledForDeletion = null;
|
|
|
|
/**
|
|
* An array of objects scheduled for deletion.
|
|
* @var PropelObjectCollection
|
|
*/
|
|
protected $categoriesRelatedByIdScheduledForDeletion = null;
|
|
|
|
/**
|
|
* Get the [id] column value.
|
|
*
|
|
* @return int
|
|
*/
|
|
public function getId()
|
|
{
|
|
return $this->id;
|
|
}
|
|
|
|
/**
|
|
* Get the [label] column value.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getLabel()
|
|
{
|
|
return $this->label;
|
|
}
|
|
|
|
/**
|
|
* Get the [category_id] column value.
|
|
*
|
|
* @return int
|
|
*/
|
|
public function getCategoryId()
|
|
{
|
|
return $this->category_id;
|
|
}
|
|
|
|
/**
|
|
* Get the [optionally formatted] temporal [created_at] column value.
|
|
*
|
|
*
|
|
* @param string $format The date/time format string (either date()-style or strftime()-style).
|
|
* If format is null, then the raw DateTime object will be returned.
|
|
* @return mixed Formatted date/time value as string or DateTime object (if format is null), null if column is null, and 0 if column value is 0000-00-00 00:00:00
|
|
* @throws PropelException - if unable to parse/validate the date/time value.
|
|
*/
|
|
public function getCreatedAt($format = null)
|
|
{
|
|
if ($this->created_at === null) {
|
|
return null;
|
|
}
|
|
|
|
if ($this->created_at === '0000-00-00 00:00:00') {
|
|
// while technically this is not a default value of null,
|
|
// this seems to be closest in meaning.
|
|
return null;
|
|
}
|
|
|
|
try {
|
|
$dt = new DateTime($this->created_at);
|
|
} catch (Exception $x) {
|
|
throw new PropelException("Internally stored date/time/timestamp value could not be converted to DateTime: " . var_export($this->created_at, true), $x);
|
|
}
|
|
|
|
if ($format === null) {
|
|
// Because propel.useDateTimeClass is true, we return a DateTime object.
|
|
return $dt;
|
|
}
|
|
|
|
if (strpos($format, '%') !== false) {
|
|
return strftime($format, $dt->format('U'));
|
|
}
|
|
|
|
return $dt->format($format);
|
|
|
|
}
|
|
|
|
/**
|
|
* Get the [optionally formatted] temporal [updated_at] column value.
|
|
*
|
|
*
|
|
* @param string $format The date/time format string (either date()-style or strftime()-style).
|
|
* If format is null, then the raw DateTime object will be returned.
|
|
* @return mixed Formatted date/time value as string or DateTime object (if format is null), null if column is null, and 0 if column value is 0000-00-00 00:00:00
|
|
* @throws PropelException - if unable to parse/validate the date/time value.
|
|
*/
|
|
public function getUpdatedAt($format = null)
|
|
{
|
|
if ($this->updated_at === null) {
|
|
return null;
|
|
}
|
|
|
|
if ($this->updated_at === '0000-00-00 00:00:00') {
|
|
// while technically this is not a default value of null,
|
|
// this seems to be closest in meaning.
|
|
return null;
|
|
}
|
|
|
|
try {
|
|
$dt = new DateTime($this->updated_at);
|
|
} catch (Exception $x) {
|
|
throw new PropelException("Internally stored date/time/timestamp value could not be converted to DateTime: " . var_export($this->updated_at, true), $x);
|
|
}
|
|
|
|
if ($format === null) {
|
|
// Because propel.useDateTimeClass is true, we return a DateTime object.
|
|
return $dt;
|
|
}
|
|
|
|
if (strpos($format, '%') !== false) {
|
|
return strftime($format, $dt->format('U'));
|
|
}
|
|
|
|
return $dt->format($format);
|
|
|
|
}
|
|
|
|
/**
|
|
* Get the [slug] column value.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getSlug()
|
|
{
|
|
return $this->slug;
|
|
}
|
|
|
|
/**
|
|
* Get the [tree_left] column value.
|
|
*
|
|
* @return int
|
|
*/
|
|
public function getTreeLeft()
|
|
{
|
|
return $this->tree_left;
|
|
}
|
|
|
|
/**
|
|
* Get the [tree_right] column value.
|
|
*
|
|
* @return int
|
|
*/
|
|
public function getTreeRight()
|
|
{
|
|
return $this->tree_right;
|
|
}
|
|
|
|
/**
|
|
* Get the [tree_level] column value.
|
|
*
|
|
* @return int
|
|
*/
|
|
public function getTreeLevel()
|
|
{
|
|
return $this->tree_level;
|
|
}
|
|
|
|
/**
|
|
* Set the value of [id] column.
|
|
*
|
|
* @param int $v new value
|
|
* @return Category The current object (for fluent API support)
|
|
*/
|
|
public function setId($v)
|
|
{
|
|
if ($v !== null && is_numeric($v)) {
|
|
$v = (int) $v;
|
|
}
|
|
|
|
if ($this->id !== $v) {
|
|
$this->id = $v;
|
|
$this->modifiedColumns[] = CategoryPeer::ID;
|
|
}
|
|
|
|
|
|
return $this;
|
|
} // setId()
|
|
|
|
/**
|
|
* Set the value of [label] column.
|
|
*
|
|
* @param string $v new value
|
|
* @return Category The current object (for fluent API support)
|
|
*/
|
|
public function setLabel($v)
|
|
{
|
|
if ($v !== null && is_numeric($v)) {
|
|
$v = (string) $v;
|
|
}
|
|
|
|
if ($this->label !== $v) {
|
|
$this->label = $v;
|
|
$this->modifiedColumns[] = CategoryPeer::LABEL;
|
|
}
|
|
|
|
|
|
return $this;
|
|
} // setLabel()
|
|
|
|
/**
|
|
* Set the value of [category_id] column.
|
|
*
|
|
* @param int $v new value
|
|
* @return Category The current object (for fluent API support)
|
|
*/
|
|
public function setCategoryId($v)
|
|
{
|
|
if ($v !== null && is_numeric($v)) {
|
|
$v = (int) $v;
|
|
}
|
|
|
|
if ($this->category_id !== $v) {
|
|
$this->category_id = $v;
|
|
$this->modifiedColumns[] = CategoryPeer::CATEGORY_ID;
|
|
}
|
|
|
|
if ($this->aCategoryRelatedByCategoryId !== null && $this->aCategoryRelatedByCategoryId->getId() !== $v) {
|
|
$this->aCategoryRelatedByCategoryId = null;
|
|
}
|
|
|
|
|
|
return $this;
|
|
} // setCategoryId()
|
|
|
|
/**
|
|
* Sets the value of [created_at] column to a normalized version of the date/time value specified.
|
|
*
|
|
* @param mixed $v string, integer (timestamp), or DateTime value.
|
|
* Empty strings are treated as null.
|
|
* @return Category The current object (for fluent API support)
|
|
*/
|
|
public function setCreatedAt($v)
|
|
{
|
|
$dt = PropelDateTime::newInstance($v, null, 'DateTime');
|
|
if ($this->created_at !== null || $dt !== null) {
|
|
$currentDateAsString = ($this->created_at !== null && $tmpDt = new DateTime($this->created_at)) ? $tmpDt->format('Y-m-d H:i:s') : null;
|
|
$newDateAsString = $dt ? $dt->format('Y-m-d H:i:s') : null;
|
|
if ($currentDateAsString !== $newDateAsString) {
|
|
$this->created_at = $newDateAsString;
|
|
$this->modifiedColumns[] = CategoryPeer::CREATED_AT;
|
|
}
|
|
} // if either are not null
|
|
|
|
|
|
return $this;
|
|
} // setCreatedAt()
|
|
|
|
/**
|
|
* Sets the value of [updated_at] column to a normalized version of the date/time value specified.
|
|
*
|
|
* @param mixed $v string, integer (timestamp), or DateTime value.
|
|
* Empty strings are treated as null.
|
|
* @return Category The current object (for fluent API support)
|
|
*/
|
|
public function setUpdatedAt($v)
|
|
{
|
|
$dt = PropelDateTime::newInstance($v, null, 'DateTime');
|
|
if ($this->updated_at !== null || $dt !== null) {
|
|
$currentDateAsString = ($this->updated_at !== null && $tmpDt = new DateTime($this->updated_at)) ? $tmpDt->format('Y-m-d H:i:s') : null;
|
|
$newDateAsString = $dt ? $dt->format('Y-m-d H:i:s') : null;
|
|
if ($currentDateAsString !== $newDateAsString) {
|
|
$this->updated_at = $newDateAsString;
|
|
$this->modifiedColumns[] = CategoryPeer::UPDATED_AT;
|
|
}
|
|
} // if either are not null
|
|
|
|
|
|
return $this;
|
|
} // setUpdatedAt()
|
|
|
|
/**
|
|
* Set the value of [slug] column.
|
|
*
|
|
* @param string $v new value
|
|
* @return Category The current object (for fluent API support)
|
|
*/
|
|
public function setSlug($v)
|
|
{
|
|
if ($v !== null && is_numeric($v)) {
|
|
$v = (string) $v;
|
|
}
|
|
|
|
if ($this->slug !== $v) {
|
|
$this->slug = $v;
|
|
$this->modifiedColumns[] = CategoryPeer::SLUG;
|
|
}
|
|
|
|
|
|
return $this;
|
|
} // setSlug()
|
|
|
|
/**
|
|
* Set the value of [tree_left] column.
|
|
*
|
|
* @param int $v new value
|
|
* @return Category The current object (for fluent API support)
|
|
*/
|
|
public function setTreeLeft($v)
|
|
{
|
|
if ($v !== null && is_numeric($v)) {
|
|
$v = (int) $v;
|
|
}
|
|
|
|
if ($this->tree_left !== $v) {
|
|
$this->tree_left = $v;
|
|
$this->modifiedColumns[] = CategoryPeer::TREE_LEFT;
|
|
}
|
|
|
|
|
|
return $this;
|
|
} // setTreeLeft()
|
|
|
|
/**
|
|
* Set the value of [tree_right] column.
|
|
*
|
|
* @param int $v new value
|
|
* @return Category The current object (for fluent API support)
|
|
*/
|
|
public function setTreeRight($v)
|
|
{
|
|
if ($v !== null && is_numeric($v)) {
|
|
$v = (int) $v;
|
|
}
|
|
|
|
if ($this->tree_right !== $v) {
|
|
$this->tree_right = $v;
|
|
$this->modifiedColumns[] = CategoryPeer::TREE_RIGHT;
|
|
}
|
|
|
|
|
|
return $this;
|
|
} // setTreeRight()
|
|
|
|
/**
|
|
* Set the value of [tree_level] column.
|
|
*
|
|
* @param int $v new value
|
|
* @return Category The current object (for fluent API support)
|
|
*/
|
|
public function setTreeLevel($v)
|
|
{
|
|
if ($v !== null && is_numeric($v)) {
|
|
$v = (int) $v;
|
|
}
|
|
|
|
if ($this->tree_level !== $v) {
|
|
$this->tree_level = $v;
|
|
$this->modifiedColumns[] = CategoryPeer::TREE_LEVEL;
|
|
}
|
|
|
|
|
|
return $this;
|
|
} // setTreeLevel()
|
|
|
|
/**
|
|
* 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 PDOStatement->fetch(PDO::FETCH_NUM)
|
|
* @param int $startcol 0-based offset column which indicates which restultset column to start with.
|
|
* @param boolean $rehydrate Whether this object is being re-hydrated from the database.
|
|
* @return int next starting column
|
|
* @throws PropelException - Any caught Exception will be rewrapped as a PropelException.
|
|
*/
|
|
public function hydrate($row, $startcol = 0, $rehydrate = false)
|
|
{
|
|
try {
|
|
|
|
$this->id = ($row[$startcol + 0] !== null) ? (int) $row[$startcol + 0] : null;
|
|
$this->label = ($row[$startcol + 1] !== null) ? (string) $row[$startcol + 1] : null;
|
|
$this->category_id = ($row[$startcol + 2] !== null) ? (int) $row[$startcol + 2] : null;
|
|
$this->created_at = ($row[$startcol + 3] !== null) ? (string) $row[$startcol + 3] : null;
|
|
$this->updated_at = ($row[$startcol + 4] !== null) ? (string) $row[$startcol + 4] : null;
|
|
$this->slug = ($row[$startcol + 5] !== null) ? (string) $row[$startcol + 5] : null;
|
|
$this->tree_left = ($row[$startcol + 6] !== null) ? (int) $row[$startcol + 6] : null;
|
|
$this->tree_right = ($row[$startcol + 7] !== null) ? (int) $row[$startcol + 7] : null;
|
|
$this->tree_level = ($row[$startcol + 8] !== null) ? (int) $row[$startcol + 8] : null;
|
|
$this->resetModified();
|
|
|
|
$this->setNew(false);
|
|
|
|
if ($rehydrate) {
|
|
$this->ensureConsistency();
|
|
}
|
|
$this->postHydrate($row, $startcol, $rehydrate);
|
|
return $startcol + 9; // 9 = CategoryPeer::NUM_HYDRATE_COLUMNS.
|
|
|
|
} catch (Exception $e) {
|
|
throw new PropelException("Error populating Category object", $e);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Checks and repairs the internal consistency of the object.
|
|
*
|
|
* This method is executed after an already-instantiated object is re-hydrated
|
|
* from the database. It exists to check any foreign keys to make sure that
|
|
* the objects related to the current object are correct based on foreign key.
|
|
*
|
|
* You can override this method in the stub class, but you should always invoke
|
|
* the base method from the overridden method (i.e. parent::ensureConsistency()),
|
|
* in case your model changes.
|
|
*
|
|
* @throws PropelException
|
|
*/
|
|
public function ensureConsistency()
|
|
{
|
|
|
|
if ($this->aCategoryRelatedByCategoryId !== null && $this->category_id !== $this->aCategoryRelatedByCategoryId->getId()) {
|
|
$this->aCategoryRelatedByCategoryId = null;
|
|
}
|
|
} // ensureConsistency
|
|
|
|
/**
|
|
* Reloads this object from datastore based on primary key and (optionally) resets all associated objects.
|
|
*
|
|
* This will only work if the object has been saved and has a valid primary key set.
|
|
*
|
|
* @param boolean $deep (optional) Whether to also de-associated any related objects.
|
|
* @param PropelPDO $con (optional) The PropelPDO connection to use.
|
|
* @return void
|
|
* @throws PropelException - if this object is deleted, unsaved or doesn't have pk match in db
|
|
*/
|
|
public function reload($deep = false, PropelPDO $con = null)
|
|
{
|
|
if ($this->isDeleted()) {
|
|
throw new PropelException("Cannot reload a deleted object.");
|
|
}
|
|
|
|
if ($this->isNew()) {
|
|
throw new PropelException("Cannot reload an unsaved object.");
|
|
}
|
|
|
|
if ($con === null) {
|
|
$con = Propel::getConnection(CategoryPeer::DATABASE_NAME, Propel::CONNECTION_READ);
|
|
}
|
|
|
|
// We don't need to alter the object instance pool; we're just modifying this instance
|
|
// already in the pool.
|
|
|
|
$stmt = CategoryPeer::doSelectStmt($this->buildPkeyCriteria(), $con);
|
|
$row = $stmt->fetch(PDO::FETCH_NUM);
|
|
$stmt->closeCursor();
|
|
if (!$row) {
|
|
throw new PropelException('Cannot find matching row in the database to reload object values.');
|
|
}
|
|
$this->hydrate($row, 0, true); // rehydrate
|
|
|
|
if ($deep) { // also de-associate any related objects?
|
|
|
|
$this->aCategoryRelatedByCategoryId = null;
|
|
$this->collMedias = null;
|
|
|
|
$this->collCategoriesRelatedById = null;
|
|
|
|
} // if (deep)
|
|
}
|
|
|
|
/**
|
|
* Removes this object from datastore and sets delete attribute.
|
|
*
|
|
* @param PropelPDO $con
|
|
* @return void
|
|
* @throws PropelException
|
|
* @throws Exception
|
|
* @see BaseObject::setDeleted()
|
|
* @see BaseObject::isDeleted()
|
|
*/
|
|
public function delete(PropelPDO $con = null)
|
|
{
|
|
if ($this->isDeleted()) {
|
|
throw new PropelException("This object has already been deleted.");
|
|
}
|
|
|
|
if ($con === null) {
|
|
$con = Propel::getConnection(CategoryPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);
|
|
}
|
|
|
|
$con->beginTransaction();
|
|
try {
|
|
$deleteQuery = CategoryQuery::create()
|
|
->filterByPrimaryKey($this->getPrimaryKey());
|
|
$ret = $this->preDelete($con);
|
|
// nested_set behavior
|
|
if ($this->isRoot()) {
|
|
throw new PropelException('Deletion of a root node is disabled for nested sets. Use CategoryPeer::deleteTree() instead to delete an entire tree');
|
|
}
|
|
|
|
if ($this->isInTree()) {
|
|
$this->deleteDescendants($con);
|
|
}
|
|
|
|
if ($ret) {
|
|
$deleteQuery->delete($con);
|
|
$this->postDelete($con);
|
|
// nested_set behavior
|
|
if ($this->isInTree()) {
|
|
// fill up the room that was used by the node
|
|
CategoryPeer::shiftRLValues(-2, $this->getRightValue() + 1, null, $con);
|
|
}
|
|
|
|
$con->commit();
|
|
$this->setDeleted(true);
|
|
} else {
|
|
$con->commit();
|
|
}
|
|
} catch (Exception $e) {
|
|
$con->rollBack();
|
|
throw $e;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Persists this object to the database.
|
|
*
|
|
* If the object is new, it inserts it; otherwise an update is performed.
|
|
* All modified related objects will also be persisted in the doSave()
|
|
* method. This method wraps all precipitate database operations in a
|
|
* single transaction.
|
|
*
|
|
* @param PropelPDO $con
|
|
* @return int The number of rows affected by this insert/update and any referring fk objects' save() operations.
|
|
* @throws PropelException
|
|
* @throws Exception
|
|
* @see doSave()
|
|
*/
|
|
public function save(PropelPDO $con = null)
|
|
{
|
|
if ($this->isDeleted()) {
|
|
throw new PropelException("You cannot save an object that has been deleted.");
|
|
}
|
|
|
|
if ($con === null) {
|
|
$con = Propel::getConnection(CategoryPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);
|
|
}
|
|
|
|
$con->beginTransaction();
|
|
$isInsert = $this->isNew();
|
|
try {
|
|
$ret = $this->preSave($con);
|
|
// sluggable behavior
|
|
|
|
if ($this->isColumnModified(CategoryPeer::SLUG) && $this->getSlug()) {
|
|
$this->setSlug($this->makeSlugUnique($this->getSlug()));
|
|
} elseif ($this->isColumnModified(CategoryPeer::LABEL)) {
|
|
$this->setSlug($this->createSlug());
|
|
} elseif (!$this->getSlug()) {
|
|
$this->setSlug($this->createSlug());
|
|
}
|
|
// nested_set behavior
|
|
if ($this->isNew() && $this->isRoot()) {
|
|
// check if no other root exist in, the tree
|
|
$nbRoots = CategoryQuery::create()
|
|
->addUsingAlias(CategoryPeer::LEFT_COL, 1, Criteria::EQUAL)
|
|
->count($con);
|
|
if ($nbRoots > 0) {
|
|
throw new PropelException('A root node already exists in this tree. To allow multiple root nodes, add the `use_scope` parameter in the nested_set behavior tag.');
|
|
}
|
|
}
|
|
$this->processNestedSetQueries($con);
|
|
if ($isInsert) {
|
|
$ret = $ret && $this->preInsert($con);
|
|
// timestampable behavior
|
|
if (!$this->isColumnModified(CategoryPeer::CREATED_AT)) {
|
|
$this->setCreatedAt(time());
|
|
}
|
|
if (!$this->isColumnModified(CategoryPeer::UPDATED_AT)) {
|
|
$this->setUpdatedAt(time());
|
|
}
|
|
} else {
|
|
$ret = $ret && $this->preUpdate($con);
|
|
// timestampable behavior
|
|
if ($this->isModified() && !$this->isColumnModified(CategoryPeer::UPDATED_AT)) {
|
|
$this->setUpdatedAt(time());
|
|
}
|
|
}
|
|
if ($ret) {
|
|
$affectedRows = $this->doSave($con);
|
|
if ($isInsert) {
|
|
$this->postInsert($con);
|
|
} else {
|
|
$this->postUpdate($con);
|
|
}
|
|
$this->postSave($con);
|
|
CategoryPeer::addInstanceToPool($this);
|
|
} else {
|
|
$affectedRows = 0;
|
|
}
|
|
$con->commit();
|
|
|
|
return $affectedRows;
|
|
} catch (Exception $e) {
|
|
$con->rollBack();
|
|
throw $e;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Performs the work of inserting or updating the row in the database.
|
|
*
|
|
* If the object is new, it inserts it; otherwise an update is performed.
|
|
* All related objects are also updated in this method.
|
|
*
|
|
* @param PropelPDO $con
|
|
* @return int The number of rows affected by this insert/update and any referring fk objects' save() operations.
|
|
* @throws PropelException
|
|
* @see save()
|
|
*/
|
|
protected function doSave(PropelPDO $con)
|
|
{
|
|
$affectedRows = 0; // initialize var to track total num of affected rows
|
|
if (!$this->alreadyInSave) {
|
|
$this->alreadyInSave = true;
|
|
|
|
// We call the save method on the following object(s) if they
|
|
// were passed to this object by their coresponding set
|
|
// method. This object relates to these object(s) by a
|
|
// foreign key reference.
|
|
|
|
if ($this->aCategoryRelatedByCategoryId !== null) {
|
|
if ($this->aCategoryRelatedByCategoryId->isModified() || $this->aCategoryRelatedByCategoryId->isNew()) {
|
|
$affectedRows += $this->aCategoryRelatedByCategoryId->save($con);
|
|
}
|
|
$this->setCategoryRelatedByCategoryId($this->aCategoryRelatedByCategoryId);
|
|
}
|
|
|
|
if ($this->isNew() || $this->isModified()) {
|
|
// persist changes
|
|
if ($this->isNew()) {
|
|
$this->doInsert($con);
|
|
} else {
|
|
$this->doUpdate($con);
|
|
}
|
|
$affectedRows += 1;
|
|
$this->resetModified();
|
|
}
|
|
|
|
if ($this->mediasScheduledForDeletion !== null) {
|
|
if (!$this->mediasScheduledForDeletion->isEmpty()) {
|
|
foreach ($this->mediasScheduledForDeletion as $media) {
|
|
// need to save related object because we set the relation to null
|
|
$media->save($con);
|
|
}
|
|
$this->mediasScheduledForDeletion = null;
|
|
}
|
|
}
|
|
|
|
if ($this->collMedias !== null) {
|
|
foreach ($this->collMedias as $referrerFK) {
|
|
if (!$referrerFK->isDeleted() && ($referrerFK->isNew() || $referrerFK->isModified())) {
|
|
$affectedRows += $referrerFK->save($con);
|
|
}
|
|
}
|
|
}
|
|
|
|
if ($this->categoriesRelatedByIdScheduledForDeletion !== null) {
|
|
if (!$this->categoriesRelatedByIdScheduledForDeletion->isEmpty()) {
|
|
foreach ($this->categoriesRelatedByIdScheduledForDeletion as $categoryRelatedById) {
|
|
// need to save related object because we set the relation to null
|
|
$categoryRelatedById->save($con);
|
|
}
|
|
$this->categoriesRelatedByIdScheduledForDeletion = null;
|
|
}
|
|
}
|
|
|
|
if ($this->collCategoriesRelatedById !== null) {
|
|
foreach ($this->collCategoriesRelatedById 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 PropelPDO $con
|
|
*
|
|
* @throws PropelException
|
|
* @see doSave()
|
|
*/
|
|
protected function doInsert(PropelPDO $con)
|
|
{
|
|
$modifiedColumns = array();
|
|
$index = 0;
|
|
|
|
$this->modifiedColumns[] = CategoryPeer::ID;
|
|
if (null !== $this->id) {
|
|
throw new PropelException('Cannot insert a value for auto-increment primary key (' . CategoryPeer::ID . ')');
|
|
}
|
|
|
|
// check the columns in natural order for more readable SQL queries
|
|
if ($this->isColumnModified(CategoryPeer::ID)) {
|
|
$modifiedColumns[':p' . $index++] = '`id`';
|
|
}
|
|
if ($this->isColumnModified(CategoryPeer::LABEL)) {
|
|
$modifiedColumns[':p' . $index++] = '`label`';
|
|
}
|
|
if ($this->isColumnModified(CategoryPeer::CATEGORY_ID)) {
|
|
$modifiedColumns[':p' . $index++] = '`category_id`';
|
|
}
|
|
if ($this->isColumnModified(CategoryPeer::CREATED_AT)) {
|
|
$modifiedColumns[':p' . $index++] = '`created_at`';
|
|
}
|
|
if ($this->isColumnModified(CategoryPeer::UPDATED_AT)) {
|
|
$modifiedColumns[':p' . $index++] = '`updated_at`';
|
|
}
|
|
if ($this->isColumnModified(CategoryPeer::SLUG)) {
|
|
$modifiedColumns[':p' . $index++] = '`slug`';
|
|
}
|
|
if ($this->isColumnModified(CategoryPeer::TREE_LEFT)) {
|
|
$modifiedColumns[':p' . $index++] = '`tree_left`';
|
|
}
|
|
if ($this->isColumnModified(CategoryPeer::TREE_RIGHT)) {
|
|
$modifiedColumns[':p' . $index++] = '`tree_right`';
|
|
}
|
|
if ($this->isColumnModified(CategoryPeer::TREE_LEVEL)) {
|
|
$modifiedColumns[':p' . $index++] = '`tree_level`';
|
|
}
|
|
|
|
$sql = sprintf(
|
|
'INSERT INTO `media_category` (%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 '`label`':
|
|
$stmt->bindValue($identifier, $this->label, PDO::PARAM_STR);
|
|
break;
|
|
case '`category_id`':
|
|
$stmt->bindValue($identifier, $this->category_id, PDO::PARAM_INT);
|
|
break;
|
|
case '`created_at`':
|
|
$stmt->bindValue($identifier, $this->created_at, PDO::PARAM_STR);
|
|
break;
|
|
case '`updated_at`':
|
|
$stmt->bindValue($identifier, $this->updated_at, PDO::PARAM_STR);
|
|
break;
|
|
case '`slug`':
|
|
$stmt->bindValue($identifier, $this->slug, PDO::PARAM_STR);
|
|
break;
|
|
case '`tree_left`':
|
|
$stmt->bindValue($identifier, $this->tree_left, PDO::PARAM_INT);
|
|
break;
|
|
case '`tree_right`':
|
|
$stmt->bindValue($identifier, $this->tree_right, PDO::PARAM_INT);
|
|
break;
|
|
case '`tree_level`':
|
|
$stmt->bindValue($identifier, $this->tree_level, PDO::PARAM_INT);
|
|
break;
|
|
}
|
|
}
|
|
$stmt->execute();
|
|
} catch (Exception $e) {
|
|
Propel::log($e->getMessage(), Propel::LOG_ERR);
|
|
throw new PropelException(sprintf('Unable to execute INSERT statement [%s]', $sql), $e);
|
|
}
|
|
|
|
try {
|
|
$pk = $con->lastInsertId();
|
|
} catch (Exception $e) {
|
|
throw new PropelException('Unable to get autoincrement id.', $e);
|
|
}
|
|
$this->setId($pk);
|
|
|
|
$this->setNew(false);
|
|
}
|
|
|
|
/**
|
|
* Update the row in the database.
|
|
*
|
|
* @param PropelPDO $con
|
|
*
|
|
* @see doSave()
|
|
*/
|
|
protected function doUpdate(PropelPDO $con)
|
|
{
|
|
$selectCriteria = $this->buildPkeyCriteria();
|
|
$valuesCriteria = $this->buildCriteria();
|
|
BasePeer::doUpdate($selectCriteria, $valuesCriteria, $con);
|
|
}
|
|
|
|
/**
|
|
* Array of ValidationFailed objects.
|
|
* @var array ValidationFailed[]
|
|
*/
|
|
protected $validationFailures = array();
|
|
|
|
/**
|
|
* Gets any ValidationFailed objects that resulted from last call to validate().
|
|
*
|
|
*
|
|
* @return array ValidationFailed[]
|
|
* @see validate()
|
|
*/
|
|
public function getValidationFailures()
|
|
{
|
|
return $this->validationFailures;
|
|
}
|
|
|
|
/**
|
|
* Validates the objects modified field values and all objects related to this table.
|
|
*
|
|
* If $columns is either a column name or an array of column names
|
|
* only those columns are validated.
|
|
*
|
|
* @param mixed $columns Column name or an array of column names.
|
|
* @return boolean Whether all columns pass validation.
|
|
* @see doValidate()
|
|
* @see getValidationFailures()
|
|
*/
|
|
public function validate($columns = null)
|
|
{
|
|
$res = $this->doValidate($columns);
|
|
if ($res === true) {
|
|
$this->validationFailures = array();
|
|
|
|
return true;
|
|
}
|
|
|
|
$this->validationFailures = $res;
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* This function performs the validation work for complex object models.
|
|
*
|
|
* In addition to checking the current object, all related objects will
|
|
* also be validated. If all pass then <code>true</code> is returned; otherwise
|
|
* an aggreagated array of ValidationFailed objects will be returned.
|
|
*
|
|
* @param array $columns Array of column names to validate.
|
|
* @return mixed <code>true</code> if all validations pass; array of <code>ValidationFailed</code> objets otherwise.
|
|
*/
|
|
protected function doValidate($columns = null)
|
|
{
|
|
if (!$this->alreadyInValidation) {
|
|
$this->alreadyInValidation = true;
|
|
$retval = null;
|
|
|
|
$failureMap = array();
|
|
|
|
|
|
// We call the validate method on the following object(s) if they
|
|
// were passed to this object by their coresponding set
|
|
// method. This object relates to these object(s) by a
|
|
// foreign key reference.
|
|
|
|
if ($this->aCategoryRelatedByCategoryId !== null) {
|
|
if (!$this->aCategoryRelatedByCategoryId->validate($columns)) {
|
|
$failureMap = array_merge($failureMap, $this->aCategoryRelatedByCategoryId->getValidationFailures());
|
|
}
|
|
}
|
|
|
|
|
|
if (($retval = CategoryPeer::doValidate($this, $columns)) !== true) {
|
|
$failureMap = array_merge($failureMap, $retval);
|
|
}
|
|
|
|
|
|
if ($this->collMedias !== null) {
|
|
foreach ($this->collMedias as $referrerFK) {
|
|
if (!$referrerFK->validate($columns)) {
|
|
$failureMap = array_merge($failureMap, $referrerFK->getValidationFailures());
|
|
}
|
|
}
|
|
}
|
|
|
|
if ($this->collCategoriesRelatedById !== null) {
|
|
foreach ($this->collCategoriesRelatedById as $referrerFK) {
|
|
if (!$referrerFK->validate($columns)) {
|
|
$failureMap = array_merge($failureMap, $referrerFK->getValidationFailures());
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
$this->alreadyInValidation = false;
|
|
}
|
|
|
|
return (!empty($failureMap) ? $failureMap : true);
|
|
}
|
|
|
|
/**
|
|
* Retrieves a field from the object by name passed in as a string.
|
|
*
|
|
* @param string $name name
|
|
* @param string $type The type of fieldname the $name is of:
|
|
* one of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME
|
|
* BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM.
|
|
* Defaults to BasePeer::TYPE_PHPNAME
|
|
* @return mixed Value of field.
|
|
*/
|
|
public function getByName($name, $type = BasePeer::TYPE_PHPNAME)
|
|
{
|
|
$pos = CategoryPeer::translateFieldName($name, $type, BasePeer::TYPE_NUM);
|
|
$field = $this->getByPosition($pos);
|
|
|
|
return $field;
|
|
}
|
|
|
|
/**
|
|
* Retrieves a field from the object by Position as specified in the xml schema.
|
|
* Zero-based.
|
|
*
|
|
* @param int $pos position in xml schema
|
|
* @return mixed Value of field at $pos
|
|
*/
|
|
public function getByPosition($pos)
|
|
{
|
|
switch ($pos) {
|
|
case 0:
|
|
return $this->getId();
|
|
break;
|
|
case 1:
|
|
return $this->getLabel();
|
|
break;
|
|
case 2:
|
|
return $this->getCategoryId();
|
|
break;
|
|
case 3:
|
|
return $this->getCreatedAt();
|
|
break;
|
|
case 4:
|
|
return $this->getUpdatedAt();
|
|
break;
|
|
case 5:
|
|
return $this->getSlug();
|
|
break;
|
|
case 6:
|
|
return $this->getTreeLeft();
|
|
break;
|
|
case 7:
|
|
return $this->getTreeRight();
|
|
break;
|
|
case 8:
|
|
return $this->getTreeLevel();
|
|
break;
|
|
default:
|
|
return null;
|
|
break;
|
|
} // switch()
|
|
}
|
|
|
|
/**
|
|
* Exports the object as an array.
|
|
*
|
|
* You can specify the key type of the array by passing one of the class
|
|
* type constants.
|
|
*
|
|
* @param string $keyType (optional) One of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME,
|
|
* BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM.
|
|
* Defaults to BasePeer::TYPE_PHPNAME.
|
|
* @param boolean $includeLazyLoadColumns (optional) Whether to include lazy loaded columns. Defaults to true.
|
|
* @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 = BasePeer::TYPE_PHPNAME, $includeLazyLoadColumns = true, $alreadyDumpedObjects = array(), $includeForeignObjects = false)
|
|
{
|
|
if (isset($alreadyDumpedObjects['Category'][$this->getPrimaryKey()])) {
|
|
return '*RECURSION*';
|
|
}
|
|
$alreadyDumpedObjects['Category'][$this->getPrimaryKey()] = true;
|
|
$keys = CategoryPeer::getFieldNames($keyType);
|
|
$result = array(
|
|
$keys[0] => $this->getId(),
|
|
$keys[1] => $this->getLabel(),
|
|
$keys[2] => $this->getCategoryId(),
|
|
$keys[3] => $this->getCreatedAt(),
|
|
$keys[4] => $this->getUpdatedAt(),
|
|
$keys[5] => $this->getSlug(),
|
|
$keys[6] => $this->getTreeLeft(),
|
|
$keys[7] => $this->getTreeRight(),
|
|
$keys[8] => $this->getTreeLevel(),
|
|
);
|
|
if ($includeForeignObjects) {
|
|
if (null !== $this->aCategoryRelatedByCategoryId) {
|
|
$result['CategoryRelatedByCategoryId'] = $this->aCategoryRelatedByCategoryId->toArray($keyType, $includeLazyLoadColumns, $alreadyDumpedObjects, true);
|
|
}
|
|
if (null !== $this->collMedias) {
|
|
$result['Medias'] = $this->collMedias->toArray(null, true, $keyType, $includeLazyLoadColumns, $alreadyDumpedObjects);
|
|
}
|
|
if (null !== $this->collCategoriesRelatedById) {
|
|
$result['CategoriesRelatedById'] = $this->collCategoriesRelatedById->toArray(null, true, $keyType, $includeLazyLoadColumns, $alreadyDumpedObjects);
|
|
}
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Sets a field from the object by name passed in as a string.
|
|
*
|
|
* @param string $name peer name
|
|
* @param mixed $value field value
|
|
* @param string $type The type of fieldname the $name is of:
|
|
* one of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME
|
|
* BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM.
|
|
* Defaults to BasePeer::TYPE_PHPNAME
|
|
* @return void
|
|
*/
|
|
public function setByName($name, $value, $type = BasePeer::TYPE_PHPNAME)
|
|
{
|
|
$pos = CategoryPeer::translateFieldName($name, $type, BasePeer::TYPE_NUM);
|
|
|
|
$this->setByPosition($pos, $value);
|
|
}
|
|
|
|
/**
|
|
* Sets a field from the object by Position as specified in the xml schema.
|
|
* Zero-based.
|
|
*
|
|
* @param int $pos position in xml schema
|
|
* @param mixed $value field value
|
|
* @return void
|
|
*/
|
|
public function setByPosition($pos, $value)
|
|
{
|
|
switch ($pos) {
|
|
case 0:
|
|
$this->setId($value);
|
|
break;
|
|
case 1:
|
|
$this->setLabel($value);
|
|
break;
|
|
case 2:
|
|
$this->setCategoryId($value);
|
|
break;
|
|
case 3:
|
|
$this->setCreatedAt($value);
|
|
break;
|
|
case 4:
|
|
$this->setUpdatedAt($value);
|
|
break;
|
|
case 5:
|
|
$this->setSlug($value);
|
|
break;
|
|
case 6:
|
|
$this->setTreeLeft($value);
|
|
break;
|
|
case 7:
|
|
$this->setTreeRight($value);
|
|
break;
|
|
case 8:
|
|
$this->setTreeLevel($value);
|
|
break;
|
|
} // switch()
|
|
}
|
|
|
|
/**
|
|
* Populates the object using an array.
|
|
*
|
|
* This is particularly useful when populating an object from one of the
|
|
* request arrays (e.g. $_POST). This method goes through the column
|
|
* names, checking to see whether a matching key exists in populated
|
|
* array. If so the setByName() method is called for that column.
|
|
*
|
|
* You can specify the key type of the array by additionally passing one
|
|
* of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME,
|
|
* BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM.
|
|
* The default key type is the column's BasePeer::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 = BasePeer::TYPE_PHPNAME)
|
|
{
|
|
$keys = CategoryPeer::getFieldNames($keyType);
|
|
|
|
if (array_key_exists($keys[0], $arr)) $this->setId($arr[$keys[0]]);
|
|
if (array_key_exists($keys[1], $arr)) $this->setLabel($arr[$keys[1]]);
|
|
if (array_key_exists($keys[2], $arr)) $this->setCategoryId($arr[$keys[2]]);
|
|
if (array_key_exists($keys[3], $arr)) $this->setCreatedAt($arr[$keys[3]]);
|
|
if (array_key_exists($keys[4], $arr)) $this->setUpdatedAt($arr[$keys[4]]);
|
|
if (array_key_exists($keys[5], $arr)) $this->setSlug($arr[$keys[5]]);
|
|
if (array_key_exists($keys[6], $arr)) $this->setTreeLeft($arr[$keys[6]]);
|
|
if (array_key_exists($keys[7], $arr)) $this->setTreeRight($arr[$keys[7]]);
|
|
if (array_key_exists($keys[8], $arr)) $this->setTreeLevel($arr[$keys[8]]);
|
|
}
|
|
|
|
/**
|
|
* Build a Criteria object containing the values of all modified columns in this object.
|
|
*
|
|
* @return Criteria The Criteria object containing all modified values.
|
|
*/
|
|
public function buildCriteria()
|
|
{
|
|
$criteria = new Criteria(CategoryPeer::DATABASE_NAME);
|
|
|
|
if ($this->isColumnModified(CategoryPeer::ID)) $criteria->add(CategoryPeer::ID, $this->id);
|
|
if ($this->isColumnModified(CategoryPeer::LABEL)) $criteria->add(CategoryPeer::LABEL, $this->label);
|
|
if ($this->isColumnModified(CategoryPeer::CATEGORY_ID)) $criteria->add(CategoryPeer::CATEGORY_ID, $this->category_id);
|
|
if ($this->isColumnModified(CategoryPeer::CREATED_AT)) $criteria->add(CategoryPeer::CREATED_AT, $this->created_at);
|
|
if ($this->isColumnModified(CategoryPeer::UPDATED_AT)) $criteria->add(CategoryPeer::UPDATED_AT, $this->updated_at);
|
|
if ($this->isColumnModified(CategoryPeer::SLUG)) $criteria->add(CategoryPeer::SLUG, $this->slug);
|
|
if ($this->isColumnModified(CategoryPeer::TREE_LEFT)) $criteria->add(CategoryPeer::TREE_LEFT, $this->tree_left);
|
|
if ($this->isColumnModified(CategoryPeer::TREE_RIGHT)) $criteria->add(CategoryPeer::TREE_RIGHT, $this->tree_right);
|
|
if ($this->isColumnModified(CategoryPeer::TREE_LEVEL)) $criteria->add(CategoryPeer::TREE_LEVEL, $this->tree_level);
|
|
|
|
return $criteria;
|
|
}
|
|
|
|
/**
|
|
* Builds a Criteria object containing the primary key for this object.
|
|
*
|
|
* Unlike buildCriteria() this method includes the primary key values regardless
|
|
* of whether or not they have been modified.
|
|
*
|
|
* @return Criteria The Criteria object containing value(s) for primary key(s).
|
|
*/
|
|
public function buildPkeyCriteria()
|
|
{
|
|
$criteria = new Criteria(CategoryPeer::DATABASE_NAME);
|
|
$criteria->add(CategoryPeer::ID, $this->id);
|
|
|
|
return $criteria;
|
|
}
|
|
|
|
/**
|
|
* Returns the primary key for this object (row).
|
|
* @return int
|
|
*/
|
|
public function getPrimaryKey()
|
|
{
|
|
return $this->getId();
|
|
}
|
|
|
|
/**
|
|
* Generic method to set the primary key (id column).
|
|
*
|
|
* @param int $key Primary key.
|
|
* @return void
|
|
*/
|
|
public function setPrimaryKey($key)
|
|
{
|
|
$this->setId($key);
|
|
}
|
|
|
|
/**
|
|
* 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 Category (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->setLabel($this->getLabel());
|
|
$copyObj->setCategoryId($this->getCategoryId());
|
|
$copyObj->setCreatedAt($this->getCreatedAt());
|
|
$copyObj->setUpdatedAt($this->getUpdatedAt());
|
|
$copyObj->setSlug($this->getSlug());
|
|
$copyObj->setTreeLeft($this->getTreeLeft());
|
|
$copyObj->setTreeRight($this->getTreeRight());
|
|
$copyObj->setTreeLevel($this->getTreeLevel());
|
|
|
|
if ($deepCopy && !$this->startCopy) {
|
|
// important: temporarily setNew(false) because this affects the behavior of
|
|
// the getter/setter methods for fkey referrer objects.
|
|
$copyObj->setNew(false);
|
|
// store object hash to prevent cycle
|
|
$this->startCopy = true;
|
|
|
|
foreach ($this->getMedias() as $relObj) {
|
|
if ($relObj !== $this) { // ensure that we don't try to copy a reference to ourselves
|
|
$copyObj->addMedia($relObj->copy($deepCopy));
|
|
}
|
|
}
|
|
|
|
foreach ($this->getCategoriesRelatedById() as $relObj) {
|
|
if ($relObj !== $this) { // ensure that we don't try to copy a reference to ourselves
|
|
$copyObj->addCategoryRelatedById($relObj->copy($deepCopy));
|
|
}
|
|
}
|
|
|
|
//unflag object copy
|
|
$this->startCopy = false;
|
|
} // 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 Category Clone of current object.
|
|
* @throws PropelException
|
|
*/
|
|
public function copy($deepCopy = false)
|
|
{
|
|
// we use get_class(), because this might be a subclass
|
|
$clazz = get_class($this);
|
|
$copyObj = new $clazz();
|
|
$this->copyInto($copyObj, $deepCopy);
|
|
|
|
return $copyObj;
|
|
}
|
|
|
|
/**
|
|
* Returns a peer instance associated with this om.
|
|
*
|
|
* Since Peer classes are not to have any instance attributes, this method returns the
|
|
* same instance for all member of this class. The method could therefore
|
|
* be static, but this would prevent one from overriding the behavior.
|
|
*
|
|
* @return CategoryPeer
|
|
*/
|
|
public function getPeer()
|
|
{
|
|
if (self::$peer === null) {
|
|
self::$peer = new CategoryPeer();
|
|
}
|
|
|
|
return self::$peer;
|
|
}
|
|
|
|
/**
|
|
* Declares an association between this object and a Category object.
|
|
*
|
|
* @param Category $v
|
|
* @return Category The current object (for fluent API support)
|
|
* @throws PropelException
|
|
*/
|
|
public function setCategoryRelatedByCategoryId(Category $v = null)
|
|
{
|
|
if ($v === null) {
|
|
$this->setCategoryId(NULL);
|
|
} else {
|
|
$this->setCategoryId($v->getId());
|
|
}
|
|
|
|
$this->aCategoryRelatedByCategoryId = $v;
|
|
|
|
// Add binding for other direction of this n:n relationship.
|
|
// If this object has already been added to the Category object, it will not be re-added.
|
|
if ($v !== null) {
|
|
$v->addCategoryRelatedById($this);
|
|
}
|
|
|
|
|
|
return $this;
|
|
}
|
|
|
|
|
|
/**
|
|
* Get the associated Category object
|
|
*
|
|
* @param PropelPDO $con Optional Connection object.
|
|
* @param $doQuery Executes a query to get the object if required
|
|
* @return Category The associated Category object.
|
|
* @throws PropelException
|
|
*/
|
|
public function getCategoryRelatedByCategoryId(PropelPDO $con = null, $doQuery = true)
|
|
{
|
|
if ($this->aCategoryRelatedByCategoryId === null && ($this->category_id !== null) && $doQuery) {
|
|
$this->aCategoryRelatedByCategoryId = CategoryQuery::create()->findPk($this->category_id, $con);
|
|
/* The following can be used additionally to
|
|
guarantee the related object contains a reference
|
|
to this object. This level of coupling may, however, be
|
|
undesirable since it could result in an only partially populated collection
|
|
in the referenced object.
|
|
$this->aCategoryRelatedByCategoryId->addCategoriesRelatedById($this);
|
|
*/
|
|
}
|
|
|
|
return $this->aCategoryRelatedByCategoryId;
|
|
}
|
|
|
|
|
|
/**
|
|
* 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 ('Media' == $relationName) {
|
|
$this->initMedias();
|
|
}
|
|
if ('CategoryRelatedById' == $relationName) {
|
|
$this->initCategoriesRelatedById();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Clears out the collMedias 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 Category The current object (for fluent API support)
|
|
* @see addMedias()
|
|
*/
|
|
public function clearMedias()
|
|
{
|
|
$this->collMedias = null; // important to set this to null since that means it is uninitialized
|
|
$this->collMediasPartial = null;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* reset is the collMedias collection loaded partially
|
|
*
|
|
* @return void
|
|
*/
|
|
public function resetPartialMedias($v = true)
|
|
{
|
|
$this->collMediasPartial = $v;
|
|
}
|
|
|
|
/**
|
|
* Initializes the collMedias collection.
|
|
*
|
|
* By default this just sets the collMedias collection to an empty array (like clearcollMedias());
|
|
* 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 initMedias($overrideExisting = true)
|
|
{
|
|
if (null !== $this->collMedias && !$overrideExisting) {
|
|
return;
|
|
}
|
|
$this->collMedias = new PropelObjectCollection();
|
|
$this->collMedias->setModel('Media');
|
|
}
|
|
|
|
/**
|
|
* Gets an array of Media 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 Category 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 PropelPDO $con optional connection object
|
|
* @return PropelObjectCollection|Media[] List of Media objects
|
|
* @throws PropelException
|
|
*/
|
|
public function getMedias($criteria = null, PropelPDO $con = null)
|
|
{
|
|
$partial = $this->collMediasPartial && !$this->isNew();
|
|
if (null === $this->collMedias || null !== $criteria || $partial) {
|
|
if ($this->isNew() && null === $this->collMedias) {
|
|
// return empty collection
|
|
$this->initMedias();
|
|
} else {
|
|
$collMedias = MediaQuery::create(null, $criteria)
|
|
->filterByCategory($this)
|
|
->find($con);
|
|
if (null !== $criteria) {
|
|
if (false !== $this->collMediasPartial && count($collMedias)) {
|
|
$this->initMedias(false);
|
|
|
|
foreach($collMedias as $obj) {
|
|
if (false == $this->collMedias->contains($obj)) {
|
|
$this->collMedias->append($obj);
|
|
}
|
|
}
|
|
|
|
$this->collMediasPartial = true;
|
|
}
|
|
|
|
$collMedias->getInternalIterator()->rewind();
|
|
return $collMedias;
|
|
}
|
|
|
|
if($partial && $this->collMedias) {
|
|
foreach($this->collMedias as $obj) {
|
|
if($obj->isNew()) {
|
|
$collMedias[] = $obj;
|
|
}
|
|
}
|
|
}
|
|
|
|
$this->collMedias = $collMedias;
|
|
$this->collMediasPartial = false;
|
|
}
|
|
}
|
|
|
|
return $this->collMedias;
|
|
}
|
|
|
|
/**
|
|
* Sets a collection of Media 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 PropelCollection $medias A Propel collection.
|
|
* @param PropelPDO $con Optional connection object
|
|
* @return Category The current object (for fluent API support)
|
|
*/
|
|
public function setMedias(PropelCollection $medias, PropelPDO $con = null)
|
|
{
|
|
$mediasToDelete = $this->getMedias(new Criteria(), $con)->diff($medias);
|
|
|
|
$this->mediasScheduledForDeletion = unserialize(serialize($mediasToDelete));
|
|
|
|
foreach ($mediasToDelete as $mediaRemoved) {
|
|
$mediaRemoved->setCategory(null);
|
|
}
|
|
|
|
$this->collMedias = null;
|
|
foreach ($medias as $media) {
|
|
$this->addMedia($media);
|
|
}
|
|
|
|
$this->collMedias = $medias;
|
|
$this->collMediasPartial = false;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Returns the number of related Media objects.
|
|
*
|
|
* @param Criteria $criteria
|
|
* @param boolean $distinct
|
|
* @param PropelPDO $con
|
|
* @return int Count of related Media objects.
|
|
* @throws PropelException
|
|
*/
|
|
public function countMedias(Criteria $criteria = null, $distinct = false, PropelPDO $con = null)
|
|
{
|
|
$partial = $this->collMediasPartial && !$this->isNew();
|
|
if (null === $this->collMedias || null !== $criteria || $partial) {
|
|
if ($this->isNew() && null === $this->collMedias) {
|
|
return 0;
|
|
}
|
|
|
|
if($partial && !$criteria) {
|
|
return count($this->getMedias());
|
|
}
|
|
$query = MediaQuery::create(null, $criteria);
|
|
if ($distinct) {
|
|
$query->distinct();
|
|
}
|
|
|
|
return $query
|
|
->filterByCategory($this)
|
|
->count($con);
|
|
}
|
|
|
|
return count($this->collMedias);
|
|
}
|
|
|
|
/**
|
|
* Method called to associate a Media object to this object
|
|
* through the Media foreign key attribute.
|
|
*
|
|
* @param Media $l Media
|
|
* @return Category The current object (for fluent API support)
|
|
*/
|
|
public function addMedia(Media $l)
|
|
{
|
|
if ($this->collMedias === null) {
|
|
$this->initMedias();
|
|
$this->collMediasPartial = true;
|
|
}
|
|
if (!in_array($l, $this->collMedias->getArrayCopy(), true)) { // only add it if the **same** object is not already associated
|
|
$this->doAddMedia($l);
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* @param Media $media The media object to add.
|
|
*/
|
|
protected function doAddMedia($media)
|
|
{
|
|
$this->collMedias[]= $media;
|
|
$media->setCategory($this);
|
|
}
|
|
|
|
/**
|
|
* @param Media $media The media object to remove.
|
|
* @return Category The current object (for fluent API support)
|
|
*/
|
|
public function removeMedia($media)
|
|
{
|
|
if ($this->getMedias()->contains($media)) {
|
|
$this->collMedias->remove($this->collMedias->search($media));
|
|
if (null === $this->mediasScheduledForDeletion) {
|
|
$this->mediasScheduledForDeletion = clone $this->collMedias;
|
|
$this->mediasScheduledForDeletion->clear();
|
|
}
|
|
$this->mediasScheduledForDeletion[]= $media;
|
|
$media->setCategory(null);
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
|
|
/**
|
|
* If this collection has already been initialized with
|
|
* an identical criteria, it returns the collection.
|
|
* Otherwise if this Category is new, it will return
|
|
* an empty collection; or if this Category has previously
|
|
* been saved, it will retrieve related Medias 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 Category.
|
|
*
|
|
* @param Criteria $criteria optional Criteria object to narrow the query
|
|
* @param PropelPDO $con optional connection object
|
|
* @param string $join_behavior optional join type to use (defaults to Criteria::LEFT_JOIN)
|
|
* @return PropelObjectCollection|Media[] List of Media objects
|
|
*/
|
|
public function getMediasJoinType($criteria = null, $con = null, $join_behavior = Criteria::LEFT_JOIN)
|
|
{
|
|
$query = MediaQuery::create(null, $criteria);
|
|
$query->joinWith('Type', $join_behavior);
|
|
|
|
return $this->getMedias($query, $con);
|
|
}
|
|
|
|
/**
|
|
* Clears out the collCategoriesRelatedById 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 Category The current object (for fluent API support)
|
|
* @see addCategoriesRelatedById()
|
|
*/
|
|
public function clearCategoriesRelatedById()
|
|
{
|
|
$this->collCategoriesRelatedById = null; // important to set this to null since that means it is uninitialized
|
|
$this->collCategoriesRelatedByIdPartial = null;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* reset is the collCategoriesRelatedById collection loaded partially
|
|
*
|
|
* @return void
|
|
*/
|
|
public function resetPartialCategoriesRelatedById($v = true)
|
|
{
|
|
$this->collCategoriesRelatedByIdPartial = $v;
|
|
}
|
|
|
|
/**
|
|
* Initializes the collCategoriesRelatedById collection.
|
|
*
|
|
* By default this just sets the collCategoriesRelatedById collection to an empty array (like clearcollCategoriesRelatedById());
|
|
* 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 initCategoriesRelatedById($overrideExisting = true)
|
|
{
|
|
if (null !== $this->collCategoriesRelatedById && !$overrideExisting) {
|
|
return;
|
|
}
|
|
$this->collCategoriesRelatedById = new PropelObjectCollection();
|
|
$this->collCategoriesRelatedById->setModel('Category');
|
|
}
|
|
|
|
/**
|
|
* Gets an array of Category 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 Category 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 PropelPDO $con optional connection object
|
|
* @return PropelObjectCollection|Category[] List of Category objects
|
|
* @throws PropelException
|
|
*/
|
|
public function getCategoriesRelatedById($criteria = null, PropelPDO $con = null)
|
|
{
|
|
$partial = $this->collCategoriesRelatedByIdPartial && !$this->isNew();
|
|
if (null === $this->collCategoriesRelatedById || null !== $criteria || $partial) {
|
|
if ($this->isNew() && null === $this->collCategoriesRelatedById) {
|
|
// return empty collection
|
|
$this->initCategoriesRelatedById();
|
|
} else {
|
|
$collCategoriesRelatedById = CategoryQuery::create(null, $criteria)
|
|
->filterByCategoryRelatedByCategoryId($this)
|
|
->find($con);
|
|
if (null !== $criteria) {
|
|
if (false !== $this->collCategoriesRelatedByIdPartial && count($collCategoriesRelatedById)) {
|
|
$this->initCategoriesRelatedById(false);
|
|
|
|
foreach($collCategoriesRelatedById as $obj) {
|
|
if (false == $this->collCategoriesRelatedById->contains($obj)) {
|
|
$this->collCategoriesRelatedById->append($obj);
|
|
}
|
|
}
|
|
|
|
$this->collCategoriesRelatedByIdPartial = true;
|
|
}
|
|
|
|
$collCategoriesRelatedById->getInternalIterator()->rewind();
|
|
return $collCategoriesRelatedById;
|
|
}
|
|
|
|
if($partial && $this->collCategoriesRelatedById) {
|
|
foreach($this->collCategoriesRelatedById as $obj) {
|
|
if($obj->isNew()) {
|
|
$collCategoriesRelatedById[] = $obj;
|
|
}
|
|
}
|
|
}
|
|
|
|
$this->collCategoriesRelatedById = $collCategoriesRelatedById;
|
|
$this->collCategoriesRelatedByIdPartial = false;
|
|
}
|
|
}
|
|
|
|
return $this->collCategoriesRelatedById;
|
|
}
|
|
|
|
/**
|
|
* Sets a collection of CategoryRelatedById 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 PropelCollection $categoriesRelatedById A Propel collection.
|
|
* @param PropelPDO $con Optional connection object
|
|
* @return Category The current object (for fluent API support)
|
|
*/
|
|
public function setCategoriesRelatedById(PropelCollection $categoriesRelatedById, PropelPDO $con = null)
|
|
{
|
|
$categoriesRelatedByIdToDelete = $this->getCategoriesRelatedById(new Criteria(), $con)->diff($categoriesRelatedById);
|
|
|
|
$this->categoriesRelatedByIdScheduledForDeletion = unserialize(serialize($categoriesRelatedByIdToDelete));
|
|
|
|
foreach ($categoriesRelatedByIdToDelete as $categoryRelatedByIdRemoved) {
|
|
$categoryRelatedByIdRemoved->setCategoryRelatedByCategoryId(null);
|
|
}
|
|
|
|
$this->collCategoriesRelatedById = null;
|
|
foreach ($categoriesRelatedById as $categoryRelatedById) {
|
|
$this->addCategoryRelatedById($categoryRelatedById);
|
|
}
|
|
|
|
$this->collCategoriesRelatedById = $categoriesRelatedById;
|
|
$this->collCategoriesRelatedByIdPartial = false;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Returns the number of related Category objects.
|
|
*
|
|
* @param Criteria $criteria
|
|
* @param boolean $distinct
|
|
* @param PropelPDO $con
|
|
* @return int Count of related Category objects.
|
|
* @throws PropelException
|
|
*/
|
|
public function countCategoriesRelatedById(Criteria $criteria = null, $distinct = false, PropelPDO $con = null)
|
|
{
|
|
$partial = $this->collCategoriesRelatedByIdPartial && !$this->isNew();
|
|
if (null === $this->collCategoriesRelatedById || null !== $criteria || $partial) {
|
|
if ($this->isNew() && null === $this->collCategoriesRelatedById) {
|
|
return 0;
|
|
}
|
|
|
|
if($partial && !$criteria) {
|
|
return count($this->getCategoriesRelatedById());
|
|
}
|
|
$query = CategoryQuery::create(null, $criteria);
|
|
if ($distinct) {
|
|
$query->distinct();
|
|
}
|
|
|
|
return $query
|
|
->filterByCategoryRelatedByCategoryId($this)
|
|
->count($con);
|
|
}
|
|
|
|
return count($this->collCategoriesRelatedById);
|
|
}
|
|
|
|
/**
|
|
* Method called to associate a Category object to this object
|
|
* through the Category foreign key attribute.
|
|
*
|
|
* @param Category $l Category
|
|
* @return Category The current object (for fluent API support)
|
|
*/
|
|
public function addCategoryRelatedById(Category $l)
|
|
{
|
|
if ($this->collCategoriesRelatedById === null) {
|
|
$this->initCategoriesRelatedById();
|
|
$this->collCategoriesRelatedByIdPartial = true;
|
|
}
|
|
if (!in_array($l, $this->collCategoriesRelatedById->getArrayCopy(), true)) { // only add it if the **same** object is not already associated
|
|
$this->doAddCategoryRelatedById($l);
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* @param CategoryRelatedById $categoryRelatedById The categoryRelatedById object to add.
|
|
*/
|
|
protected function doAddCategoryRelatedById($categoryRelatedById)
|
|
{
|
|
$this->collCategoriesRelatedById[]= $categoryRelatedById;
|
|
$categoryRelatedById->setCategoryRelatedByCategoryId($this);
|
|
}
|
|
|
|
/**
|
|
* @param CategoryRelatedById $categoryRelatedById The categoryRelatedById object to remove.
|
|
* @return Category The current object (for fluent API support)
|
|
*/
|
|
public function removeCategoryRelatedById($categoryRelatedById)
|
|
{
|
|
if ($this->getCategoriesRelatedById()->contains($categoryRelatedById)) {
|
|
$this->collCategoriesRelatedById->remove($this->collCategoriesRelatedById->search($categoryRelatedById));
|
|
if (null === $this->categoriesRelatedByIdScheduledForDeletion) {
|
|
$this->categoriesRelatedByIdScheduledForDeletion = clone $this->collCategoriesRelatedById;
|
|
$this->categoriesRelatedByIdScheduledForDeletion->clear();
|
|
}
|
|
$this->categoriesRelatedByIdScheduledForDeletion[]= $categoryRelatedById;
|
|
$categoryRelatedById->setCategoryRelatedByCategoryId(null);
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Clears the current object and sets all attributes to their default values
|
|
*/
|
|
public function clear()
|
|
{
|
|
$this->id = null;
|
|
$this->label = null;
|
|
$this->category_id = null;
|
|
$this->created_at = null;
|
|
$this->updated_at = null;
|
|
$this->slug = null;
|
|
$this->tree_left = null;
|
|
$this->tree_right = null;
|
|
$this->tree_level = null;
|
|
$this->alreadyInSave = false;
|
|
$this->alreadyInValidation = false;
|
|
$this->alreadyInClearAllReferencesDeep = false;
|
|
$this->clearAllReferences();
|
|
$this->resetModified();
|
|
$this->setNew(true);
|
|
$this->setDeleted(false);
|
|
}
|
|
|
|
/**
|
|
* Resets all references to other model objects or collections of model objects.
|
|
*
|
|
* This method is a user-space workaround for PHP's inability to garbage collect
|
|
* objects with circular references (even in PHP 5.3). This is currently necessary
|
|
* when using Propel in certain daemon or large-volumne/high-memory operations.
|
|
*
|
|
* @param boolean $deep Whether to also clear the references on all referrer objects.
|
|
*/
|
|
public function clearAllReferences($deep = false)
|
|
{
|
|
if ($deep && !$this->alreadyInClearAllReferencesDeep) {
|
|
$this->alreadyInClearAllReferencesDeep = true;
|
|
if ($this->collMedias) {
|
|
foreach ($this->collMedias as $o) {
|
|
$o->clearAllReferences($deep);
|
|
}
|
|
}
|
|
if ($this->collCategoriesRelatedById) {
|
|
foreach ($this->collCategoriesRelatedById as $o) {
|
|
$o->clearAllReferences($deep);
|
|
}
|
|
}
|
|
if ($this->aCategoryRelatedByCategoryId instanceof Persistent) {
|
|
$this->aCategoryRelatedByCategoryId->clearAllReferences($deep);
|
|
}
|
|
|
|
$this->alreadyInClearAllReferencesDeep = false;
|
|
} // if ($deep)
|
|
|
|
// nested_set behavior
|
|
$this->collNestedSetChildren = null;
|
|
$this->aNestedSetParent = null;
|
|
if ($this->collMedias instanceof PropelCollection) {
|
|
$this->collMedias->clearIterator();
|
|
}
|
|
$this->collMedias = null;
|
|
if ($this->collCategoriesRelatedById instanceof PropelCollection) {
|
|
$this->collCategoriesRelatedById->clearIterator();
|
|
}
|
|
$this->collCategoriesRelatedById = null;
|
|
$this->aCategoryRelatedByCategoryId = null;
|
|
}
|
|
|
|
/**
|
|
* return the string representation of this object
|
|
*
|
|
* @return string
|
|
*/
|
|
public function __toString()
|
|
{
|
|
return (string) $this->exportTo(CategoryPeer::DEFAULT_STRING_FORMAT);
|
|
}
|
|
|
|
/**
|
|
* return true is the object is in saving state
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public function isAlreadyInSave()
|
|
{
|
|
return $this->alreadyInSave;
|
|
}
|
|
|
|
// timestampable behavior
|
|
|
|
/**
|
|
* Mark the current object so that the update date doesn't get updated during next save
|
|
*
|
|
* @return Category The current object (for fluent API support)
|
|
*/
|
|
public function keepUpdateDateUnchanged()
|
|
{
|
|
$this->modifiedColumns[] = CategoryPeer::UPDATED_AT;
|
|
|
|
return $this;
|
|
}
|
|
|
|
// sluggable behavior
|
|
|
|
/**
|
|
* Create a unique slug based on the object
|
|
*
|
|
* @return string The object slug
|
|
*/
|
|
protected function createSlug()
|
|
{
|
|
$slug = $this->createRawSlug();
|
|
$slug = $this->limitSlugSize($slug);
|
|
$slug = $this->makeSlugUnique($slug);
|
|
|
|
return $slug;
|
|
}
|
|
|
|
/**
|
|
* Create the slug from the appropriate columns
|
|
*
|
|
* @return string
|
|
*/
|
|
protected function createRawSlug()
|
|
{
|
|
return '' . $this->cleanupSlugPart($this->getLabel()) . '';
|
|
}
|
|
|
|
/**
|
|
* Cleanup a string to make a slug of it
|
|
* Removes special characters, replaces blanks with a separator, and trim it
|
|
*
|
|
* @param string $slug the text to slugify
|
|
* @param string $replacement the separator used by slug
|
|
* @return string the slugified text
|
|
*/
|
|
protected static function cleanupSlugPart($slug, $replacement = '-')
|
|
{
|
|
// transliterate
|
|
if (function_exists('iconv')) {
|
|
$slug = iconv('utf-8', 'us-ascii//TRANSLIT', $slug);
|
|
}
|
|
|
|
// lowercase
|
|
if (function_exists('mb_strtolower')) {
|
|
$slug = mb_strtolower($slug);
|
|
} else {
|
|
$slug = strtolower($slug);
|
|
}
|
|
|
|
// remove accents resulting from OSX's iconv
|
|
$slug = str_replace(array('\'', '`', '^'), '', $slug);
|
|
|
|
// replace non letter or digits with separator
|
|
$slug = preg_replace('/\W+/', $replacement, $slug);
|
|
|
|
// trim
|
|
$slug = trim($slug, $replacement);
|
|
|
|
if (empty($slug)) {
|
|
return 'n-a';
|
|
}
|
|
|
|
return $slug;
|
|
}
|
|
|
|
|
|
/**
|
|
* Make sure the slug is short enough to accomodate the column size
|
|
*
|
|
* @param string $slug the slug to check
|
|
* @param int $incrementReservedSpace the number of characters to keep empty
|
|
*
|
|
* @return string the truncated slug
|
|
*/
|
|
protected static function limitSlugSize($slug, $incrementReservedSpace = 3)
|
|
{
|
|
// check length, as suffix could put it over maximum
|
|
if (strlen($slug) > (255 - $incrementReservedSpace)) {
|
|
$slug = substr($slug, 0, 255 - $incrementReservedSpace);
|
|
}
|
|
|
|
return $slug;
|
|
}
|
|
|
|
|
|
/**
|
|
* Get the slug, ensuring its uniqueness
|
|
*
|
|
* @param string $slug the slug to check
|
|
* @param string $separator the separator used by slug
|
|
* @param int $alreadyExists false for the first try, true for the second, and take the high count + 1
|
|
* @return string the unique slug
|
|
*/
|
|
protected function makeSlugUnique($slug, $separator = '-', $alreadyExists = false)
|
|
{
|
|
if (!$alreadyExists) {
|
|
$slug2 = $slug;
|
|
} else {
|
|
$slug2 = $slug . $separator;
|
|
}
|
|
|
|
$query = CategoryQuery::create('q')
|
|
->where('q.Slug ' . ($alreadyExists ? 'REGEXP' : '=') . ' ?', $alreadyExists ? '^' . $slug2 . '[0-9]+$' : $slug2)
|
|
->prune($this)
|
|
;
|
|
|
|
if (!$alreadyExists) {
|
|
$count = $query->count();
|
|
if ($count > 0) {
|
|
return $this->makeSlugUnique($slug, $separator, true);
|
|
}
|
|
|
|
return $slug2;
|
|
}
|
|
|
|
// Already exists
|
|
$object = $query
|
|
->addDescendingOrderByColumn('LENGTH(slug)')
|
|
->addDescendingOrderByColumn('slug')
|
|
->findOne();
|
|
|
|
// First duplicate slug
|
|
if (null == $object) {
|
|
return $slug2 . '1';
|
|
}
|
|
|
|
$slugNum = substr($object->getSlug(), strlen($slug) + 1);
|
|
if (0 == $slugNum[0]) {
|
|
$slugNum[0] = 1;
|
|
}
|
|
|
|
return $slug2 . ($slugNum + 1);
|
|
}
|
|
|
|
// nested_set behavior
|
|
|
|
/**
|
|
* Execute queries that were saved to be run inside the save transaction
|
|
*/
|
|
protected function processNestedSetQueries($con)
|
|
{
|
|
foreach ($this->nestedSetQueries as $query) {
|
|
$query['arguments'][]= $con;
|
|
call_user_func_array($query['callable'], $query['arguments']);
|
|
}
|
|
$this->nestedSetQueries = array();
|
|
}
|
|
|
|
/**
|
|
* Proxy getter method for the left value of the nested set model.
|
|
* It provides a generic way to get the value, whatever the actual column name is.
|
|
*
|
|
* @return int The nested set left value
|
|
*/
|
|
public function getLeftValue()
|
|
{
|
|
return $this->tree_left;
|
|
}
|
|
|
|
/**
|
|
* Proxy getter method for the right value of the nested set model.
|
|
* It provides a generic way to get the value, whatever the actual column name is.
|
|
*
|
|
* @return int The nested set right value
|
|
*/
|
|
public function getRightValue()
|
|
{
|
|
return $this->tree_right;
|
|
}
|
|
|
|
/**
|
|
* Proxy getter method for the level value of the nested set model.
|
|
* It provides a generic way to get the value, whatever the actual column name is.
|
|
*
|
|
* @return int The nested set level value
|
|
*/
|
|
public function getLevel()
|
|
{
|
|
return $this->tree_level;
|
|
}
|
|
|
|
/**
|
|
* Proxy setter method for the left value of the nested set model.
|
|
* It provides a generic way to set the value, whatever the actual column name is.
|
|
*
|
|
* @param int $v The nested set left value
|
|
* @return Category The current object (for fluent API support)
|
|
*/
|
|
public function setLeftValue($v)
|
|
{
|
|
return $this->setTreeLeft($v);
|
|
}
|
|
|
|
/**
|
|
* Proxy setter method for the right value of the nested set model.
|
|
* It provides a generic way to set the value, whatever the actual column name is.
|
|
*
|
|
* @param int $v The nested set right value
|
|
* @return Category The current object (for fluent API support)
|
|
*/
|
|
public function setRightValue($v)
|
|
{
|
|
return $this->setTreeRight($v);
|
|
}
|
|
|
|
/**
|
|
* Proxy setter method for the level value of the nested set model.
|
|
* It provides a generic way to set the value, whatever the actual column name is.
|
|
*
|
|
* @param int $v The nested set level value
|
|
* @return Category The current object (for fluent API support)
|
|
*/
|
|
public function setLevel($v)
|
|
{
|
|
return $this->setTreeLevel($v);
|
|
}
|
|
|
|
/**
|
|
* Creates the supplied node as the root node.
|
|
*
|
|
* @return Category The current object (for fluent API support)
|
|
* @throws PropelException
|
|
*/
|
|
public function makeRoot()
|
|
{
|
|
if ($this->getLeftValue() || $this->getRightValue()) {
|
|
throw new PropelException('Cannot turn an existing node into a root node.');
|
|
}
|
|
|
|
$this->setLeftValue(1);
|
|
$this->setRightValue(2);
|
|
$this->setLevel(0);
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Tests if onbject is a node, i.e. if it is inserted in the tree
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function isInTree()
|
|
{
|
|
return $this->getLeftValue() > 0 && $this->getRightValue() > $this->getLeftValue();
|
|
}
|
|
|
|
/**
|
|
* Tests if node is a root
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function isRoot()
|
|
{
|
|
return $this->isInTree() && $this->getLeftValue() == 1;
|
|
}
|
|
|
|
/**
|
|
* Tests if node is a leaf
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function isLeaf()
|
|
{
|
|
return $this->isInTree() && ($this->getRightValue() - $this->getLeftValue()) == 1;
|
|
}
|
|
|
|
/**
|
|
* Tests if node is a descendant of another node
|
|
*
|
|
* @param Category $node Propel node object
|
|
* @return bool
|
|
*/
|
|
public function isDescendantOf($parent)
|
|
{
|
|
|
|
return $this->isInTree() && $this->getLeftValue() > $parent->getLeftValue() && $this->getRightValue() < $parent->getRightValue();
|
|
}
|
|
|
|
/**
|
|
* Tests if node is a ancestor of another node
|
|
*
|
|
* @param Category $node Propel node object
|
|
* @return bool
|
|
*/
|
|
public function isAncestorOf($child)
|
|
{
|
|
return $child->isDescendantOf($this);
|
|
}
|
|
|
|
/**
|
|
* Tests if object has an ancestor
|
|
*
|
|
* @param PropelPDO $con Connection to use.
|
|
* @return bool
|
|
*/
|
|
public function hasParent(PropelPDO $con = null)
|
|
{
|
|
return $this->getLevel() > 0;
|
|
}
|
|
|
|
/**
|
|
* Sets the cache for parent node of the current object.
|
|
* Warning: this does not move the current object in the tree.
|
|
* Use moveTofirstChildOf() or moveToLastChildOf() for that purpose
|
|
*
|
|
* @param Category $parent
|
|
* @return Category The current object, for fluid interface
|
|
*/
|
|
public function setParent($parent = null)
|
|
{
|
|
$this->aNestedSetParent = $parent;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Gets parent node for the current object if it exists
|
|
* The result is cached so further calls to the same method don't issue any queries
|
|
*
|
|
* @param PropelPDO $con Connection to use.
|
|
* @return mixed Propel object if exists else false
|
|
*/
|
|
public function getParent(PropelPDO $con = null)
|
|
{
|
|
if ($this->aNestedSetParent === null && $this->hasParent()) {
|
|
$this->aNestedSetParent = CategoryQuery::create()
|
|
->ancestorsOf($this)
|
|
->orderByLevel(true)
|
|
->findOne($con);
|
|
}
|
|
|
|
return $this->aNestedSetParent;
|
|
}
|
|
|
|
/**
|
|
* Determines if the node has previous sibling
|
|
*
|
|
* @param PropelPDO $con Connection to use.
|
|
* @return bool
|
|
*/
|
|
public function hasPrevSibling(PropelPDO $con = null)
|
|
{
|
|
if (!CategoryPeer::isValid($this)) {
|
|
return false;
|
|
}
|
|
|
|
return CategoryQuery::create()
|
|
->filterByTreeRight($this->getLeftValue() - 1)
|
|
->count($con) > 0;
|
|
}
|
|
|
|
/**
|
|
* Gets previous sibling for the given node if it exists
|
|
*
|
|
* @param PropelPDO $con Connection to use.
|
|
* @return mixed Propel object if exists else false
|
|
*/
|
|
public function getPrevSibling(PropelPDO $con = null)
|
|
{
|
|
return CategoryQuery::create()
|
|
->filterByTreeRight($this->getLeftValue() - 1)
|
|
->findOne($con);
|
|
}
|
|
|
|
/**
|
|
* Determines if the node has next sibling
|
|
*
|
|
* @param PropelPDO $con Connection to use.
|
|
* @return bool
|
|
*/
|
|
public function hasNextSibling(PropelPDO $con = null)
|
|
{
|
|
if (!CategoryPeer::isValid($this)) {
|
|
return false;
|
|
}
|
|
|
|
return CategoryQuery::create()
|
|
->filterByTreeLeft($this->getRightValue() + 1)
|
|
->count($con) > 0;
|
|
}
|
|
|
|
/**
|
|
* Gets next sibling for the given node if it exists
|
|
*
|
|
* @param PropelPDO $con Connection to use.
|
|
* @return mixed Propel object if exists else false
|
|
*/
|
|
public function getNextSibling(PropelPDO $con = null)
|
|
{
|
|
return CategoryQuery::create()
|
|
->filterByTreeLeft($this->getRightValue() + 1)
|
|
->findOne($con);
|
|
}
|
|
|
|
/**
|
|
* Clears out the $collNestedSetChildren 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
|
|
*/
|
|
public function clearNestedSetChildren()
|
|
{
|
|
$this->collNestedSetChildren = null;
|
|
}
|
|
|
|
/**
|
|
* Initializes the $collNestedSetChildren collection.
|
|
*
|
|
* @return void
|
|
*/
|
|
public function initNestedSetChildren()
|
|
{
|
|
$this->collNestedSetChildren = new PropelObjectCollection();
|
|
$this->collNestedSetChildren->setModel('Category');
|
|
}
|
|
|
|
/**
|
|
* Adds an element to the internal $collNestedSetChildren collection.
|
|
* Beware that this doesn't insert a node in the tree.
|
|
* This method is only used to facilitate children hydration.
|
|
*
|
|
* @param Category $category
|
|
*
|
|
* @return void
|
|
*/
|
|
public function addNestedSetChild($category)
|
|
{
|
|
if ($this->collNestedSetChildren === null) {
|
|
$this->initNestedSetChildren();
|
|
}
|
|
if (!in_array($category, $this->collNestedSetChildren->getArrayCopy(), true)) { // only add it if the **same** object is not already associated
|
|
$this->collNestedSetChildren[]= $category;
|
|
$category->setParent($this);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Tests if node has children
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function hasChildren()
|
|
{
|
|
return ($this->getRightValue() - $this->getLeftValue()) > 1;
|
|
}
|
|
|
|
/**
|
|
* Gets the children of the given node
|
|
*
|
|
* @param Criteria $criteria Criteria to filter results.
|
|
* @param PropelPDO $con Connection to use.
|
|
* @return array List of Category objects
|
|
*/
|
|
public function getChildren($criteria = null, PropelPDO $con = null)
|
|
{
|
|
if (null === $this->collNestedSetChildren || null !== $criteria) {
|
|
if ($this->isLeaf() || ($this->isNew() && null === $this->collNestedSetChildren)) {
|
|
// return empty collection
|
|
$this->initNestedSetChildren();
|
|
} else {
|
|
$collNestedSetChildren = CategoryQuery::create(null, $criteria)
|
|
->childrenOf($this)
|
|
->orderByBranch()
|
|
->find($con);
|
|
if (null !== $criteria) {
|
|
return $collNestedSetChildren;
|
|
}
|
|
$this->collNestedSetChildren = $collNestedSetChildren;
|
|
}
|
|
}
|
|
|
|
return $this->collNestedSetChildren;
|
|
}
|
|
|
|
/**
|
|
* Gets number of children for the given node
|
|
*
|
|
* @param Criteria $criteria Criteria to filter results.
|
|
* @param PropelPDO $con Connection to use.
|
|
* @return int Number of children
|
|
*/
|
|
public function countChildren($criteria = null, PropelPDO $con = null)
|
|
{
|
|
if (null === $this->collNestedSetChildren || null !== $criteria) {
|
|
if ($this->isLeaf() || ($this->isNew() && null === $this->collNestedSetChildren)) {
|
|
return 0;
|
|
} else {
|
|
return CategoryQuery::create(null, $criteria)
|
|
->childrenOf($this)
|
|
->count($con);
|
|
}
|
|
} else {
|
|
return count($this->collNestedSetChildren);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Gets the first child of the given node
|
|
*
|
|
* @param Criteria $query Criteria to filter results.
|
|
* @param PropelPDO $con Connection to use.
|
|
* @return array List of Category objects
|
|
*/
|
|
public function getFirstChild($query = null, PropelPDO $con = null)
|
|
{
|
|
if ($this->isLeaf()) {
|
|
return array();
|
|
} else {
|
|
return CategoryQuery::create(null, $query)
|
|
->childrenOf($this)
|
|
->orderByBranch()
|
|
->findOne($con);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Gets the last child of the given node
|
|
*
|
|
* @param Criteria $query Criteria to filter results.
|
|
* @param PropelPDO $con Connection to use.
|
|
* @return array List of Category objects
|
|
*/
|
|
public function getLastChild($query = null, PropelPDO $con = null)
|
|
{
|
|
if ($this->isLeaf()) {
|
|
return array();
|
|
} else {
|
|
return CategoryQuery::create(null, $query)
|
|
->childrenOf($this)
|
|
->orderByBranch(true)
|
|
->findOne($con);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Gets the siblings of the given node
|
|
*
|
|
* @param bool $includeNode Whether to include the current node or not
|
|
* @param Criteria $query Criteria to filter results.
|
|
* @param PropelPDO $con Connection to use.
|
|
*
|
|
* @return array List of Category objects
|
|
*/
|
|
public function getSiblings($includeNode = false, $query = null, PropelPDO $con = null)
|
|
{
|
|
if ($this->isRoot()) {
|
|
return array();
|
|
} else {
|
|
$query = CategoryQuery::create(null, $query)
|
|
->childrenOf($this->getParent($con))
|
|
->orderByBranch();
|
|
if (!$includeNode) {
|
|
$query->prune($this);
|
|
}
|
|
|
|
return $query->find($con);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Gets descendants for the given node
|
|
*
|
|
* @param Criteria $query Criteria to filter results.
|
|
* @param PropelPDO $con Connection to use.
|
|
* @return array List of Category objects
|
|
*/
|
|
public function getDescendants($query = null, PropelPDO $con = null)
|
|
{
|
|
if ($this->isLeaf()) {
|
|
return array();
|
|
} else {
|
|
return CategoryQuery::create(null, $query)
|
|
->descendantsOf($this)
|
|
->orderByBranch()
|
|
->find($con);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Gets number of descendants for the given node
|
|
*
|
|
* @param Criteria $query Criteria to filter results.
|
|
* @param PropelPDO $con Connection to use.
|
|
* @return int Number of descendants
|
|
*/
|
|
public function countDescendants($query = null, PropelPDO $con = null)
|
|
{
|
|
if ($this->isLeaf()) {
|
|
// save one query
|
|
return 0;
|
|
} else {
|
|
return CategoryQuery::create(null, $query)
|
|
->descendantsOf($this)
|
|
->count($con);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Gets descendants for the given node, plus the current node
|
|
*
|
|
* @param Criteria $query Criteria to filter results.
|
|
* @param PropelPDO $con Connection to use.
|
|
* @return array List of Category objects
|
|
*/
|
|
public function getBranch($query = null, PropelPDO $con = null)
|
|
{
|
|
return CategoryQuery::create(null, $query)
|
|
->branchOf($this)
|
|
->orderByBranch()
|
|
->find($con);
|
|
}
|
|
|
|
/**
|
|
* Gets ancestors for the given node, starting with the root node
|
|
* Use it for breadcrumb paths for instance
|
|
*
|
|
* @param Criteria $query Criteria to filter results.
|
|
* @param PropelPDO $con Connection to use.
|
|
* @return array List of Category objects
|
|
*/
|
|
public function getAncestors($query = null, PropelPDO $con = null)
|
|
{
|
|
if ($this->isRoot()) {
|
|
// save one query
|
|
return array();
|
|
} else {
|
|
return CategoryQuery::create(null, $query)
|
|
->ancestorsOf($this)
|
|
->orderByBranch()
|
|
->find($con);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Inserts the given $child node as first child of current
|
|
* The modifications in the current object and the tree
|
|
* are not persisted until the child object is saved.
|
|
*
|
|
* @param Category $child Propel object for child node
|
|
*
|
|
* @return Category The current Propel object
|
|
*/
|
|
public function addChild(Category $child)
|
|
{
|
|
if ($this->isNew()) {
|
|
throw new PropelException('A Category object must not be new to accept children.');
|
|
}
|
|
$child->insertAsFirstChildOf($this);
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Inserts the current node as first child of given $parent node
|
|
* The modifications in the current object and the tree
|
|
* are not persisted until the current object is saved.
|
|
*
|
|
* @param Category $parent Propel object for parent node
|
|
*
|
|
* @return Category The current Propel object
|
|
*/
|
|
public function insertAsFirstChildOf($parent)
|
|
{
|
|
if ($this->isInTree()) {
|
|
throw new PropelException('A Category object must not already be in the tree to be inserted. Use the moveToFirstChildOf() instead.');
|
|
}
|
|
$left = $parent->getLeftValue() + 1;
|
|
// Update node properties
|
|
$this->setLeftValue($left);
|
|
$this->setRightValue($left + 1);
|
|
$this->setLevel($parent->getLevel() + 1);
|
|
// update the children collection of the parent
|
|
$parent->addNestedSetChild($this);
|
|
|
|
// Keep the tree modification query for the save() transaction
|
|
$this->nestedSetQueries []= array(
|
|
'callable' => array('\\Trinity\Bundle\MediaBundle\Model\\CategoryPeer', 'makeRoomForLeaf'),
|
|
'arguments' => array($left, $this->isNew() ? null : $this)
|
|
);
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Inserts the current node as last child of given $parent node
|
|
* The modifications in the current object and the tree
|
|
* are not persisted until the current object is saved.
|
|
*
|
|
* @param Category $parent Propel object for parent node
|
|
*
|
|
* @return Category The current Propel object
|
|
*/
|
|
public function insertAsLastChildOf($parent)
|
|
{
|
|
if ($this->isInTree()) {
|
|
throw new PropelException('A Category object must not already be in the tree to be inserted. Use the moveToLastChildOf() instead.');
|
|
}
|
|
$left = $parent->getRightValue();
|
|
// Update node properties
|
|
$this->setLeftValue($left);
|
|
$this->setRightValue($left + 1);
|
|
$this->setLevel($parent->getLevel() + 1);
|
|
// update the children collection of the parent
|
|
$parent->addNestedSetChild($this);
|
|
|
|
// Keep the tree modification query for the save() transaction
|
|
$this->nestedSetQueries []= array(
|
|
'callable' => array('\\Trinity\Bundle\MediaBundle\Model\\CategoryPeer', 'makeRoomForLeaf'),
|
|
'arguments' => array($left, $this->isNew() ? null : $this)
|
|
);
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Inserts the current node as prev sibling given $sibling node
|
|
* The modifications in the current object and the tree
|
|
* are not persisted until the current object is saved.
|
|
*
|
|
* @param Category $sibling Propel object for parent node
|
|
*
|
|
* @return Category The current Propel object
|
|
*/
|
|
public function insertAsPrevSiblingOf($sibling)
|
|
{
|
|
if ($this->isInTree()) {
|
|
throw new PropelException('A Category object must not already be in the tree to be inserted. Use the moveToPrevSiblingOf() instead.');
|
|
}
|
|
$left = $sibling->getLeftValue();
|
|
// Update node properties
|
|
$this->setLeftValue($left);
|
|
$this->setRightValue($left + 1);
|
|
$this->setLevel($sibling->getLevel());
|
|
// Keep the tree modification query for the save() transaction
|
|
$this->nestedSetQueries []= array(
|
|
'callable' => array('\\Trinity\Bundle\MediaBundle\Model\\CategoryPeer', 'makeRoomForLeaf'),
|
|
'arguments' => array($left, $this->isNew() ? null : $this)
|
|
);
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Inserts the current node as next sibling given $sibling node
|
|
* The modifications in the current object and the tree
|
|
* are not persisted until the current object is saved.
|
|
*
|
|
* @param Category $sibling Propel object for parent node
|
|
*
|
|
* @return Category The current Propel object
|
|
*/
|
|
public function insertAsNextSiblingOf($sibling)
|
|
{
|
|
if ($this->isInTree()) {
|
|
throw new PropelException('A Category object must not already be in the tree to be inserted. Use the moveToNextSiblingOf() instead.');
|
|
}
|
|
$left = $sibling->getRightValue() + 1;
|
|
// Update node properties
|
|
$this->setLeftValue($left);
|
|
$this->setRightValue($left + 1);
|
|
$this->setLevel($sibling->getLevel());
|
|
// Keep the tree modification query for the save() transaction
|
|
$this->nestedSetQueries []= array(
|
|
'callable' => array('\\Trinity\Bundle\MediaBundle\Model\\CategoryPeer', 'makeRoomForLeaf'),
|
|
'arguments' => array($left, $this->isNew() ? null : $this)
|
|
);
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Moves current node and its subtree to be the first child of $parent
|
|
* The modifications in the current object and the tree are immediate
|
|
*
|
|
* @param Category $parent Propel object for parent node
|
|
* @param PropelPDO $con Connection to use.
|
|
*
|
|
* @return Category The current Propel object
|
|
*/
|
|
public function moveToFirstChildOf($parent, PropelPDO $con = null)
|
|
{
|
|
if (!$this->isInTree()) {
|
|
throw new PropelException('A Category object must be already in the tree to be moved. Use the insertAsFirstChildOf() instead.');
|
|
}
|
|
if ($parent->isDescendantOf($this)) {
|
|
throw new PropelException('Cannot move a node as child of one of its subtree nodes.');
|
|
}
|
|
|
|
$this->moveSubtreeTo($parent->getLeftValue() + 1, $parent->getLevel() - $this->getLevel() + 1, $con);
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Moves current node and its subtree to be the last child of $parent
|
|
* The modifications in the current object and the tree are immediate
|
|
*
|
|
* @param Category $parent Propel object for parent node
|
|
* @param PropelPDO $con Connection to use.
|
|
*
|
|
* @return Category The current Propel object
|
|
*/
|
|
public function moveToLastChildOf($parent, PropelPDO $con = null)
|
|
{
|
|
if (!$this->isInTree()) {
|
|
throw new PropelException('A Category object must be already in the tree to be moved. Use the insertAsLastChildOf() instead.');
|
|
}
|
|
if ($parent->isDescendantOf($this)) {
|
|
throw new PropelException('Cannot move a node as child of one of its subtree nodes.');
|
|
}
|
|
|
|
$this->moveSubtreeTo($parent->getRightValue(), $parent->getLevel() - $this->getLevel() + 1, $con);
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Moves current node and its subtree to be the previous sibling of $sibling
|
|
* The modifications in the current object and the tree are immediate
|
|
*
|
|
* @param Category $sibling Propel object for sibling node
|
|
* @param PropelPDO $con Connection to use.
|
|
*
|
|
* @return Category The current Propel object
|
|
*/
|
|
public function moveToPrevSiblingOf($sibling, PropelPDO $con = null)
|
|
{
|
|
if (!$this->isInTree()) {
|
|
throw new PropelException('A Category object must be already in the tree to be moved. Use the insertAsPrevSiblingOf() instead.');
|
|
}
|
|
if ($sibling->isRoot()) {
|
|
throw new PropelException('Cannot move to previous sibling of a root node.');
|
|
}
|
|
if ($sibling->isDescendantOf($this)) {
|
|
throw new PropelException('Cannot move a node as sibling of one of its subtree nodes.');
|
|
}
|
|
|
|
$this->moveSubtreeTo($sibling->getLeftValue(), $sibling->getLevel() - $this->getLevel(), $con);
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Moves current node and its subtree to be the next sibling of $sibling
|
|
* The modifications in the current object and the tree are immediate
|
|
*
|
|
* @param Category $sibling Propel object for sibling node
|
|
* @param PropelPDO $con Connection to use.
|
|
*
|
|
* @return Category The current Propel object
|
|
*/
|
|
public function moveToNextSiblingOf($sibling, PropelPDO $con = null)
|
|
{
|
|
if (!$this->isInTree()) {
|
|
throw new PropelException('A Category object must be already in the tree to be moved. Use the insertAsNextSiblingOf() instead.');
|
|
}
|
|
if ($sibling->isRoot()) {
|
|
throw new PropelException('Cannot move to next sibling of a root node.');
|
|
}
|
|
if ($sibling->isDescendantOf($this)) {
|
|
throw new PropelException('Cannot move a node as sibling of one of its subtree nodes.');
|
|
}
|
|
|
|
$this->moveSubtreeTo($sibling->getRightValue() + 1, $sibling->getLevel() - $this->getLevel(), $con);
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Move current node and its children to location $destLeft and updates rest of tree
|
|
*
|
|
* @param int $destLeft Destination left value
|
|
* @param int $levelDelta Delta to add to the levels
|
|
* @param PropelPDO $con Connection to use.
|
|
*/
|
|
protected function moveSubtreeTo($destLeft, $levelDelta, PropelPDO $con = null)
|
|
{
|
|
$preventDefault = false;
|
|
$left = $this->getLeftValue();
|
|
$right = $this->getRightValue();
|
|
|
|
|
|
$treeSize = $right - $left +1;
|
|
|
|
if ($con === null) {
|
|
$con = Propel::getConnection(CategoryPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);
|
|
}
|
|
|
|
$con->beginTransaction();
|
|
try {
|
|
|
|
// make room next to the target for the subtree
|
|
CategoryPeer::shiftRLValues($treeSize, $destLeft, null, $con);
|
|
|
|
|
|
|
|
if (!$preventDefault){
|
|
|
|
|
|
if ($left >= $destLeft) { // src was shifted too?
|
|
$left += $treeSize;
|
|
$right += $treeSize;
|
|
}
|
|
|
|
if ($levelDelta) {
|
|
// update the levels of the subtree
|
|
CategoryPeer::shiftLevel($levelDelta, $left, $right, $con);
|
|
}
|
|
|
|
// move the subtree to the target
|
|
CategoryPeer::shiftRLValues($destLeft - $left, $left, $right, $con);
|
|
}
|
|
|
|
// remove the empty room at the previous location of the subtree
|
|
CategoryPeer::shiftRLValues(-$treeSize, $right + 1, null, $con);
|
|
|
|
// update all loaded nodes
|
|
CategoryPeer::updateLoadedNodes(null, $con);
|
|
|
|
$con->commit();
|
|
} catch (PropelException $e) {
|
|
$con->rollback();
|
|
throw $e;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Deletes all descendants for the given node
|
|
* Instance pooling is wiped out by this command,
|
|
* so existing Category instances are probably invalid (except for the current one)
|
|
*
|
|
* @param PropelPDO $con Connection to use.
|
|
*
|
|
* @return int number of deleted nodes
|
|
*/
|
|
public function deleteDescendants(PropelPDO $con = null)
|
|
{
|
|
if ($this->isLeaf()) {
|
|
// save one query
|
|
return;
|
|
}
|
|
if ($con === null) {
|
|
$con = Propel::getConnection(CategoryPeer::DATABASE_NAME, Propel::CONNECTION_READ);
|
|
}
|
|
$left = $this->getLeftValue();
|
|
$right = $this->getRightValue();
|
|
$con->beginTransaction();
|
|
try {
|
|
// delete descendant nodes (will empty the instance pool)
|
|
$ret = CategoryQuery::create()
|
|
->descendantsOf($this)
|
|
->delete($con);
|
|
|
|
// fill up the room that was used by descendants
|
|
CategoryPeer::shiftRLValues($left - $right + 1, $right, null, $con);
|
|
|
|
// fix the right value for the current node, which is now a leaf
|
|
$this->setRightValue($left + 1);
|
|
|
|
$con->commit();
|
|
} catch (Exception $e) {
|
|
$con->rollback();
|
|
throw $e;
|
|
}
|
|
|
|
return $ret;
|
|
}
|
|
|
|
/**
|
|
* Returns a pre-order iterator for this node and its children.
|
|
*
|
|
* @return RecursiveIterator
|
|
*/
|
|
public function getIterator()
|
|
{
|
|
return new NestedSetRecursiveIterator($this);
|
|
}
|
|
|
|
}
|