/**
* Resets all references to other model objects or collections of model objects.
*
* This method is a user-space workaround for PHP's inability to garbage collect
* objects with circular references (even in PHP 5.3). This is currently necessary
* when using Propel in certain daemon or large-volumne/high-memory operations.
*
* @param boolean $deep Whether to also clear the references on all referrer objects.
*/
public function clearAllReferences($deep = false)
{
if ($deep && !$this->alreadyInClearAllReferencesDeep) {
$this->alreadyInClearAllReferencesDeep = true;
if ($this->aPersonRelatedByPerson1 instanceof Persistent) {
$this->aPersonRelatedByPerson1->clearAllReferences($deep);
}
if ($this->aPersonRelatedByPerson2 instanceof Persistent) {
$this->aPersonRelatedByPerson2->clearAllReferences($deep);
}
$this->alreadyInClearAllReferencesDeep = false;
}
// if ($deep)
$this->aPersonRelatedByPerson1 = null;
$this->aPersonRelatedByPerson2 = null;
}
/**
* Count equal nest Friends of the supplied Person object
*
* @param Person $person * @param PropelPDO $con
* @return integer
*/
public function countFriendsOf(Person $person, PropelPDO $con = null)
{
return $person->getFriends()->count();
}
/**
* Adds an object to the instance pool.
*
* Propel keeps cached copies of objects in an instance pool when they are retrieved
* from the database. In some cases -- especially when you override doSelect*()
* methods in your stub classes -- you may need to explicitly add objects
* to the cache in order to ensure that the same objects are always returned by doSelect*()
* and retrieveByPK*() calls.
*
* @param Person $obj A Person object.
* @param string $key (optional) key to use for instance map (for performance boost if key was already calculated externally).
*/
public static function addInstanceToPool($obj, $key = null)
{
if (Propel::isInstancePoolingEnabled()) {
if ($key === null) {
$key = (string) $obj->getId();
}
// if key === null
PersonPeer::$instances[$key] = $obj;
}
}
/**
* Filter the query by a related Person object
*
* @param Person|PropelObjectCollection $person The related object(s) to use as filter
* @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL
*
* @return FriendQuery The current query, for fluid interface
* @throws PropelException - if the provided filter is invalid.
*/
public function filterByPersonRelatedByPerson2($person, $comparison = null)
{
if ($person instanceof Person) {
return $this->addUsingAlias(FriendPeer::PERSON_2, $person->getId(), $comparison);
} elseif ($person instanceof PropelObjectCollection) {
if (null === $comparison) {
$comparison = Criteria::IN;
}
return $this->addUsingAlias(FriendPeer::PERSON_2, $person->toKeyValue('PrimaryKey', 'Id'), $comparison);
} else {
throw new PropelException('filterByPersonRelatedByPerson2() only accepts arguments of type Person or PropelCollection');
}
}
/**
* Checks for Equal Nest relation
*
* @param Person $aFriend The object to check for Equal Nest Friend relation to the current object
* @return boolean
*/
public function hasFriend(Person $aFriend)
{
if (null === $this->collEqualNestFriends) {
$this->getFriends();
}
return $aFriend->isNew() || $this->isNew() ? in_array($aFriend, $this->collEqualNestFriends->getArrayCopy()) : in_array($aFriend->getPrimaryKey(), $this->collEqualNestFriends->getPrimaryKeys());
}
