/** * 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 TagInstance $obj A TagInstance 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 = serialize(array((string) $obj->getTagId(), (string) $obj->getTaggedItemId(), (string) $obj->getModelName())); } // if key === null TagInstancePeer::$instances[$key] = $obj; } }
/** * Exclude object from result * * @param TagInstance $tagInstance Object to remove from the list of results * * @return TagInstanceQuery The current query, for fluid interface */ public function prune($tagInstance = null) { if ($tagInstance) { $this->addCond('pruneCond0', $this->getAliasedColName(TagInstancePeer::TAG_ID), $tagInstance->getTagId(), Criteria::NOT_EQUAL); $this->addCond('pruneCond1', $this->getAliasedColName(TagInstancePeer::TAGGED_ITEM_ID), $tagInstance->getTaggedItemId(), Criteria::NOT_EQUAL); $this->addCond('pruneCond2', $this->getAliasedColName(TagInstancePeer::MODEL_NAME), $tagInstance->getModelName(), Criteria::NOT_EQUAL); $this->combine(array('pruneCond0', 'pruneCond1', 'pruneCond2'), Criteria::LOGICAL_OR); } return $this; }
/** * Filter the query by a related TagInstance object * * @param TagInstance|PropelObjectCollection $tagInstance the related object to use as filter * @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL * * @return TagQuery The current query, for fluid interface * @throws PropelException - if the provided filter is invalid. */ public function filterByTagInstance($tagInstance, $comparison = null) { if ($tagInstance instanceof TagInstance) { return $this->addUsingAlias(TagPeer::ID, $tagInstance->getTagId(), $comparison); } elseif ($tagInstance instanceof PropelObjectCollection) { return $this->useTagInstanceQuery()->filterByPrimaryKeys($tagInstance->getPrimaryKeys())->endUse(); } else { throw new PropelException('filterByTagInstance() only accepts arguments of type TagInstance or PropelCollection'); } }