/**
* If this collection has already been initialized with
* an identical criteria, it returns the collection.
* Otherwise if this PrimaryAttribute is new, it will return
* an empty collection; or if this PrimaryAttribute has previously
* been saved, it will retrieve related Heros 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 PrimaryAttribute.
*/
public function getHerosJoinHeroAffiliation($criteria = null, $con = null, $join_behavior = Criteria::LEFT_JOIN)
{
if ($criteria === null) {
$criteria = new Criteria(PrimaryAttributePeer::DATABASE_NAME);
} elseif ($criteria instanceof Criteria) {
$criteria = clone $criteria;
}
if ($this->collHeros === null) {
if ($this->isNew()) {
$this->collHeros = array();
} else {
$criteria->add(HeroPeer::PRIMARY_ATTRIBUTE_ID, $this->id);
$this->collHeros = HeroPeer::doSelectJoinHeroAffiliation($criteria, $con, $join_behavior);
}
} 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(HeroPeer::PRIMARY_ATTRIBUTE_ID, $this->id);
if (!isset($this->lastHeroCriteria) || !$this->lastHeroCriteria->equals($criteria)) {
$this->collHeros = HeroPeer::doSelectJoinHeroAffiliation($criteria, $con, $join_behavior);
}
}
$this->lastHeroCriteria = $criteria;
return $this->collHeros;
}