<?php
require_once 'lib/diy-framework/classes/diy-framework/controller/Resource.php';
require_once 'propel/om/Persistent.php';
include_once 'propel/util/Criteria.php';
include_once 'diy-blog/model/BackEndResourcePeer.php';
/**
* Base class that represents a row from the 'BackEndResource' table.
*
*
*
* This class was autogenerated by Propel on:
*
* 09/26/07 22:26:19
*
* @package diy-blog.model.om
*/
abstract class BaseBackEndResource extends Resource implements Persistent {
/**
* 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 BackEndResourcePeer
*/
protected static $peer;
/**
* The value for the uri field.
* @var string
*/
protected $uri;
/**
* The value for the type field.
* @var string
*/
protected $type;
/**
* Collection to store aggregation of collPages.
* @var array
*/
protected $collPages;
/**
* The criteria used to select the current contents of collPages.
* @var Criteria
*/
protected $lastPageCriteria = null;
/**
* Collection to store aggregation of collUsers.
* @var array
*/
protected $collUsers;
/**
* The criteria used to select the current contents of collUsers.
* @var Criteria
*/
protected $lastUserCriteria = null;
/**
* 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;
/**
* Get the [uri] column value.
*
* @return string
*/
public function getURI()
{
return $this->uri;
}
/**
* Get the [type] column value.
*
* @return string
*/
public function getType()
{
return $this->type;
}
/**
* Set the value of [uri] column.
*
* @param string $v new value
* @return void
*/
public function setURI($v)
{
// Since the native PHP type for this column is string,
// we will cast the input to a string (if it is not).
if ($v !== null && !is_string($v)) {
$v = (string) $v;
}
if ($this->uri !== $v) {
$this->uri = $v;
$this->modifiedColumns[] = BackEndResourcePeer::URI;
}
} // setURI()
/**
* Set the value of [type] column.
*
* @param string $v new value
* @return void
*/
public function setType($v)
{
// Since the native PHP type for this column is string,
// we will cast the input to a string (if it is not).
if ($v !== null && !is_string($v)) {
$v = (string) $v;
}
if ($this->type !== $v) {
$this->type = $v;
$this->modifiedColumns[] = BackEndResourcePeer::TYPE;
}
} // setType()
/**
* Hydrates (populates) the object variables with values from the database resultset.
*
* An offset (1-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 ResultSet $rs The ResultSet class with cursor advanced to desired record pos.
* @param int $startcol 1-based offset column which indicates which restultset column to start with.
* @return int next starting column
* @throws PropelException - Any caught Exception will be rewrapped as a PropelException.
*/
public function hydrate(ResultSet $rs, $startcol = 1)
{
try {
$this->uri = $rs->getString($startcol + 0);
$this->type = $rs->getString($startcol + 1);
$this->resetModified();
$this->setNew(false);
// FIXME - using NUM_COLUMNS may be clearer.
return $startcol + 2; // 2 = BackEndResourcePeer::NUM_COLUMNS - BackEndResourcePeer::NUM_LAZY_LOAD_COLUMNS).
} catch (Exception $e) {
throw new PropelException("Error populating BackEndResource object", $e);
}
}
/**
* Removes this object from datastore and sets delete attribute.
*
* @param Connection $con
* @return void
* @throws PropelException
* @see BaseObject::setDeleted()
* @see BaseObject::isDeleted()
*/
public function delete($con = null)
{
if ($this->isDeleted()) {
throw new PropelException("This object has already been deleted.");
}
if ($con === null) {
$con = Propel::getConnection(BackEndResourcePeer::DATABASE_NAME);
}
try {
$con->begin();
BackEndResourcePeer::doDelete($this, $con);
$this->setDeleted(true);
$con->commit();
} catch (PropelException $e) {
$con->rollback();
throw $e;
}
}
/**
* Stores the object in the database. If the object is new,
* it inserts it; otherwise an update is performed. This method
* wraps the doSave() worker method in a transaction.
*
* @param Connection $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($con = null)
{
if ($this->isDeleted()) {
throw new PropelException("You cannot save an object that has been deleted.");
}
if ($con === null) {
$con = Propel::getConnection(BackEndResourcePeer::DATABASE_NAME);
}
try {
$con->begin();
$affectedRows = $this->doSave($con);
$con->commit();
return $affectedRows;
} catch (PropelException $e) {
$con->rollback();
throw $e;
}
}
/**
* Stores the object 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 Connection $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($con)
{
$affectedRows = 0; // initialize var to track total num of affected rows
if (!$this->alreadyInSave) {
$this->alreadyInSave = true;
// If this object has been modified, then save it to the database.
if ($this->isModified()) {
if ($this->isNew()) {
$pk = BackEndResourcePeer::doInsert($this, $con);
$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->setNew(false);
} else {
$affectedRows += BackEndResourcePeer::doUpdate($this, $con);
}
$this->resetModified(); // [HL] After being saved an object is no longer 'modified'
}
if ($this->collPages !== null) {
foreach($this->collPages as $referrerFK) {
if (!$referrerFK->isDeleted()) {
$affectedRows += $referrerFK->save($con);
}
}
}
if ($this->collUsers !== null) {
foreach($this->collUsers 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 = BackEndResourcePeer::doValidate($this, $columns)) !== true) {
$failureMap = array_merge($failureMap, $retval);
}
if ($this->collPages !== null) {
foreach($this->collPages as $referrerFK) {
if (!$referrerFK->validate($columns)) {
$failureMap = array_merge($failureMap, $referrerFK->getValidationFailures());
}
}
}
if ($this->collUsers !== null) {
foreach($this->collUsers as $referrerFK) {
if (!$referrerFK->validate($columns)) {
$failureMap = array_merge($failureMap, $referrerFK->getValidationFailures());
}
}
}
$this->alreadyInValidation = false;
}
return (!empty($failureMap) ? $failureMap : true);
}
/**
* 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(BackEndResourcePeer::DATABASE_NAME);
if ($this->isColumnModified(BackEndResourcePeer::URI)) $criteria->add(BackEndResourcePeer::URI, $this->uri);
if ($this->isColumnModified(BackEndResourcePeer::TYPE)) $criteria->add(BackEndResourcePeer::TYPE, $this->type);
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(BackEndResourcePeer::DATABASE_NAME);
$criteria->add(BackEndResourcePeer::URI, $this->uri);
return $criteria;
}
/**
* Returns the primary key for this object (row).
* @return string
*/
public function getPrimaryKey()
{
return $this->getURI();
}
/**
* Generic method to set the primary key (uri column).
*
* @param string $key Primary key.
* @return void
*/
public function setPrimaryKey($key)
{
$this->setURI($key);
}
/**
* 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 BackEndResource (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->setType($this->type);
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->getPages() as $relObj) {
$copyObj->addPage($relObj->copy($deepCopy));
}
foreach($this->getUsers() as $relObj) {
$copyObj->addUser($relObj->copy($deepCopy));
}
} // if ($deepCopy)
$copyObj->setNew(true);
$copyObj->setURI(NULL); // this is a pkey 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 BackEndResource 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 BackEndResourcePeer
*/
public function getPeer()
{
if (self::$peer === null) {
self::$peer = new BackEndResourcePeer();
}
return self::$peer;
}
/**
* Temporary storage of collPages to save a possible db hit in
* the event objects are add to the collection, but the
* complete collection is never requested.
* @return void
*/
public function initPages()
{
if ($this->collPages === null) {
$this->collPages = array();
}
}
/**
* If this collection has already been initialized with
* an identical criteria, it returns the collection.
* Otherwise if this BackEndResource has previously
* been saved, it will retrieve related Pages from storage.
* If this BackEndResource is new, it will return
* an empty collection or the current collection, the criteria
* is ignored on a new object.
*
* @param Connection $con
* @param Criteria $criteria
* @throws PropelException
*/
public function getPages($criteria = null, $con = null)
{
// include the Peer class
include_once 'diy-blog/model/om/BasePagePeer.php';
if ($criteria === null) {
$criteria = new Criteria();
}
elseif ($criteria instanceof Criteria)
{
$criteria = clone $criteria;
}
if ($this->collPages === null) {
if ($this->isNew()) {
$this->collPages = array();
} else {
$criteria->add(PagePeer::BACKENDURI, $this->getURI());
PagePeer::addSelectColumns($criteria);
$this->collPages = PagePeer::doSelect($criteria, $con);
}
} else {
// criteria has no effect for a new object
if (!$this->isNew()) {
// 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.
$criteria->add(PagePeer::BACKENDURI, $this->getURI());
PagePeer::addSelectColumns($criteria);
if (!isset($this->lastPageCriteria) || !$this->lastPageCriteria->equals($criteria)) {
$this->collPages = PagePeer::doSelect($criteria, $con);
}
}
}
$this->lastPageCriteria = $criteria;
return $this->collPages;
}
/**
* Returns the number of related Pages.
*
* @param Criteria $criteria
* @param boolean $distinct
* @param Connection $con
* @throws PropelException
*/
public function countPages($criteria = null, $distinct = false, $con = null)
{
// include the Peer class
include_once 'diy-blog/model/om/BasePagePeer.php';
if ($criteria === null) {
$criteria = new Criteria();
}
elseif ($criteria instanceof Criteria)
{
$criteria = clone $criteria;
}
$criteria->add(PagePeer::BACKENDURI, $this->getURI());
return PagePeer::doCount($criteria, $distinct, $con);
}
/**
* Method called to associate a Page object to this object
* through the Page foreign key attribute
*
* @param Page $l Page
* @return void
* @throws PropelException
*/
public function addPage(Page $l)
{
$this->collPages[] = $l;
$l->setBackEndResource($this);
}
/**
* If this collection has already been initialized with
* an identical criteria, it returns the collection.
* Otherwise if this BackEndResource is new, it will return
* an empty collection; or if this BackEndResource has previously
* been saved, it will retrieve related Pages 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 BackEndResource.
*/
public function getPagesJoinFrontEndResource($criteria = null, $con = null)
{
// include the Peer class
include_once 'diy-blog/model/om/BasePagePeer.php';
if ($criteria === null) {
$criteria = new Criteria();
}
elseif ($criteria instanceof Criteria)
{
$criteria = clone $criteria;
}
if ($this->collPages === null) {
if ($this->isNew()) {
$this->collPages = array();
} else {
$criteria->add(PagePeer::BACKENDURI, $this->getURI());
$this->collPages = PagePeer::doSelectJoinFrontEndResource($criteria, $con);
}
} else {
// 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.
$criteria->add(PagePeer::BACKENDURI, $this->getURI());
if (!isset($this->lastPageCriteria) || !$this->lastPageCriteria->equals($criteria)) {
$this->collPages = PagePeer::doSelectJoinFrontEndResource($criteria, $con);
}
}
$this->lastPageCriteria = $criteria;
return $this->collPages;
}
/**
* If this collection has already been initialized with
* an identical criteria, it returns the collection.
* Otherwise if this BackEndResource is new, it will return
* an empty collection; or if this BackEndResource has previously
* been saved, it will retrieve related Pages 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 BackEndResource.
*/
public function getPagesJoinUser($criteria = null, $con = null)
{
// include the Peer class
include_once 'diy-blog/model/om/BasePagePeer.php';
if ($criteria === null) {
$criteria = new Criteria();
}
elseif ($criteria instanceof Criteria)
{
$criteria = clone $criteria;
}
if ($this->collPages === null) {
if ($this->isNew()) {
$this->collPages = array();
} else {
$criteria->add(PagePeer::BACKENDURI, $this->getURI());
$this->collPages = PagePeer::doSelectJoinUser($criteria, $con);
}
} else {
// 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.
$criteria->add(PagePeer::BACKENDURI, $this->getURI());
if (!isset($this->lastPageCriteria) || !$this->lastPageCriteria->equals($criteria)) {
$this->collPages = PagePeer::doSelectJoinUser($criteria, $con);
}
}
$this->lastPageCriteria = $criteria;
return $this->collPages;
}
/**
* Temporary storage of collUsers to save a possible db hit in
* the event objects are add to the collection, but the
* complete collection is never requested.
* @return void
*/
public function initUsers()
{
if ($this->collUsers === null) {
$this->collUsers = array();
}
}
/**
* If this collection has already been initialized with
* an identical criteria, it returns the collection.
* Otherwise if this BackEndResource has previously
* been saved, it will retrieve related Users from storage.
* If this BackEndResource is new, it will return
* an empty collection or the current collection, the criteria
* is ignored on a new object.
*
* @param Connection $con
* @param Criteria $criteria
* @throws PropelException
*/
public function getUsers($criteria = null, $con = null)
{
// include the Peer class
include_once 'diy-blog/model/om/BaseUserPeer.php';
if ($criteria === null) {
$criteria = new Criteria();
}
elseif ($criteria instanceof Criteria)
{
$criteria = clone $criteria;
}
if ($this->collUsers === null) {
if ($this->isNew()) {
$this->collUsers = array();
} else {
$criteria->add(UserPeer::BACKENDURI, $this->getURI());
UserPeer::addSelectColumns($criteria);
$this->collUsers = UserPeer::doSelect($criteria, $con);
}
} else {
// criteria has no effect for a new object
if (!$this->isNew()) {
// 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.
$criteria->add(UserPeer::BACKENDURI, $this->getURI());
UserPeer::addSelectColumns($criteria);
if (!isset($this->lastUserCriteria) || !$this->lastUserCriteria->equals($criteria)) {
$this->collUsers = UserPeer::doSelect($criteria, $con);
}
}
}
$this->lastUserCriteria = $criteria;
return $this->collUsers;
}
/**
* Returns the number of related Users.
*
* @param Criteria $criteria
* @param boolean $distinct
* @param Connection $con
* @throws PropelException
*/
public function countUsers($criteria = null, $distinct = false, $con = null)
{
// include the Peer class
include_once 'diy-blog/model/om/BaseUserPeer.php';
if ($criteria === null) {
$criteria = new Criteria();
}
elseif ($criteria instanceof Criteria)
{
$criteria = clone $criteria;
}
$criteria->add(UserPeer::BACKENDURI, $this->getURI());
return UserPeer::doCount($criteria, $distinct, $con);
}
/**
* Method called to associate a User object to this object
* through the User foreign key attribute
*
* @param User $l User
* @return void
* @throws PropelException
*/
public function addUser(User $l)
{
$this->collUsers[] = $l;
$l->setBackEndResource($this);
}
} // BaseBackEndResource