1017 lines
28 KiB
PHP
1017 lines
28 KiB
PHP
<?php
|
|
|
|
|
|
/**
|
|
* Base class that represents a row from the 'cc_music_dirs' table.
|
|
*
|
|
*
|
|
*
|
|
* @package propel.generator.airtime.om
|
|
*/
|
|
abstract class BaseCcMusicDirs extends BaseObject implements Persistent
|
|
{
|
|
|
|
/**
|
|
* Peer class name
|
|
*/
|
|
const PEER = 'CcMusicDirsPeer';
|
|
|
|
/**
|
|
* 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 CcMusicDirsPeer
|
|
*/
|
|
protected static $peer;
|
|
|
|
/**
|
|
* The value for the id field.
|
|
* @var int
|
|
*/
|
|
protected $id;
|
|
|
|
/**
|
|
* The value for the directory field.
|
|
* @var string
|
|
*/
|
|
protected $directory;
|
|
|
|
/**
|
|
* The value for the type field.
|
|
* @var string
|
|
*/
|
|
protected $type;
|
|
|
|
/**
|
|
* The value for the removed field.
|
|
* Note: this column has a database default value of: false
|
|
* @var boolean
|
|
*/
|
|
protected $removed;
|
|
|
|
/**
|
|
* @var array CcFiles[] Collection to store aggregation of CcFiles objects.
|
|
*/
|
|
protected $collCcFiless;
|
|
|
|
/**
|
|
* 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;
|
|
|
|
/**
|
|
* Applies default values to this object.
|
|
* This method should be called from the object's constructor (or
|
|
* equivalent initialization method).
|
|
* @see __construct()
|
|
*/
|
|
public function applyDefaultValues()
|
|
{
|
|
$this->removed = false;
|
|
}
|
|
|
|
/**
|
|
* Initializes internal state of BaseCcMusicDirs object.
|
|
* @see applyDefaults()
|
|
*/
|
|
public function __construct()
|
|
{
|
|
parent::__construct();
|
|
$this->applyDefaultValues();
|
|
}
|
|
|
|
/**
|
|
* Get the [id] column value.
|
|
*
|
|
* @return int
|
|
*/
|
|
public function getId()
|
|
{
|
|
return $this->id;
|
|
}
|
|
|
|
/**
|
|
* Get the [directory] column value.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getDirectory()
|
|
{
|
|
return $this->directory;
|
|
}
|
|
|
|
/**
|
|
* Get the [type] column value.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getType()
|
|
{
|
|
return $this->type;
|
|
}
|
|
|
|
/**
|
|
* Get the [removed] column value.
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public function getRemoved()
|
|
{
|
|
return $this->removed;
|
|
}
|
|
|
|
/**
|
|
* Set the value of [id] column.
|
|
*
|
|
* @param int $v new value
|
|
* @return CcMusicDirs The current object (for fluent API support)
|
|
*/
|
|
public function setId($v)
|
|
{
|
|
if ($v !== null) {
|
|
$v = (int) $v;
|
|
}
|
|
|
|
if ($this->id !== $v) {
|
|
$this->id = $v;
|
|
$this->modifiedColumns[] = CcMusicDirsPeer::ID;
|
|
}
|
|
|
|
return $this;
|
|
} // setId()
|
|
|
|
/**
|
|
* Set the value of [directory] column.
|
|
*
|
|
* @param string $v new value
|
|
* @return CcMusicDirs The current object (for fluent API support)
|
|
*/
|
|
public function setDirectory($v)
|
|
{
|
|
if ($v !== null) {
|
|
$v = (string) $v;
|
|
}
|
|
|
|
if ($this->directory !== $v) {
|
|
$this->directory = $v;
|
|
$this->modifiedColumns[] = CcMusicDirsPeer::DIRECTORY;
|
|
}
|
|
|
|
return $this;
|
|
} // setDirectory()
|
|
|
|
/**
|
|
* Set the value of [type] column.
|
|
*
|
|
* @param string $v new value
|
|
* @return CcMusicDirs The current object (for fluent API support)
|
|
*/
|
|
public function setType($v)
|
|
{
|
|
if ($v !== null) {
|
|
$v = (string) $v;
|
|
}
|
|
|
|
if ($this->type !== $v) {
|
|
$this->type = $v;
|
|
$this->modifiedColumns[] = CcMusicDirsPeer::TYPE;
|
|
}
|
|
|
|
return $this;
|
|
} // setType()
|
|
|
|
/**
|
|
* Set the value of [removed] column.
|
|
*
|
|
* @param boolean $v new value
|
|
* @return CcMusicDirs The current object (for fluent API support)
|
|
*/
|
|
public function setRemoved($v)
|
|
{
|
|
if ($v !== null) {
|
|
$v = (boolean) $v;
|
|
}
|
|
|
|
if ($this->removed !== $v || $this->isNew()) {
|
|
$this->removed = $v;
|
|
$this->modifiedColumns[] = CcMusicDirsPeer::REMOVED;
|
|
}
|
|
|
|
return $this;
|
|
} // setRemoved()
|
|
|
|
/**
|
|
* 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()
|
|
{
|
|
if ($this->removed !== false) {
|
|
return false;
|
|
}
|
|
|
|
// 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->directory = ($row[$startcol + 1] !== null) ? (string) $row[$startcol + 1] : null;
|
|
$this->type = ($row[$startcol + 2] !== null) ? (string) $row[$startcol + 2] : null;
|
|
$this->removed = ($row[$startcol + 3] !== null) ? (boolean) $row[$startcol + 3] : null;
|
|
$this->resetModified();
|
|
|
|
$this->setNew(false);
|
|
|
|
if ($rehydrate) {
|
|
$this->ensureConsistency();
|
|
}
|
|
|
|
return $startcol + 4; // 4 = CcMusicDirsPeer::NUM_COLUMNS - CcMusicDirsPeer::NUM_LAZY_LOAD_COLUMNS).
|
|
|
|
} catch (Exception $e) {
|
|
throw new PropelException("Error populating CcMusicDirs object", $e);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Checks and repairs the internal consistency of the object.
|
|
*
|
|
* This method is executed after an already-instantiated object is re-hydrated
|
|
* from the database. It exists to check any foreign keys to make sure that
|
|
* the objects related to the current object are correct based on foreign key.
|
|
*
|
|
* You can override this method in the stub class, but you should always invoke
|
|
* the base method from the overridden method (i.e. parent::ensureConsistency()),
|
|
* in case your model changes.
|
|
*
|
|
* @throws PropelException
|
|
*/
|
|
public function ensureConsistency()
|
|
{
|
|
|
|
} // ensureConsistency
|
|
|
|
/**
|
|
* Reloads this object from datastore based on primary key and (optionally) resets all associated objects.
|
|
*
|
|
* This will only work if the object has been saved and has a valid primary key set.
|
|
*
|
|
* @param boolean $deep (optional) Whether to also de-associated any related objects.
|
|
* @param PropelPDO $con (optional) The PropelPDO connection to use.
|
|
* @return void
|
|
* @throws PropelException - if this object is deleted, unsaved or doesn't have pk match in db
|
|
*/
|
|
public function reload($deep = false, PropelPDO $con = null)
|
|
{
|
|
if ($this->isDeleted()) {
|
|
throw new PropelException("Cannot reload a deleted object.");
|
|
}
|
|
|
|
if ($this->isNew()) {
|
|
throw new PropelException("Cannot reload an unsaved object.");
|
|
}
|
|
|
|
if ($con === null) {
|
|
$con = Propel::getConnection(CcMusicDirsPeer::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 = CcMusicDirsPeer::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->collCcFiless = null;
|
|
|
|
} // if (deep)
|
|
}
|
|
|
|
/**
|
|
* Removes this object from datastore and sets delete attribute.
|
|
*
|
|
* @param PropelPDO $con
|
|
* @return void
|
|
* @throws PropelException
|
|
* @see BaseObject::setDeleted()
|
|
* @see BaseObject::isDeleted()
|
|
*/
|
|
public function delete(PropelPDO $con = null)
|
|
{
|
|
if ($this->isDeleted()) {
|
|
throw new PropelException("This object has already been deleted.");
|
|
}
|
|
|
|
if ($con === null) {
|
|
$con = Propel::getConnection(CcMusicDirsPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);
|
|
}
|
|
|
|
$con->beginTransaction();
|
|
try {
|
|
$ret = $this->preDelete($con);
|
|
if ($ret) {
|
|
CcMusicDirsQuery::create()
|
|
->filterByPrimaryKey($this->getPrimaryKey())
|
|
->delete($con);
|
|
$this->postDelete($con);
|
|
$con->commit();
|
|
$this->setDeleted(true);
|
|
} else {
|
|
$con->commit();
|
|
}
|
|
} catch (PropelException $e) {
|
|
$con->rollBack();
|
|
throw $e;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Persists this object to the database.
|
|
*
|
|
* If the object is new, it inserts it; otherwise an update is performed.
|
|
* All modified related objects will also be persisted in the doSave()
|
|
* method. This method wraps all precipitate database operations in a
|
|
* single transaction.
|
|
*
|
|
* @param PropelPDO $con
|
|
* @return int The number of rows affected by this insert/update and any referring fk objects' save() operations.
|
|
* @throws PropelException
|
|
* @see doSave()
|
|
*/
|
|
public function save(PropelPDO $con = null)
|
|
{
|
|
if ($this->isDeleted()) {
|
|
throw new PropelException("You cannot save an object that has been deleted.");
|
|
}
|
|
|
|
if ($con === null) {
|
|
$con = Propel::getConnection(CcMusicDirsPeer::DATABASE_NAME, Propel::CONNECTION_WRITE);
|
|
}
|
|
|
|
$con->beginTransaction();
|
|
$isInsert = $this->isNew();
|
|
try {
|
|
$ret = $this->preSave($con);
|
|
if ($isInsert) {
|
|
$ret = $ret && $this->preInsert($con);
|
|
} else {
|
|
$ret = $ret && $this->preUpdate($con);
|
|
}
|
|
if ($ret) {
|
|
$affectedRows = $this->doSave($con);
|
|
if ($isInsert) {
|
|
$this->postInsert($con);
|
|
} else {
|
|
$this->postUpdate($con);
|
|
}
|
|
$this->postSave($con);
|
|
CcMusicDirsPeer::addInstanceToPool($this);
|
|
} else {
|
|
$affectedRows = 0;
|
|
}
|
|
$con->commit();
|
|
return $affectedRows;
|
|
} catch (PropelException $e) {
|
|
$con->rollBack();
|
|
throw $e;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Performs the work of inserting or updating the row in the database.
|
|
*
|
|
* If the object is new, it inserts it; otherwise an update is performed.
|
|
* All related objects are also updated in this method.
|
|
*
|
|
* @param PropelPDO $con
|
|
* @return int The number of rows affected by this insert/update and any referring fk objects' save() operations.
|
|
* @throws PropelException
|
|
* @see save()
|
|
*/
|
|
protected function doSave(PropelPDO $con)
|
|
{
|
|
$affectedRows = 0; // initialize var to track total num of affected rows
|
|
if (!$this->alreadyInSave) {
|
|
$this->alreadyInSave = true;
|
|
|
|
if ($this->isNew() ) {
|
|
$this->modifiedColumns[] = CcMusicDirsPeer::ID;
|
|
}
|
|
|
|
// If this object has been modified, then save it to the database.
|
|
if ($this->isModified()) {
|
|
if ($this->isNew()) {
|
|
$criteria = $this->buildCriteria();
|
|
if ($criteria->keyContainsValue(CcMusicDirsPeer::ID) ) {
|
|
throw new PropelException('Cannot insert a value for auto-increment primary key ('.CcMusicDirsPeer::ID.')');
|
|
}
|
|
|
|
$pk = BasePeer::doInsert($criteria, $con);
|
|
$affectedRows = 1;
|
|
$this->setId($pk); //[IMV] update autoincrement primary key
|
|
$this->setNew(false);
|
|
} else {
|
|
$affectedRows = CcMusicDirsPeer::doUpdate($this, $con);
|
|
}
|
|
|
|
$this->resetModified(); // [HL] After being saved an object is no longer 'modified'
|
|
}
|
|
|
|
if ($this->collCcFiless !== null) {
|
|
foreach ($this->collCcFiless as $referrerFK) {
|
|
if (!$referrerFK->isDeleted()) {
|
|
$affectedRows += $referrerFK->save($con);
|
|
}
|
|
}
|
|
}
|
|
|
|
$this->alreadyInSave = false;
|
|
|
|
}
|
|
return $affectedRows;
|
|
} // doSave()
|
|
|
|
/**
|
|
* Array of ValidationFailed objects.
|
|
* @var array ValidationFailed[]
|
|
*/
|
|
protected $validationFailures = array();
|
|
|
|
/**
|
|
* Gets any ValidationFailed objects that resulted from last call to validate().
|
|
*
|
|
*
|
|
* @return array ValidationFailed[]
|
|
* @see validate()
|
|
*/
|
|
public function getValidationFailures()
|
|
{
|
|
return $this->validationFailures;
|
|
}
|
|
|
|
/**
|
|
* Validates the objects modified field values and all objects related to this table.
|
|
*
|
|
* If $columns is either a column name or an array of column names
|
|
* only those columns are validated.
|
|
*
|
|
* @param mixed $columns Column name or an array of column names.
|
|
* @return boolean Whether all columns pass validation.
|
|
* @see doValidate()
|
|
* @see getValidationFailures()
|
|
*/
|
|
public function validate($columns = null)
|
|
{
|
|
$res = $this->doValidate($columns);
|
|
if ($res === true) {
|
|
$this->validationFailures = array();
|
|
return true;
|
|
} else {
|
|
$this->validationFailures = $res;
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* This function performs the validation work for complex object models.
|
|
*
|
|
* In addition to checking the current object, all related objects will
|
|
* also be validated. If all pass then <code>true</code> is returned; otherwise
|
|
* an aggreagated array of ValidationFailed objects will be returned.
|
|
*
|
|
* @param array $columns Array of column names to validate.
|
|
* @return mixed <code>true</code> if all validations pass; array of <code>ValidationFailed</code> objets otherwise.
|
|
*/
|
|
protected function doValidate($columns = null)
|
|
{
|
|
if (!$this->alreadyInValidation) {
|
|
$this->alreadyInValidation = true;
|
|
$retval = null;
|
|
|
|
$failureMap = array();
|
|
|
|
|
|
if (($retval = CcMusicDirsPeer::doValidate($this, $columns)) !== true) {
|
|
$failureMap = array_merge($failureMap, $retval);
|
|
}
|
|
|
|
|
|
if ($this->collCcFiless !== null) {
|
|
foreach ($this->collCcFiless as $referrerFK) {
|
|
if (!$referrerFK->validate($columns)) {
|
|
$failureMap = array_merge($failureMap, $referrerFK->getValidationFailures());
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
$this->alreadyInValidation = false;
|
|
}
|
|
|
|
return (!empty($failureMap) ? $failureMap : true);
|
|
}
|
|
|
|
/**
|
|
* Retrieves a field from the object by name passed in as a string.
|
|
*
|
|
* @param string $name name
|
|
* @param string $type The type of fieldname the $name is of:
|
|
* one of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME
|
|
* BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM
|
|
* @return mixed Value of field.
|
|
*/
|
|
public function getByName($name, $type = BasePeer::TYPE_PHPNAME)
|
|
{
|
|
$pos = CcMusicDirsPeer::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->getDirectory();
|
|
break;
|
|
case 2:
|
|
return $this->getType();
|
|
break;
|
|
case 3:
|
|
return $this->getRemoved();
|
|
break;
|
|
default:
|
|
return null;
|
|
break;
|
|
} // switch()
|
|
}
|
|
|
|
/**
|
|
* Exports the object as an array.
|
|
*
|
|
* You can specify the key type of the array by passing one of the class
|
|
* type constants.
|
|
*
|
|
* @param string $keyType (optional) One of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME,
|
|
* BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM.
|
|
* Defaults to BasePeer::TYPE_PHPNAME.
|
|
* @param boolean $includeLazyLoadColumns (optional) Whether to include lazy loaded columns. Defaults to TRUE.
|
|
*
|
|
* @return array an associative array containing the field names (as keys) and field values
|
|
*/
|
|
public function toArray($keyType = BasePeer::TYPE_PHPNAME, $includeLazyLoadColumns = true)
|
|
{
|
|
$keys = CcMusicDirsPeer::getFieldNames($keyType);
|
|
$result = array(
|
|
$keys[0] => $this->getId(),
|
|
$keys[1] => $this->getDirectory(),
|
|
$keys[2] => $this->getType(),
|
|
$keys[3] => $this->getRemoved(),
|
|
);
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Sets a field from the object by name passed in as a string.
|
|
*
|
|
* @param string $name peer name
|
|
* @param mixed $value field value
|
|
* @param string $type The type of fieldname the $name is of:
|
|
* one of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME
|
|
* BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM
|
|
* @return void
|
|
*/
|
|
public function setByName($name, $value, $type = BasePeer::TYPE_PHPNAME)
|
|
{
|
|
$pos = CcMusicDirsPeer::translateFieldName($name, $type, BasePeer::TYPE_NUM);
|
|
return $this->setByPosition($pos, $value);
|
|
}
|
|
|
|
/**
|
|
* Sets a field from the object by Position as specified in the xml schema.
|
|
* Zero-based.
|
|
*
|
|
* @param int $pos position in xml schema
|
|
* @param mixed $value field value
|
|
* @return void
|
|
*/
|
|
public function setByPosition($pos, $value)
|
|
{
|
|
switch($pos) {
|
|
case 0:
|
|
$this->setId($value);
|
|
break;
|
|
case 1:
|
|
$this->setDirectory($value);
|
|
break;
|
|
case 2:
|
|
$this->setType($value);
|
|
break;
|
|
case 3:
|
|
$this->setRemoved($value);
|
|
break;
|
|
} // switch()
|
|
}
|
|
|
|
/**
|
|
* Populates the object using an array.
|
|
*
|
|
* This is particularly useful when populating an object from one of the
|
|
* request arrays (e.g. $_POST). This method goes through the column
|
|
* names, checking to see whether a matching key exists in populated
|
|
* array. If so the setByName() method is called for that column.
|
|
*
|
|
* You can specify the key type of the array by additionally passing one
|
|
* of the class type constants BasePeer::TYPE_PHPNAME, BasePeer::TYPE_STUDLYPHPNAME,
|
|
* BasePeer::TYPE_COLNAME, BasePeer::TYPE_FIELDNAME, BasePeer::TYPE_NUM.
|
|
* The default key type is the column's phpname (e.g. 'AuthorId')
|
|
*
|
|
* @param array $arr An array to populate the object from.
|
|
* @param string $keyType The type of keys the array uses.
|
|
* @return void
|
|
*/
|
|
public function fromArray($arr, $keyType = BasePeer::TYPE_PHPNAME)
|
|
{
|
|
$keys = CcMusicDirsPeer::getFieldNames($keyType);
|
|
|
|
if (array_key_exists($keys[0], $arr)) $this->setId($arr[$keys[0]]);
|
|
if (array_key_exists($keys[1], $arr)) $this->setDirectory($arr[$keys[1]]);
|
|
if (array_key_exists($keys[2], $arr)) $this->setType($arr[$keys[2]]);
|
|
if (array_key_exists($keys[3], $arr)) $this->setRemoved($arr[$keys[3]]);
|
|
}
|
|
|
|
/**
|
|
* 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(CcMusicDirsPeer::DATABASE_NAME);
|
|
|
|
if ($this->isColumnModified(CcMusicDirsPeer::ID)) $criteria->add(CcMusicDirsPeer::ID, $this->id);
|
|
if ($this->isColumnModified(CcMusicDirsPeer::DIRECTORY)) $criteria->add(CcMusicDirsPeer::DIRECTORY, $this->directory);
|
|
if ($this->isColumnModified(CcMusicDirsPeer::TYPE)) $criteria->add(CcMusicDirsPeer::TYPE, $this->type);
|
|
if ($this->isColumnModified(CcMusicDirsPeer::REMOVED)) $criteria->add(CcMusicDirsPeer::REMOVED, $this->removed);
|
|
|
|
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(CcMusicDirsPeer::DATABASE_NAME);
|
|
$criteria->add(CcMusicDirsPeer::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 CcMusicDirs (or compatible) type.
|
|
* @param boolean $deepCopy Whether to also copy all rows that refer (by fkey) to the current row.
|
|
* @throws PropelException
|
|
*/
|
|
public function copyInto($copyObj, $deepCopy = false)
|
|
{
|
|
$copyObj->setDirectory($this->directory);
|
|
$copyObj->setType($this->type);
|
|
$copyObj->setRemoved($this->removed);
|
|
|
|
if ($deepCopy) {
|
|
// important: temporarily setNew(false) because this affects the behavior of
|
|
// the getter/setter methods for fkey referrer objects.
|
|
$copyObj->setNew(false);
|
|
|
|
foreach ($this->getCcFiless() as $relObj) {
|
|
if ($relObj !== $this) { // ensure that we don't try to copy a reference to ourselves
|
|
$copyObj->addCcFiles($relObj->copy($deepCopy));
|
|
}
|
|
}
|
|
|
|
} // if ($deepCopy)
|
|
|
|
|
|
$copyObj->setNew(true);
|
|
$copyObj->setId(NULL); // this is a auto-increment column, so set to default value
|
|
}
|
|
|
|
/**
|
|
* Makes a copy of this object that will be inserted as a new row in table when saved.
|
|
* It creates a new object filling in the simple attributes, but skipping any primary
|
|
* keys that are defined for the table.
|
|
*
|
|
* If desired, this method can also make copies of all associated (fkey referrers)
|
|
* objects.
|
|
*
|
|
* @param boolean $deepCopy Whether to also copy all rows that refer (by fkey) to the current row.
|
|
* @return CcMusicDirs 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 CcMusicDirsPeer
|
|
*/
|
|
public function getPeer()
|
|
{
|
|
if (self::$peer === null) {
|
|
self::$peer = new CcMusicDirsPeer();
|
|
}
|
|
return self::$peer;
|
|
}
|
|
|
|
/**
|
|
* Clears out the collCcFiless collection
|
|
*
|
|
* This does not modify the database; however, it will remove any associated objects, causing
|
|
* them to be refetched by subsequent calls to accessor method.
|
|
*
|
|
* @return void
|
|
* @see addCcFiless()
|
|
*/
|
|
public function clearCcFiless()
|
|
{
|
|
$this->collCcFiless = null; // important to set this to NULL since that means it is uninitialized
|
|
}
|
|
|
|
/**
|
|
* Initializes the collCcFiless collection.
|
|
*
|
|
* By default this just sets the collCcFiless collection to an empty array (like clearcollCcFiless());
|
|
* however, you may wish to override this method in your stub class to provide setting appropriate
|
|
* to your application -- for example, setting the initial array to the values stored in database.
|
|
*
|
|
* @return void
|
|
*/
|
|
public function initCcFiless()
|
|
{
|
|
$this->collCcFiless = new PropelObjectCollection();
|
|
$this->collCcFiless->setModel('CcFiles');
|
|
}
|
|
|
|
/**
|
|
* Gets an array of CcFiles 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 CcMusicDirs 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 PropelCollection|array CcFiles[] List of CcFiles objects
|
|
* @throws PropelException
|
|
*/
|
|
public function getCcFiless($criteria = null, PropelPDO $con = null)
|
|
{
|
|
if(null === $this->collCcFiless || null !== $criteria) {
|
|
if ($this->isNew() && null === $this->collCcFiless) {
|
|
// return empty collection
|
|
$this->initCcFiless();
|
|
} else {
|
|
$collCcFiless = CcFilesQuery::create(null, $criteria)
|
|
->filterByCcMusicDirs($this)
|
|
->find($con);
|
|
if (null !== $criteria) {
|
|
return $collCcFiless;
|
|
}
|
|
$this->collCcFiless = $collCcFiless;
|
|
}
|
|
}
|
|
return $this->collCcFiless;
|
|
}
|
|
|
|
/**
|
|
* Returns the number of related CcFiles objects.
|
|
*
|
|
* @param Criteria $criteria
|
|
* @param boolean $distinct
|
|
* @param PropelPDO $con
|
|
* @return int Count of related CcFiles objects.
|
|
* @throws PropelException
|
|
*/
|
|
public function countCcFiless(Criteria $criteria = null, $distinct = false, PropelPDO $con = null)
|
|
{
|
|
if(null === $this->collCcFiless || null !== $criteria) {
|
|
if ($this->isNew() && null === $this->collCcFiless) {
|
|
return 0;
|
|
} else {
|
|
$query = CcFilesQuery::create(null, $criteria);
|
|
if($distinct) {
|
|
$query->distinct();
|
|
}
|
|
return $query
|
|
->filterByCcMusicDirs($this)
|
|
->count($con);
|
|
}
|
|
} else {
|
|
return count($this->collCcFiless);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Method called to associate a CcFiles object to this object
|
|
* through the CcFiles foreign key attribute.
|
|
*
|
|
* @param CcFiles $l CcFiles
|
|
* @return void
|
|
* @throws PropelException
|
|
*/
|
|
public function addCcFiles(CcFiles $l)
|
|
{
|
|
if ($this->collCcFiless === null) {
|
|
$this->initCcFiless();
|
|
}
|
|
if (!$this->collCcFiless->contains($l)) { // only add it if the **same** object is not already associated
|
|
$this->collCcFiless[]= $l;
|
|
$l->setCcMusicDirs($this);
|
|
}
|
|
}
|
|
|
|
|
|
/**
|
|
* If this collection has already been initialized with
|
|
* an identical criteria, it returns the collection.
|
|
* Otherwise if this CcMusicDirs is new, it will return
|
|
* an empty collection; or if this CcMusicDirs has previously
|
|
* been saved, it will retrieve related CcFiless 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 CcMusicDirs.
|
|
*
|
|
* @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 PropelCollection|array CcFiles[] List of CcFiles objects
|
|
*/
|
|
public function getCcFilessJoinCcSubjs($criteria = null, $con = null, $join_behavior = Criteria::LEFT_JOIN)
|
|
{
|
|
$query = CcFilesQuery::create(null, $criteria);
|
|
$query->joinWith('CcSubjs', $join_behavior);
|
|
|
|
return $this->getCcFiless($query, $con);
|
|
}
|
|
|
|
/**
|
|
* Clears the current object and sets all attributes to their default values
|
|
*/
|
|
public function clear()
|
|
{
|
|
$this->id = null;
|
|
$this->directory = null;
|
|
$this->type = null;
|
|
$this->removed = null;
|
|
$this->alreadyInSave = false;
|
|
$this->alreadyInValidation = false;
|
|
$this->clearAllReferences();
|
|
$this->applyDefaultValues();
|
|
$this->resetModified();
|
|
$this->setNew(true);
|
|
$this->setDeleted(false);
|
|
}
|
|
|
|
/**
|
|
* Resets all collections of referencing foreign keys.
|
|
*
|
|
* This method is a user-space workaround for PHP's inability to garbage collect objects
|
|
* with circular references. This is currently necessary when using Propel in certain
|
|
* daemon or large-volumne/high-memory operations.
|
|
*
|
|
* @param boolean $deep Whether to also clear the references on all associated objects.
|
|
*/
|
|
public function clearAllReferences($deep = false)
|
|
{
|
|
if ($deep) {
|
|
if ($this->collCcFiless) {
|
|
foreach ((array) $this->collCcFiless as $o) {
|
|
$o->clearAllReferences($deep);
|
|
}
|
|
}
|
|
} // if ($deep)
|
|
|
|
$this->collCcFiless = null;
|
|
}
|
|
|
|
/**
|
|
* Catches calls to virtual methods
|
|
*/
|
|
public function __call($name, $params)
|
|
{
|
|
if (preg_match('/get(\w+)/', $name, $matches)) {
|
|
$virtualColumn = $matches[1];
|
|
if ($this->hasVirtualColumn($virtualColumn)) {
|
|
return $this->getVirtualColumn($virtualColumn);
|
|
}
|
|
// no lcfirst in php<5.3...
|
|
$virtualColumn[0] = strtolower($virtualColumn[0]);
|
|
if ($this->hasVirtualColumn($virtualColumn)) {
|
|
return $this->getVirtualColumn($virtualColumn);
|
|
}
|
|
}
|
|
throw new PropelException('Call to undefined method: ' . $name);
|
|
}
|
|
|
|
} // BaseCcMusicDirs
|