id; } /** * Get the [mod] column value. * * @return int */ public function getMod() { return $this->mod; } /** * Get the [intern] column value. * * @return string */ public function getIntern() { return $this->intern; } /** * Get the [extern] column value. * * @return string */ public function getExtern() { return $this->extern; } /** * Set the value of [id] column. * * @param int $v new value * @return ManagedObjectClassDescriptor 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[] = ManagedObjectClassDescriptorPeer::ID; } return $this; } // setId() /** * Set the value of [mod] column. * * @param int $v new value * @return ManagedObjectClassDescriptor The current object (for fluent API support) */ public function setMod($v) { if ($v !== null) { $v = (int) $v; } if ($this->mod !== $v) { $this->mod = $v; $this->modifiedColumns[] = ManagedObjectClassDescriptorPeer::MOD; } return $this; } // setMod() /** * Set the value of [intern] column. * * @param string $v new value * @return ManagedObjectClassDescriptor The current object (for fluent API support) */ public function setIntern($v) { if ($v !== null) { $v = (string) $v; } if ($this->intern !== $v) { $this->intern = $v; $this->modifiedColumns[] = ManagedObjectClassDescriptorPeer::INTERN; } return $this; } // setIntern() /** * Set the value of [extern] column. * * @param string $v new value * @return ManagedObjectClassDescriptor The current object (for fluent API support) */ public function setExtern($v) { if ($v !== null) { $v = (string) $v; } if ($this->extern !== $v) { $this->extern = $v; $this->modifiedColumns[] = ManagedObjectClassDescriptorPeer::EXTERN; } return $this; } // setExtern() /** * 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->mod = ($row[$startcol + 1] !== null) ? (int) $row[$startcol + 1] : null; $this->intern = ($row[$startcol + 2] !== null) ? (string) $row[$startcol + 2] : null; $this->extern = ($row[$startcol + 3] !== null) ? (string) $row[$startcol + 3] : null; $this->resetModified(); $this->setNew(false); if ($rehydrate) { $this->ensureConsistency(); } return $startcol + 4; // 4 = ManagedObjectClassDescriptorPeer::NUM_COLUMNS - ManagedObjectClassDescriptorPeer::NUM_LAZY_LOAD_COLUMNS). } catch (Exception $e) { throw new PropelException("Error populating ManagedObjectClassDescriptor 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(ManagedObjectClassDescriptorPeer::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 = ManagedObjectClassDescriptorPeer::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->collAtdcs = 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(ManagedObjectClassDescriptorPeer::DATABASE_NAME, Propel::CONNECTION_WRITE); } $con->beginTransaction(); try { $ret = $this->preDelete($con); if ($ret) { ManagedObjectClassDescriptorQuery::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(ManagedObjectClassDescriptorPeer::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); ManagedObjectClassDescriptorPeer::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[] = ManagedObjectClassDescriptorPeer::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(ManagedObjectClassDescriptorPeer::ID) ) { throw new PropelException('Cannot insert a value for auto-increment primary key ('.ManagedObjectClassDescriptorPeer::ID.')'); } $pk = BasePeer::doInsert($criteria, $con); $affectedRows = 1; $this->setId($pk); //[IMV] update autoincrement primary key $this->setNew(false); } else { $affectedRows = ManagedObjectClassDescriptorPeer::doUpdate($this, $con); } $this->resetModified(); // [HL] After being saved an object is no longer 'modified' } if ($this->collAtdcs !== null) { foreach ($this->collAtdcs 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 true is returned; otherwise * an aggreagated array of ValidationFailed objects will be returned. * * @param array $columns Array of column names to validate. * @return mixed true if all validations pass; array of ValidationFailed objets otherwise. */ protected function doValidate($columns = null) { if (!$this->alreadyInValidation) { $this->alreadyInValidation = true; $retval = null; $failureMap = array(); if (($retval = ManagedObjectClassDescriptorPeer::doValidate($this, $columns)) !== true) { $failureMap = array_merge($failureMap, $retval); } if ($this->collAtdcs !== null) { foreach ($this->collAtdcs 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 = ManagedObjectClassDescriptorPeer::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->getMod(); break; case 2: return $this->getIntern(); break; case 3: return $this->getExtern(); 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 = ManagedObjectClassDescriptorPeer::getFieldNames($keyType); $result = array( $keys[0] => $this->getId(), $keys[1] => $this->getMod(), $keys[2] => $this->getIntern(), $keys[3] => $this->getExtern(), ); 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 = ManagedObjectClassDescriptorPeer::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->setMod($value); break; case 2: $this->setIntern($value); break; case 3: $this->setExtern($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 = ManagedObjectClassDescriptorPeer::getFieldNames($keyType); if (array_key_exists($keys[0], $arr)) $this->setId($arr[$keys[0]]); if (array_key_exists($keys[1], $arr)) $this->setMod($arr[$keys[1]]); if (array_key_exists($keys[2], $arr)) $this->setIntern($arr[$keys[2]]); if (array_key_exists($keys[3], $arr)) $this->setExtern($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(ManagedObjectClassDescriptorPeer::DATABASE_NAME); if ($this->isColumnModified(ManagedObjectClassDescriptorPeer::ID)) $criteria->add(ManagedObjectClassDescriptorPeer::ID, $this->id); if ($this->isColumnModified(ManagedObjectClassDescriptorPeer::MOD)) $criteria->add(ManagedObjectClassDescriptorPeer::MOD, $this->mod); if ($this->isColumnModified(ManagedObjectClassDescriptorPeer::INTERN)) $criteria->add(ManagedObjectClassDescriptorPeer::INTERN, $this->intern); if ($this->isColumnModified(ManagedObjectClassDescriptorPeer::EXTERN)) $criteria->add(ManagedObjectClassDescriptorPeer::EXTERN, $this->extern); 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(ManagedObjectClassDescriptorPeer::DATABASE_NAME); $criteria->add(ManagedObjectClassDescriptorPeer::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 ManagedObjectClassDescriptor (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->setMod($this->mod); $copyObj->setIntern($this->intern); $copyObj->setExtern($this->extern); 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->getAtdcs() as $relObj) { if ($relObj !== $this) { // ensure that we don't try to copy a reference to ourselves $copyObj->addAtdc($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 ManagedObjectClassDescriptor 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 ManagedObjectClassDescriptorPeer */ public function getPeer() { if (self::$peer === null) { self::$peer = new ManagedObjectClassDescriptorPeer(); } return self::$peer; } /** * Clears out the collAtdcs 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 addAtdcs() */ public function clearAtdcs() { $this->collAtdcs = null; // important to set this to NULL since that means it is uninitialized } /** * Initializes the collAtdcs collection. * * By default this just sets the collAtdcs collection to an empty array (like clearcollAtdcs()); * 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 initAtdcs() { $this->collAtdcs = new PropelObjectCollection(); $this->collAtdcs->setModel('AttributeDescriptor'); } /** * Gets an array of AttributeDescriptor 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 ManagedObjectClassDescriptor 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 AttributeDescriptor[] List of AttributeDescriptor objects * @throws PropelException */ public function getAtdcs($criteria = null, PropelPDO $con = null) { if(null === $this->collAtdcs || null !== $criteria) { if ($this->isNew() && null === $this->collAtdcs) { // return empty collection $this->initAtdcs(); } else { $collAtdcs = AttributeDescriptorQuery::create(null, $criteria) ->filterByManagedObjectClassDescriptor($this) ->find($con); if (null !== $criteria) { return $collAtdcs; } $this->collAtdcs = $collAtdcs; } } return $this->collAtdcs; } /** * Returns the number of related AttributeDescriptor objects. * * @param Criteria $criteria * @param boolean $distinct * @param PropelPDO $con * @return int Count of related AttributeDescriptor objects. * @throws PropelException */ public function countAtdcs(Criteria $criteria = null, $distinct = false, PropelPDO $con = null) { if(null === $this->collAtdcs || null !== $criteria) { if ($this->isNew() && null === $this->collAtdcs) { return 0; } else { $query = AttributeDescriptorQuery::create(null, $criteria); if($distinct) { $query->distinct(); } return $query ->filterByManagedObjectClassDescriptor($this) ->count($con); } } else { return count($this->collAtdcs); } } /** * Method called to associate a AttributeDescriptor object to this object * through the AttributeDescriptor foreign key attribute. * * @param AttributeDescriptor $l AttributeDescriptor * @return void * @throws PropelException */ public function addAtdc(AttributeDescriptor $l) { if ($this->collAtdcs === null) { $this->initAtdcs(); } if (!$this->collAtdcs->contains($l)) { // only add it if the **same** object is not already associated $this->collAtdcs[]= $l; $l->setManagedObjectClassDescriptor($this); } } /** * Clears the current object and sets all attributes to their default values */ public function clear() { $this->id = null; $this->mod = null; $this->intern = null; $this->extern = null; $this->alreadyInSave = false; $this->alreadyInValidation = false; $this->clearAllReferences(); $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->collAtdcs) { foreach ((array) $this->collAtdcs as $o) { $o->clearAllReferences($deep); } } } // if ($deep) $this->collAtdcs = 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); } } return parent::__call($name, $params); } } // BaseManagedObjectClassDescriptor