Source for file BaseEtvaVolumegroup.php
Documentation is available at BaseEtvaVolumegroup.php
* Base class that represents a row from the 'volumegroup' table.
* This class was autogenerated by Propel 1.3.0-dev on:
* Thu Jun 18 14:28:38 2009
const PEER = 'EtvaVolumegroupPeer';
* Instance provides a convenient way of calling static methods on a class
* that calling code may not be able to identify.
* @var EtvaVolumegroupPeer
* The value for the id field.
* The value for the node_id field.
* The value for the vg field.
* The value for the size field.
* The value for the freesize field.
* @var array EtvaLogicalvolume[] Collection to store aggregation of EtvaLogicalvolume objects.
* @var Criteria The criteria used to select the current contents of collEtvaLogicalvolumes.
private $lastEtvaLogicalvolumeCriteria = null;
* @var array EtvaVolumePhysical[] Collection to store aggregation of EtvaVolumePhysical objects.
* @var Criteria The criteria used to select the current contents of collEtvaVolumePhysicals.
private $lastEtvaVolumePhysicalCriteria = null;
* Flag to prevent endless save loop, if this object is referenced
* by another object which falls in this transaction.
* Flag to prevent endless validation loop, if this object is referenced
* by another object which falls in this transaction.
* Initializes internal state of BaseEtvaVolumegroup object.
* Applies default values to this object.
* This method should be called from the object's constructor (or
* equivalent initialization method).
* Get the [id] column value.
* Get the [node_id] column value.
* Get the [vg] column value.
* Get the [size] column value.
* Get the [freesize] column value.
* Set the value of [id] column.
* @param int $v new value
* @return EtvaVolumegroup The current object (for fluent API support)
public function setId($v)
* Set the value of [node_id] column.
* @param int $v new value
* @return EtvaVolumegroup The current object (for fluent API support)
* Set the value of [vg] column.
* @param string $v new value
* @return EtvaVolumegroup The current object (for fluent API support)
public function setVg($v)
* Set the value of [size] column.
* @param string $v new value
* @return EtvaVolumegroup The current object (for fluent API support)
if ($this->size !== $v) {
* Set the value of [freesize] column.
* @param string $v new value
* @return EtvaVolumegroup The current object (for fluent API support)
* 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.
// First, ensure that we don't have any columns that have been modified which aren't default columns.
if (array_diff($this->modifiedColumns, array())) {
// otherwise, everything was equal, so 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
* @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)
$this->id = ($row[$startcol + 0] !== null) ? (int) $row[$startcol + 0] : null;
$this->node_id = ($row[$startcol + 1] !== null) ? (int) $row[$startcol + 1] : null;
$this->vg = ($row[$startcol + 2] !== null) ? (string) $row[$startcol + 2] : null;
$this->size = ($row[$startcol + 3] !== null) ? (string) $row[$startcol + 3] : null;
$this->freesize = ($row[$startcol + 4] !== null) ? (string) $row[$startcol + 4] : null;
// FIXME - using NUM_COLUMNS may be clearer.
return $startcol + 5; // 5 = EtvaVolumegroupPeer::NUM_COLUMNS - EtvaVolumegroupPeer::NUM_LAZY_LOAD_COLUMNS).
throw new PropelException("Error populating EtvaVolumegroup 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
* 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.
* @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.");
throw new PropelException("Cannot reload an unsaved object.");
// We don't need to alter the object instance pool; we're just modifying this instance
$row = $stmt->fetch(PDO::FETCH_NUM);
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->lastEtvaLogicalvolumeCriteria = null;
$this->lastEtvaVolumePhysicalCriteria = null;
* Removes this object from datastore and sets delete attribute.
* @throws PropelException
* @see BaseObject::setDeleted()
* @see BaseObject::isDeleted()
public function delete(PropelPDO $con = null)
foreach (sfMixer::getCallables('BaseEtvaVolumegroup:delete:pre') as $callable)
if ($this->isDeleted()) {
throw new PropelException("This object has already been deleted.");
$con->beginTransaction();
} catch (PropelException $e) {
foreach (sfMixer::getCallables('BaseEtvaVolumegroup:delete:post') as $callable)
* 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
* @return int The number of rows affected by this insert/update and any referring fk objects' save() operations.
* @throws PropelException
public function save(PropelPDO $con = null)
foreach (sfMixer::getCallables('BaseEtvaVolumegroup:save:pre') as $callable)
if ($this->isDeleted()) {
throw new PropelException("You cannot save an object that has been deleted.");
$con->beginTransaction();
$affectedRows = $this->doSave($con);
foreach (sfMixer::getCallables('BaseEtvaVolumegroup:save:post') as $callable)
} catch (PropelException $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.
* @return int The number of rows affected by this insert/update and any referring fk objects' save() operations.
* @throws PropelException
protected function doSave(PropelPDO $con)
$affectedRows = 0; // initialize var to track total num of affected rows
// 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.
$affectedRows += $this->aEtvaNode->save($con);
// If this object has been modified, then save it to the database.
if ($this->isModified()) {
$affectedRows += 1; // we are assuming that there is only 1 row per doInsert() which
// should always be true here (even though technically
// BasePeer::doInsert() can insert multiple rows).
$this->setId($pk); //[IMV] update autoincrement primary key
$this->resetModified(); // [HL] After being saved an object is no longer 'modified'
if (!$referrerFK->isDeleted()) {
$affectedRows += $referrerFK->save($con);
if (!$referrerFK->isDeleted()) {
$affectedRows += $referrerFK->save($con);
* Array of ValidationFailed objects.
* @var array ValidationFailed[]
* Gets any ValidationFailed objects that resulted from last call to validate().
* @return array ValidationFailed[]
* 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 getValidationFailures()
public function validate($columns = null)
* 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.
// 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 (!$referrerFK->validate($columns)) {
$failureMap = array_merge($failureMap, $referrerFK->getValidationFailures());
if (!$referrerFK->validate($columns)) {
$failureMap = array_merge($failureMap, $referrerFK->getValidationFailures());
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)
* Retrieves a field from the object by Position as specified in the xml schema.
* @param int $pos position in xml schema
* @return mixed Value of field at $pos
* Exports the object as an array.
* You can specify the key type of the array by passing one of the class
* @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 an associative array containing the field names (as keys) and field values
public function toArray($keyType = BasePeer::TYPE_PHPNAME, $includeLazyLoadColumns = true)
$keys[0] => $this->getId(),
$keys[2] => $this->getVg(),
* 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
public function setByName($name, $value, $type = BasePeer::TYPE_PHPNAME)
* Sets a field from the object by Position as specified in the xml schema.
* @param int $pos position in xml schema
* @param mixed $value field value
* 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.
public function fromArray($arr, $keyType = BasePeer::TYPE_PHPNAME)
* Build a Criteria object containing the values of all modified columns in this object.
* @return Criteria The Criteria object containing all modified values.
* 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).
* Returns the primary key for this object (row).
* Generic method to set the primary key (id column).
* @param int $key Primary key.
* Sets contents of passed object to values from current object.
* If desired, this method can also make copies of all associated (fkey referrers)
* @param object $copyObj An object of EtvaVolumegroup (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->setNodeId($this->node_id);
$copyObj->setVg($this->vg);
$copyObj->setSize($this->size);
// important: temporarily setNew(false) because this affects the behavior of
// the getter/setter methods for fkey referrer objects.
if ($relObj !== $this) { // ensure that we don't try to copy a reference to ourselves
$copyObj->addEtvaLogicalvolume($relObj->copy($deepCopy));
if ($relObj !== $this) { // ensure that we don't try to copy a reference to ourselves
$copyObj->addEtvaVolumePhysical($relObj->copy($deepCopy));
$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)
* @param boolean $deepCopy Whether to also copy all rows that refer (by fkey) to the current row.
* @return EtvaVolumegroup Clone of current object.
* @throws PropelException
public function copy($deepCopy = false)
// we use get_class(), because this might be a subclass
* 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 EtvaVolumegroupPeer
if (self::$peer === null) {
self::$peer = new EtvaVolumegroupPeer();
* Declares an association between this object and a EtvaNode object.
* @return EtvaVolumegroup The current object (for fluent API support)
* @throws PropelException
// Add binding for other direction of this n:n relationship.
// If this object has already been added to the EtvaNode object, it will not be re-added.
$v->addEtvaVolumegroup($this);
* Get the associated EtvaNode object
* @param PropelPDO Optional Connection object.
* @return EtvaNode The associated EtvaNode object.
* @throws PropelException
/* 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->aEtvaNode->addEtvaVolumegroups($this);
* Clears out the collEtvaLogicalvolumes collection (array).
* This does not modify the database; however, it will remove any associated objects, causing
* them to be refetched by subsequent calls to accessor method.
* @see addEtvaLogicalvolumes()
* Initializes the collEtvaLogicalvolumes collection (array).
* By default this just sets the collEtvaLogicalvolumes collection to an empty array (like clearcollEtvaLogicalvolumes());
* 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.
* Gets an array of EtvaLogicalvolume objects which contain a foreign key that references this object.
* If this collection has already been initialized with an identical Criteria, it returns the collection.
* Otherwise if this EtvaVolumegroup has previously been saved, it will retrieve
* related EtvaLogicalvolumes from storage. If this EtvaVolumegroup is new, it will return
* an empty collection or the current collection, the criteria is ignored on a new object.
* @param Criteria $criteria
* @return array EtvaLogicalvolume[]
* @throws PropelException
if ($criteria === null) {
elseif ($criteria instanceof Criteria)
$criteria = clone $criteria;
// criteria has no effect for a new object
// the following code is to determine if a new query is
// called for. If the criteria is the same as the last
// one, just return the collection.
if (!isset ($this->lastEtvaLogicalvolumeCriteria) || !$this->lastEtvaLogicalvolumeCriteria->equals($criteria)) {
$this->lastEtvaLogicalvolumeCriteria = $criteria;
* Returns the number of related EtvaLogicalvolume objects.
* @param Criteria $criteria
* @param boolean $distinct
* @return int Count of related EtvaLogicalvolume objects.
* @throws PropelException
if ($criteria === null) {
$criteria = clone $criteria;
$criteria->setDistinct();
// criteria has no effect for a new object
// the following code is to determine if a new query is
// called for. If the criteria is the same as the last
// one, just return count of the collection.
if (!isset ($this->lastEtvaLogicalvolumeCriteria) || !$this->lastEtvaLogicalvolumeCriteria->equals($criteria)) {
$this->lastEtvaLogicalvolumeCriteria = $criteria;
* Method called to associate a EtvaLogicalvolume object to this object
* through the EtvaLogicalvolume foreign key attribute.
* @param EtvaLogicalvolume $l EtvaLogicalvolume
* @throws PropelException
$l->setEtvaVolumegroup($this);
* If this collection has already been initialized with
* an identical criteria, it returns the collection.
* Otherwise if this EtvaVolumegroup is new, it will return
* an empty collection; or if this EtvaVolumegroup has previously
* been saved, it will retrieve related EtvaLogicalvolumes 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 EtvaVolumegroup.
if ($criteria === null) {
elseif ($criteria instanceof Criteria)
$criteria = clone $criteria;
// the following code is to determine if a new query is
// called for. If the criteria is the same as the last
// one, just return the collection.
if (!isset ($this->lastEtvaLogicalvolumeCriteria) || !$this->lastEtvaLogicalvolumeCriteria->equals($criteria)) {
$this->lastEtvaLogicalvolumeCriteria = $criteria;
* Clears out the collEtvaVolumePhysicals collection (array).
* This does not modify the database; however, it will remove any associated objects, causing
* them to be refetched by subsequent calls to accessor method.
* @see addEtvaVolumePhysicals()
* Initializes the collEtvaVolumePhysicals collection (array).
* By default this just sets the collEtvaVolumePhysicals collection to an empty array (like clearcollEtvaVolumePhysicals());
* 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.
* Gets an array of EtvaVolumePhysical objects which contain a foreign key that references this object.
* If this collection has already been initialized with an identical Criteria, it returns the collection.
* Otherwise if this EtvaVolumegroup has previously been saved, it will retrieve
* related EtvaVolumePhysicals from storage. If this EtvaVolumegroup is new, it will return
* an empty collection or the current collection, the criteria is ignored on a new object.
* @param Criteria $criteria
* @return array EtvaVolumePhysical[]
* @throws PropelException
if ($criteria === null) {
elseif ($criteria instanceof Criteria)
$criteria = clone $criteria;
// criteria has no effect for a new object
// the following code is to determine if a new query is
// called for. If the criteria is the same as the last
// one, just return the collection.
if (!isset ($this->lastEtvaVolumePhysicalCriteria) || !$this->lastEtvaVolumePhysicalCriteria->equals($criteria)) {
$this->lastEtvaVolumePhysicalCriteria = $criteria;
* Returns the number of related EtvaVolumePhysical objects.
* @param Criteria $criteria
* @param boolean $distinct
* @return int Count of related EtvaVolumePhysical objects.
* @throws PropelException
if ($criteria === null) {
$criteria = clone $criteria;
$criteria->setDistinct();
// criteria has no effect for a new object
// the following code is to determine if a new query is
// called for. If the criteria is the same as the last
// one, just return count of the collection.
if (!isset ($this->lastEtvaVolumePhysicalCriteria) || !$this->lastEtvaVolumePhysicalCriteria->equals($criteria)) {
$this->lastEtvaVolumePhysicalCriteria = $criteria;
* Method called to associate a EtvaVolumePhysical object to this object
* through the EtvaVolumePhysical foreign key attribute.
* @param EtvaVolumePhysical $l EtvaVolumePhysical
* @throws PropelException
$l->setEtvaVolumegroup($this);
* If this collection has already been initialized with
* an identical criteria, it returns the collection.
* Otherwise if this EtvaVolumegroup is new, it will return
* an empty collection; or if this EtvaVolumegroup has previously
* been saved, it will retrieve related EtvaVolumePhysicals 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 EtvaVolumegroup.
if ($criteria === null) {
elseif ($criteria instanceof Criteria)
$criteria = clone $criteria;
// the following code is to determine if a new query is
// called for. If the criteria is the same as the last
// one, just return the collection.
if (!isset ($this->lastEtvaVolumePhysicalCriteria) || !$this->lastEtvaVolumePhysicalCriteria->equals($criteria)) {
$this->lastEtvaVolumePhysicalCriteria = $criteria;
* 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.
$o->clearAllReferences($deep);
$o->clearAllReferences($deep);
public function __call($method, $arguments)
if (!$callable = sfMixer::getCallable('BaseEtvaVolumegroup:'. $method))
throw new sfException(sprintf('Call to undefined method BaseEtvaVolumegroup::%s', $method));
|